Comando mqsimigratecomponents

Plataformas Suportadas

  • Janelas
  • Sistemas Linux e UNIX
  • z/OS

Finalidade

O comando mqsimigratecomponents move um componente de uma versão anteriormente instalada (Versão 2.1 ou Versão 5 apenas) do produto para outro. Esse comando deve ser executado a partir da versão mais recente do produto instalado; quer seja a origem ou o destino.
Nota:
  1. Para a Versão 2.1 do produto, o Version 2.1 CSD02 (2.1.0.3) é o release mais antigo do produto suportado. (Consulte Migrando e Fazendo Upgrade para obter informações adicionais.)
  2. Para a Versão 5 do produto, a Versão 5.0.0.4 é o release mais antigo do produto suportado .

Você deve ter uma instalação na Version 6.0 do produto com o código do componente requerido instalado, ou seja, o componente intermediário é instalado, se necessário, e assim por diante.

Antes de iniciar a migração, pare as sessões de depuração no Control Center. Não é possível migrar fluxos de mensagens que estão sendo depurados.

Início da mudançaVocê pode chamar o comando com várias opções para desempenhar uma das seguintes ações:
  • Verifique um componente, sem fazer qualquer alteração, para assegurar-se de que o componente seja adequado para a migração requerida (-c).
  • Mova um componente para uma versão diferente, total ou parcial (-s e -t).
  • Desfaça uma etapa de migração com falha (-u).
  • Verifique se uma movimentação foi bem-sucedida (-v).
Fim da mudança

Início da mudançaO comando mqsimigratecomponents atualiza o seu registro e sistema de arquivos, definições do WebSphere MQ e as definições do banco de dados. Se o usuário que está emitindo o comando não tiver autoridade para executar todas essas etapas, o comando poderá ser executado, uma parte por vez. Os diferentes usuários podem executar a parte para a qual estão autorizados para alcançar o resultado geral. Isso é conhecido como split migration e é executado utilizando os parâmetros -1, -2 e -3. Fim da mudança

Se estiver utilizando o comando mqsimigratecomponents com um banco de dados Sybase, você deve modificar o banco de dados executando as seguintes ações:
  1. Efetue logon no ISQL utilizando uma conta do administrador do sistema.
  2. Emita a seguinte série de comandos:
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Opção de banco de dados 'ddl in tran' ON (ativada) para o banco de dados 'BROKER1'.
    Execute o comando CHECKPOINT no banco de dados que foi alterado.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    em que BROKER1 é o nome do banco de dados do intermediário Sybase.

Sintaxe

Parâmetros

-c
(Opcional) Execute uma verificação de pré-migração de um componente especificado para assegurar-se de que:
  • A versão detectada automaticamente do intermediário corresponda a qualquer versão especificada na linha de comandos
  • Não exista grupos de execução de 64 bits, se estiver migrando de Version 6.0 para um release anterior
  • As tabelas do banco de dados a serem copiadas de um release anterior não contêm qualquer linha que viole os requisitos de índice do Version 6.0.
Início da mudançaSe um intermediário que você esteja migrando compartilhar um esquema de banco de dados com outro intermediário, a mensagem de aviso BIP8678 será emitida e a verificação falhará. Nesse caso, todos os intermediários que compartilhem um esquema de banco de dados devem ser migrados juntos:
  1. Pare todos os intermediários que estiverem compartilhando o esquema do banco de dados.
  2. Migre o primeiro intermediário. Isso migrará as tabelas de banco de dados para todos os intermediários, bem como o sistema de arquivos e o registro, e as definições de WebSphere MQ para esse intermediário apenas; por exemplo:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1
  3. Migre o sistema de arquivos e o registro, e as partes WebSphere MQ de cada um dos outros intermediários; a parte do banco de dados já foi migrada. Utilize os parâmetros -1 e -2 para fazer isso, em uma etapa ou em duas etapas:
    • Em uma etapa:
      mqsimigratecomponents BROKERB -1 -2
    • Em duas etapas:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2
Fim da mudança

A verificação de migração pode ser executada em um componente em execução. Isso não provoca impacto no componente, exceto para impor uma leve penalidade no desempenho. Observe que, em sistemas UNIX, o arquivo odbc.ini precisa ser migrado (ou seja, um arquivo odbc.ini de novo formato precisa ser criado com o mesmo conjunto de origens de dados que o antigo) antes da verificação ser executada, pois o comando de verificação precisa ser capaz de acessar o banco de dados do intermediário.

O comando de verificação obtém êxito ou falha e imprime uma mensagem sobre se a migração deverá ou não obter êxito, mas nenhuma modificação é feita durante o processo.

-v
(Opcional) Execute uma verificação de pós-migração de um componente especificado para assegurar-se de que:
  • As tabelas de banco de dados e as filas corretas existem para a versão especificada.
  • O registro está no formato correto para a versão especificada.
-q
(Opcional) Imprime menos mensagens de status durante a operação.
-1
Início da mudança(Opcional) Execute somente trabalho do registro e do sistema de arquivo.
  • Ao migrar para Version 6.0, utilize o parâmetro -1 antes dos parâmetros -2 ou -3.
  • Ao migrar de volta para uma versão anterior, utilize os parâmetros -2 ou -3 antes do parâmetro -1.
Fim da mudança
-2
(Opcional) Executa somente trabalho do WebSphere MQ.
-3
(Opcional) Executa somente trabalho do banco de dados.
-u
(Opcional) Desfaz uma etapa de migração com falha; você também deve especificar pelo menos -1, -2 ou -3. Essa opção deverá ser utilizada somente quando a migração tiver falhado e sua recuperação automática também tiver falhado (por exemplo, uma falha durante a migração dividida).
-sSource Version
(Opcional) A versão anterior do componente.
  • O valor é detectado automaticamente, se não especificado.
  • Início da mudançaAo executar uma migração de divisão para Version 6.0, o parâmetro -s será obrigatório depois que você executar o comando mqsimigratecomponents com o parâmetro -1. Isso é ilustrado no exemplo de migração de divisão.Fim da mudança
  • Consulte Finalidade para obter as restrições para os números de versão do produto que são suportados.
-tTarget Version
(Opcional) A versão de destino do componente.
  • Esse valor é assumido como a versão atual, se não especificado.
  • Início da mudançaAo executar a migração de divisão de Version 6.0 para uma versão anterior, o parâmetro -t será obrigatório. Isso é ilustrado no exemplo de migração de divisão.Fim da mudança
  • Consulte Finalidade para obter as restrições para os números de versão do produto que são suportados.
Nome do Componente
(Requerido) O nome do componente a ser migrado.

Autorização

Ao executar uma migração de etapa única, o ID do usuário utilizado para invocar esse comando deve ter a capacidade para:
  • Gravar no registro e no sistema de arquivos para o produto
  • Modificar os bancos de dados associados ao componente
  • Modificar definições de filas
Para uma migração dividida, o ID do usuário para invocar esse comando deve sempre ter a capacidade para ler o registro do produto e também ter autorização específica para que cada etapa obtenha êxito:
  • -1 requer a capacidade de gravar no registro e no sistema de arquivos para o produto
  • -2 requer a capacidade de modificar as definições de fila
  • -3 requer a capacidade de modificar os bancos de dados associados ao componente

Respostas

Esse comando pode produzir um grande número de respostas possíveis, dependendo dos resultados das diversas operações. Observe que esse comando difere de outros comandos quanto ao modo de produzir mensagens - elas são exibidas conforme necessário, em vez de serem produzidas em um batch no final do programa.

Exemplos

O exemplo a seguir verifica a migração de BROKER1 da V2.1 para a Version 6.0:

mqsimigratecomponents –c BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0003I: Broker database ‘BKRDB’ and schema ‘WMQIUSER’ are not shared with other components.
BIP 0004I: No invalid rows found in broker database.
BIP 0005I: Migration check passed.
BIP 8071I: Conclusão bem-sucedida de comando.

O exemplo a seguir faz a migração automática de BROKER1 da V2.1 para a Version 6.0:

mqsimigratecomponents BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0003I: Broker database ‘BKRDB’ and schema ‘WMQIUSER’ are not shared with other components.
BIP 0004I: No invalid rows found in broker database.
BIP 0005I: Migration check passed.
BIP 0020I: Starting registry migration for component ‘BROKER1’.
BIP 0021I: Created top-level ‘CurrentVersion’ key
BIP 0021I: Created ‘DSN’ subkey
BIP 0022I: Created ‘HTTPListener’ subkey
BIP 0023I: Created ‘HTTPListener.HTTPConnector’ subkey
BIP 0024I: Created ‘FADLevel’ value; set to ‘3’
BIP 0025I: Created ‘converters’ value; set to ‘’
BIP 0028I: Moving registry data into ‘CurrentVersion’.
BIP 0029I: Moved value ‘AdminAgentPID’.
[repeat for each value]
BIP 0030I: Completed moving registry data into ‘CurrentVersion’.
BIP 0025I: Finished registry migration for component ‘BROKER1’.
BIP 0011I: Starting database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0012I: Moving table ’BROKERRESOURCES’ to ’somethingBROKERRESOURCES’.
BIP 0013I: Creating new table ’BROKERRESOURCES’.
BIP 0014I: Copying data from ‘somethingBROKERRESOURCES’ to ’BROKERRESOURCES’.
BIP 0015I: Successfully copied all data (322 rows).
[repeat for each table]
BIP 0016I: Finished database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Starting queue migration for ‘BKRQM’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.CONTROL’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.REPLY’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.REQUEST’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.TIMEOUT’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.UNKNOWN’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.TIMEOUT.QUEUE’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.ACK’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.INPUT’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.REPLY’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.ADMIN.QUEUE’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.IPC.QUEUE’.
BIP 0019I: Finished queue migration for ‘BKRQM’.
BIP 0005I: Migration succeeded for component ‘BROKER1’.
BIP 8071I: Conclusão bem-sucedida de comando.

O exemplo a seguir é uma repetição do exemplo anterior, mas com o parâmetro -q especificado:

mqsimigratecomponents -q BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0005I: Migration check passed.
BIP 0020I: Starting registry migration for component ‘BROKER1’.
BIP 0025I: Finished registry migration for component ‘BROKER1’.
BIP 0011I: Starting database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0016I: Finished database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Starting queue migration for ‘BKRQM’.
BIP 0019I: Finished queue migration for ‘BKRQM’.
BIP 0005I: Migration succeeded for component ‘BROKER1’.
BIP 8071I: Conclusão bem-sucedida de comando.
Início da mudança

O exemplo a seguir ilustra uma migração de divisão de Version 2.1 para Version 6.0:

Fim da mudança
Início da mudança
mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3
Fim da mudança
Início da mudança

O exemplo a seguir ilustra uma migração de divisão de Version 6.0 para Version 2.1:

Fim da mudança
Início da mudança
mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Fim da mudança
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
an26150_