Comando mqsimigratecomponents

Use o comando mqsimigratecomponents para fazer a migração de um componente de uma versão de produto para outra no mesmo computador.

Plataformas Suportadas

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

Finalidade

Faça a migração dos componentes para o IBM® Integration Bus Versão 9.0 a partir de uma versão anterior:
  • 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 IBM Integration Bus Versão 9.0.

Você também pode usar o comando mqsimigratecomponents para retornar um broker do IBM Integration Bus Versão 9.0 para WebSphere Message Broker Versão 8.0 ou WebSphere Message Broker Versão 7.0 para reverter os efeitos da migração avançada. Você não pode usar o comando mqsimigratecomponents para retornar um broker do IBM Integration Bus Versão 9.0 para o WebSphere Message Broker Versão 6.1. É possível restaurar um ambiente WebSphere Message Broker Versão 6.1 apenas a partir de um backup.

Ao restaurar um broker para Versão 8.0 ou Versão 7.0, as alterações que você fez no estado do broker compatíveis com a sua versão de destino serão mantidas. No entanto, as alterações não compatíveis com a sua versão de destino não serão refletidas no estado do broker restaurado, podendo causar erros.

Você deverá executar esse comando a partir da versão mais recente do produto, independentemente se for 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 IBM Integration 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).

Observações de Uso

Se tiver especificado um ID do usuário e senha de origem de dados no comando mqsicreatebroker para o broker no qual você está fazendo a migração, os valores desses parâmetros também serão migrados e salvos no formato 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-'   

Verificação

|-- -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 somente para migração avançada para o Versão 9.0.

Parâmetros

-c
(Opcional) Verifique um componente especificado, antes de fazer a migração, para assegurar-se de que o seguinte seja verdadeiro:
  • A versão do broker detectada automaticamente corresponde a qualquer versão especificada na linha de comandos.
  • As tabelas de banco de dados, acessadas em 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, 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 fazer a migração, para assegurar-se de que o seguinte seja verdadeiro:
  • 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 9.0, utilize o parâmetro -1 antes dos parâmetros -2 ou -3.
  • Quando você migrar de volta do Versão 9.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.

Essa opção é válida somente para migração avançada para o Versão 9.0.

-u
(Opcional) Desfaz uma etapa de migração com falha; você também deve especificar pelo menos -1, -2 ou -3. Use essa opção somente quando a migração tiver falhado, e também se falhar 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 9.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 9.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 9.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

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

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á ser capaz de concluir as seguintes ações:
  • 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 de versões anteriores do registro, a verificação de integridade que verifica os níveis dos WebSphere MQ e do banco de dados requer que seu ID de usuário tenha os seguintes direitos:
  • Autoridade do WebSphere MQ para abrir as filas SYSTEM.BROKER.*.
A seguinte autorização específica para cada etapa é requerida para a migração com ê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 a partir de 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 do Versão 8.0 para o Versão 9.0:

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

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

mqsimigratecomponents MYBROKER -t 8.0.0.2
Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização:
        
        Última atualização: 2013-07-16 02:07:01


Tópico de ReferênciaTópico de Referência | IBM Integration Bus Versão 9.0.0.0 | an26150_