Comando mqsimigratecomponents

Use o comando mqsimigratecomponents para migrar um componente de uma versão instalada anteriormente do produto para outra versão no mesmo computador.

Plataformas Suportadas

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

Finalidade

Migre componentes para WebSphere Message Broker Versão 8.0 a partir de Versão 7.0 ou de Versão 6.1:
  • Se você estiver migrando a partir de Versão 6.1, deverá ter instalado a Versão 6.1.0.3 (Fix Pack 3) ou posterior.

    Se estiver usando o WebSphere Application Server com o WebSphere Message Broker ou tiver aplicativos publicar/assinar que usem a opção SubIdentity, você deve atualizar o WebSphere Message Broker Versão 6.1 para Fix Pack 4 antes de poder migrar para o WebSphere Message Broker Versão 8.0.

Também é possível usar o comando mqsimigratecomponents para retornar um broker da Versão 8.0 para uma versão anterior para reverter os efeitos da migração de encaminhamento. Ao restaurar um broker para a Versão 6.1, o broker é restaurado com a configuração que estava ativa no momento da migração de encaminhamento e as atualizações feitas após a migração não são refletidas no banco de dados que está associado ao broker na versão anterior. É necessário reter o banco de dados do broker relevante para conseguir usar o broker na versão anterior.

Ao restaurar um broker para a Versão 7.0, as mudanças feitas no estado do broker que são compatíveis com a Versão 7.0 são mantidas. No entanto, mudanças feitas que não forem compatíveis com a Versão 7.0 não serão refletidas no estado do broker restaurado, podendo causar erros.

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.

É necessário ter uma instalação do produto nas versões de destino e de origem, com o código do componente necessário instalado, para emitir este comando com êxito.

Antes de iniciar a migração, pare o broker e todas as sessões de depuração ativas no WebSphere Message Broker Toolkit. 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 se o componente é apropriado para a migração necessária, sem alterar esse componente (-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).

Notas sobre a utilização

Se você tiver especificado um ID do usuário e senha de origem de dados no comando mqsicreatebroker para o broker que você está migrando, os valores destes parâmetros também serão migrados e salvos no formato que é usado pelo comando mqsisetdbparms. Os valores são usados pelo broker para acessar bancos de dados do usuário para os quais você não configurou valores alternativos usando o comando mqsisetdbparms. Após a migração, se desejar alterar os IDs do usuário ou senhas usados pelo broker para acessar bancos de dados do usuário, será possível usar apenas o comando mqsisetdbparms.

Se você atualizar os valores de ID do usuário e senha, e migrar o broker de volta para a versão anterior, os novos valores também serão migrados de volta para o broker original.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
                          .-| Mover |-----.   
>>-mqsimigratecomponents--+-| Verificar |-+--------------------->
                          +-| Desfazer |--+   
                          '-| Conferir |--'   

>----ComponentName----+-----+----------------------------------><
                      '- -q-'   

Check

|-- -c --+--------------------+--+--------------------+---------|
         '- -s--SourceVersion-'  '- -t--TargetVersion-'   

Mover

   .-------------.                           
   V             |                           
|----+---------+-+--+--------------------+---------------------->
     +- -1-----+    '- -s--SourceVersion-'   
     +- -2-----+                             
     |     (1) |                             
     '- -3-----'                             

>--+--------------------+---------------------------------------|
   '- -t--TargetVersion-'   

Desfazer

        .-------------.                       
        V             |                       
|-- -u----+- -1-----+-+-- -s--SourceVersion--------------------->
          +- -2-----+                         
          |     (1) |                         
          '- -3-----'                         

>-- -t--TargetVersion-------------------------------------------|

Conferir

|-- -v--+--------------------+----------------------------------|
        '- -t--TargetVersion-'   

Notas:
  1. Válido apenas para migração avançada para o Versão 8.0.

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.
  • As tabelas de banco de dados acessadas em uma liberação anterior não contêm linhas indexadas incorretamente.

Você pode verificar um componente em execução. A verificação não afeta o componente, exceto por uma leve degradação de desempenho.

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.

Os parâmetros -c e -v são mutuamente exclusivos. Além disso, se você especificar qualquer um desses parâmetros, não poderá especificar nenhum outro parâmetro ao executar esse comando.

-v
(Opcional) Verifique um componente especificado após a migração, para assegurar que:
  • O registro está no formato correto para a nova versão.
  • As filas corretas existem para a nova versão.

Os parâmetros -c e -v são mutuamente exclusivos. Além disso, se você especificar qualquer um desses parâmetros, não poderá especificar nenhum outro parâmetro ao executar esse comando.

-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 8.0, utilize o parâmetro -1 antes dos parâmetros -2 ou -3.
  • Quando você migrar de volta do Versão 8.0 para uma versão anterior, use o parâmetro -2 antes do parâmetro -1.
-2

(Opcional) Executa somente trabalho do WebSphere MQ.

-3
(Opcional) Executa somente trabalho do banco de dados.

Esta opção é válida somente para migração avançada para o Versão 8.0. Se você especificar este parâmetro para migração para trás, ele será ignorado; as mudanças feitas no estado do broker não podem ser migradas de volta e aplicadas ao banco de dados pertencente ao broker na versão anterior.

-u
(Opcional) Desfaz uma etapa de migração com falha; você também deve especificar pelo menos -1, -2 ou -3. Use esta opção somente quando a migração tiver falhado, e também falhou na recuperação automática (por exemplo, se ocorrer uma falha durante a migração de divisão).

-3 é válido somente para migração avançada para o Versão 8.0.

-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 8.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 Finalidade 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.
  • Quando você executar a migração de divisão a partir do Versão 8.0 para uma versão anterior, o parâmetro -t será obrigatório.
  • Consulte Finalidade 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

Nos sistemas Windows XP e Windows Server 2003, o ID do usuário utilizado para executar este comando deve ser membro do grupo Administrators no sistema local.

Nos sistemas Windows 7 e Windows Server 2008, o ID de usuário usado para executar esse comando deve estar executando com privilégios elevados no sistema local:
  • O ID do usuário deve ser membro do grupo Administrators.
  • O comando deve ser executado a partir de um prompt de comandos elevado. Para obter um prompt de comandos elevado, execute o comando mqsicommandconsole e siga o prompt Windows para ativar um novo console do comando elevado.

    Esse console começa com o ambiente mqsiprofile correto a partir do qual os comandos que exigem elevação podem ser executados.

Se você não executar o comando a partir de um console de comandos privilegiado, o comando não será processado com êxito.

O comando mqsimigratecomponents atualiza seu registro, sistema de arquivos e definições do WebSphere MQ.

Se o ID do usuário usado para executar este comando não tiver a autoridade para executar todas estas etapas, será possível executar o comando, 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 de divisão e é executada usando os parâmetros -1, -2 e -3.

Se você executar a migração de uma única etapa, seu ID do usuário deverá poder:
  • Gravar no registro e no sistema de arquivos para o produto
  • Modificar definições de filas
  • Ler no banco de dados associado ao broker, se você estiver migrando da Versão 6.1

Se você executar a migração dividida, seu ID de usuário deve ser sempre capaz de ler a partir do registro do produto.

Se estiver fazendo uma migração dividida retrocedida do registro, é feita uma verificação de integridade para verificar os níveis do WebSphere MQ e do banco de dados que requer que seu ID de usuário tenha
  • Autoridade SELECT nas tabelas de banco de dados do broker, se você estiver migrando da Versão 6.1
  • Autoridade do WebSphere MQ para abrir as filas SYSTEM.BROKER.*.
A seguinte autorização específica para cada etapa é requerida para ter-se êxito:
  • -1 requer a capacidade de gravar no registro e no sistema de arquivos do produto; SELECT nas tabelas de banco de dados do broker se você estiver migrando da Versão 6.1 para abrir as filas SYSTEM.BROKER.*
  • -2 requer a capacidade de modificar as definições de fila
  • -3 requer a capacidade de ler a partir de bancos de dados associados ao broker, se você estiver migrando da Versão 6.1

Respostas

Este comando pode produzir muitas respostas possíveis, dependendo dos resultados das diversas operações. Este comando difere de outros comandos na maneira como ele produz mensagens: elas são exibidas quando são geradas, em vez de serem relatadas em um lote no final do programa.

Quando você migra tabelas de banco de dados da Versão 6.1, o z/OS produz mais saída do que os sistemas distribuídos. Utilize o parâmetro -q para reduzir o número de mensagens exibidas.

Exemplos

O exemplo a seguir mostra uma migração dividida da Versão 7.0 para a Versão 8.0:

mqsimigratecomponents BROKER1 -1
mqsimigratecomponents BROKER1 -2
mqsimigratecomponents BROKER1 -3

O exemplo a seguir mostra uma migração da Versão 8.0 de volta para a Versão 7.0:

mqsimigratecomponents MYBROKER -t 7.0.0.3
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:28


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | an26150_