WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

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 WebSphere Message Broker Versão 8.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 WebSphere Message Broker Versão 8.0.

Você também pode utilizar o comando mqsimigratecomponents para retornar um broker de WebSphere Message Broker Versão 8.0 para WebSphere Message Broker Versão 7.0 ou Versão 6.1 para reverter os efeitos de migração de avanço. Quando você restaura um broker para Versão 6.1, o broker é restaurado com a configuração que estava ativa no momento da migração avançada, e as atualizações feitas após a migração não são refletidas no banco de dados 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 Versão 7.0, as mudanças feitas no estado do broker que forem compatíveis com Versão 7.0 serão mantidas. No entanto, as mudanças feitas que não forem compatíveis com Versão 7.0 não serão refletidas no estado do broker, 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 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 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-'   

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 somente para migração avançada para o Versão 8.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 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 apenas é válida para migração para versões seguintes para Versão 8.0. Se você especificar esse parâmetro para migração de versões anteriores, ele será ignorado; alterações feitas no estado do broker não podem ser migradas de volta e aplicadas ao banco de dados que é de propriedade do 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 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 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

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 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 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 de divisão a partir de Versão 7.0 para Versão 8.0:

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

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

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

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:08


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