Comando mqsimigratecomponents

Utilize o comando mqsimigratecomponents para migrar um componente de uma versão previamente instalada do produto para outra versão no mesmo computador para prepará-lo para participar do domínio do intermediário da versão de destino.

Plataformas Suportadas

  • Windows.
  • Sistemas Linux e UNIX.
  • z/OS. Execute esse comando customizando e enviando o BIPMGCMP.

Propósito

Migre os componentes para WebSphere Message Broker Versão 6.0 a partir de Versão 2.1 ou a partir de Versão 5.0.
  • Para a Versão 2.1 do produto, o CSD02 Versão 2.1 (2.1.0.3) é o release mais antigo do produto suportado.
  • Para a Versão 5.0 do produto, a Versão 5.0.0.4 (Fix Pack 4) é o release mais antigo do produto suportado.

Você também pode utilizar este comando para retornar um componente de uma versão mais recente para uma anterior para reverter os efeitos de migração de avanço.

Você deve executar este comando a partir de qualquer que seja a versão anterior do produto instalado, independentemente dela ser a versão de origem ou a versão de destino.

Você deve ter uma instalação do produto na versão necessária, com o código do componente necessário instalado, para emitir este comando com êxito.

Antes de iniciar a migração, pare todas as sessões de depuração ativas no Message Brokers Toolkit ou no Centro de Controle Versão 2.1. Não é possível migrar fluxos de mensagens que estão sendo depurados.

Especifique as opções apropriadas este comando 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).
Se estiver utilizando o comando mqsimigratecomponents para migrar um intermediário que utiliza Sybase para seu banco de dados de intermediário, será necessário modificar o banco de dados desempenhando 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) Verifique um componente especificado antes da migração, para assegurar que:
  • A versão detectada automaticamente do intermediário corresponde a qualquer versão especificada na linha de comandos.
  • Os grupos de execução de 64 bits não serão suportados se você estiver migrando da Versão 6.0 para um release anterior.
  • As tabelas de banco de dados a serem copiadas de um release anterior não contêm nenhuma linha que esteja indexada incorretamente.

Você pode verificar um componente em execução. A verificação não afeta o componente, além de um pequeno impacto no desempenho. Nos sistemas Linux e UNIX, é necessário migrar o arquivo de configuração ODBC (o arquivo no qual você definiu as origens de dados, por exemplo, .odbc.ini) antes de executar a verificação, pois o comando de verificação deve conseguir acessar o banco de dados do intermediário.

O comando de verificação é bem-sucedido ou falha e imprime uma mensagem informando se a migração será bem-sucedida, mas não são feitas modificações durante o processo.

-v
(Opcional) Verifique um componente especificado após a migração, para assegurar 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
(Opcional) Execute somente trabalho do registro e do sistema de arquivo.
  • Quando migrar para a Versão 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.
-2
(Opcional) Executa somente trabalho do WebSphere MQ.
-3
(Opcional) Executa somente trabalho do banco de dados.

Se 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 compartilham o esquema do banco de dados.
  2. Migre o primeiro intermediário. Esta ação migra as tabelas de banco de dados para todos os intermediários, bem como o sistema de arquivos e o registro e as definições do WebSphere MQ apenas para esse intermediário; 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
-u
(Opcional) Desfaz uma etapa de migração com falha; você também deve especificar pelo menos -1, -2 ou -3. Utilize esta opção apenas quando a migração falhou e também falhou na recuperação automática (uma falha durante a migração de divisão é um exemplo).
-s SourceVersion
(Opcional) A versão anterior do componente.
  • Se não for especificado, este valor será detectado automaticamente.
  • Quando desempenhar uma migração dividida para a Versão 6.0, o parâmetro -s será obrigatório após a execução do comando mqsimigratecomponents com o parâmetro -1, conforme mostrado no exemplo de migração dividida.
  • Consulte Propósito para obter as restrições para os números de versão do produto que são suportados.
-t TargetVersion
(Opcional) A versão de destino do componente.
  • Se não for especificado, este valor será assumido como a versão atual.
  • Ao desempenhar a migração dividida da Versão 6.0 para uma versão anterior, o parâmetro -t será obrigatório, conforme mostrado no exemplo de migração dividida.
  • Consulte Propósito para obter as restrições para os números de versão do produto que são suportados.
ComponentName
(Requerido) O nome do componente a ser migrado.

Autorização

O comando mqsimigratecomponents atualiza seu registro e sistema de arquivos, definições do WebSphere MQ e definições de banco de dados. Se o ID do usuário utilizado para executar este comando não tiver autoridade para desempenhar todas estas etapas, o comando poderá ser executado, uma parte de cada vez. Os diferentes usuários podem executar a parte para a qual estão autorizados para alcançar o resultado geral. Esta abordagem é referida como migração dividida e é desempenhada utilizando os parâmetros -1, -2 e -3.

Se você executar a migração de uma única etapa, seu ID do usuário poderá:
  • Gravar no registro e no sistema de arquivos para o produto
  • Modificar os bancos de dados associados ao componente
  • Modificar definições de filas

Se você executar a migração dividida, seu ID do usuário sempre deverá poder ler a partir do registro do produto e também ter autorização específica para que cada etapa seja bem-sucedida:

  • -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. Este comando se difere de outros comandos na maneira que produz mensagens: elas são exibidas como geradas, em vez de serem relatadas em um lote no final do programa. Quando migrar tabelas de banco de dados, o z/OS produz mais saída do que sistemas distribuídos. Utilize o parâmetro -q para reduzir o número de mensagens exibidas.

Exemplos

O exemplo a seguir verifica a migração de BROKER1 da Versão 2.1 para a Versão 6.0:

mqsimigratecomponents –c BROKER1
BIP8849I: Intermediário 'BROKER1' (Versão 2.1) com Gerenciador de Filas 'brkqm1' e Origem de Dados 'brkdb1' especificado para migração.
BIP8791I: Verificação de linhas duplicadas iniciada.
BIP8794I: A tabela BRMINFO não tem nenhuma linha duplicada.
BIP8794I: A tabela BRMRTDDEPINFO não tem nenhuma linha duplicada.
BIP8794I: A tabela BROKERRESOURCES não tem nenhuma linha duplicada.
BIP8794I: A tabela BRMRTDINFO não tem nenhuma linha duplicada.
BIP8794I: A tabela BRMWFDINFO não tem nenhuma linha duplicada.
BIP8792I: Verificação de linhas duplicadas passada.
BIP8791I: Verificação de linhas duplicadas iniciada.
BIP8800W: Nenhuma sintaxe de tópico inválida detectada na tabela BSUBSCRIPTIONS.
BIP8800W: Nenhuma sintaxe de tópico inválida detectada na tabela BPUBLISHERS.
BIP8800W: Nenhuma sintaxe de tópico inválida detectada na tabela BRETAINEDPUBS.
BIP8797I: Verificação de sintaxe de tópico bem-sucedida
BIP8680I: Verificação de pré-migração bem-sucedida.
BIP8071I: Conclusão do comando bem-sucedido.

O exemplo a seguir faz a migração automática do BROKER1 a partir do Versão 2.1 to Versão 6.0 no Windows:

mqsimigratecomponents BROKER1
BIP8849I: Intermediário 'BROKER1' (Versão 2.1) com Gerenciador de Filas 'BROKER1' e Origem de Dados 'BROKERDB' especificado para migração.
BIP8755I: Valor 'QueueManagerName' copiado para o novo local
BIP8755I: Valor 'DataSourceName' copiado para o novo local
BIP8755I: Valor 'DataSourceUserId' copiado para o novo local
BIP8755I: Valor 'DataSourcePassword' copiado para o novo local
BIP8755I: Valor 'LilPath' copiado para o novo local
BIP8755I: Valor 'ConfigurationTimeout' copiado para o novo local
BIP8755I: Valor 'ConfigurationDelayTimeout' copiado para o novo local
BIP8755I: Valor 'MigrationNeeded' copiado para o novo local
BIP8755I: Valor 'MQTrustedQueueManager' copiado para o novo local
BIP8755I: Valor 'UserNameServerQueueManagerName' copiado para o novo local
BIP8755I: Valor 'BrokerUUID' copiado para o novo local
BIP8755I: Valor 'AdminAgentPID' copiado para o novo local
BIP8763I: Valor 'QueueManagerName' excluído do local antigo
BIP8763I: Valor 'DataSourceName' excluído do local antigo
BIP8763I: Valor 'DataSourceUserId' excluído do local antigo
BIP8763I: Valor 'DataSourcePassword' excluído do local antigo
BIP8763I: Valor 'LilPath' excluído do local antigo
BIP8763I: Valor 'ConfigurationTimeout' excluído do local antigo
BIP8763I: Valor 'ConfigurationDelayTimeout' excluído do local antigo
BIP8763I: Valor 'MigrationNeeded' excluído do local antigo
BIP8763I: Valor 'MQTrustedQueueManager' excluído do local antigo
BIP8763I: Valor 'UserNameServerQueueManagerName' excluído do local antigo
BIP8763I: Valor 'BrokerUUID' excluído do local antigo
BIP8763I: Valor 'AdminAgentPID' excluído do local antigo
BIP8768I: Migração do registro concluída para o componente 'BROKER1'.
BIP8654I: Movendo os artefatos do sistema de arquivos de '' para 'C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI'
BIP8670I: Migração do banco de dados iniciada
BIP8663I: Criando novas tabelas temporárias
BIP8664I: Migrando das tabelas existentes para novas tabelas temporárias
BIP8665I: Eliminando tabelas existentes
BIP8666I: Criando novas tabelas
BIP8667I: Copiando todas as linhas de novas tabelas temporárias para novas tabelas
BIP8668I: Eliminando novas tabelas temporárias
BIP8669I: Migração do banco de dados bem-sucedida
BIP8785I: Iniciando a migração da fila do WebSphere MQ para o componente 'BROKER1'.
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.REQUEST' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.CONTROL' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.REPLY' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.TIMEOUT' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.AGGR.UNKNOWN' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.TIMEOUT.QUEUE' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.WS.INPUT' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.WS.REPLY' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.WS.ACK' do WebSphere MQ criada
O comando setmqaut foi concluído com êxito.
BIP8786I: Fila 'SYSTEM.BROKER.IPC.QUEUE' do WebSphere MQ criada
BIP8787I: Fila 'SYSTEM.BROKER.ADMIN.QUEUE' do WebSphere MQ limpa
BIP8787I: Fila 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE' do WebSphere MQ limpa
BIP8787I: Fila 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' do WebSphere MQ limpa
BIP8787I: Fila 'SYSTEM.BROKER.IPC.QUEUE' do WebSphere MQ limpa
BIP8789I: Migração da fila do WebSphere MQ para o componente 'BROKER1' concluída.
BIP8071I: Conclusão do comando bem-sucedido.

O exemplo a seguir mostra uma migração dividida da Versão 2.1 para a Versão 6.0:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

O exemplo a seguir mostra uma migração dividida da Versão 6.0 para a Versão 2.1:

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Referências relacionadas
Migração e Upgrade
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:54

an26150_