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 7.0 a partir de Versão 6.1 ou de Versão 6.0:
  • 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 7.0.

  • Se estiver migrando do Versão 6.0, você deve ter instalado a Versão 6.0.0.9 (Fix Pack 9) ou mais recente.

    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.0 ou WebSphere Event Broker Versão 6.0 para Fix Pack 10 antes de poder migrar para o WebSphere Message Broker Versão 7.0.

Quando você migrar um broker para o Versão 7.0, sua configuração será lida a partir do banco de dados do broker e migrada para um repositório interno que é mantido pelo broker migrado. O banco de dados do broker usado pelo broker da Versão 6.1 ou da Versão 6.0 não é mais necessário para o broker da Versão 7.0. Quando você tiver concluído a migração com êxito, poderá excluir o banco de dados ou desinstalar o produto de banco de dados, se você não usá-lo mais.

Também é possível usar o comando mqsimigratecomponents para retornar um broker do Versão 7.0 para uma versão anterior para reverter os efeitos da migração avançada; entretanto, o broker é restaurado com a configuração que estava ativa no momento da migração avançada e atualizações que foram 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.

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 7.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 7.0, utilize o parâmetro -1 antes dos parâmetros -2 ou -3.
  • Quando você migrar de volta do Versão 7.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 7.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 7.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 7.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 7.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, Windows Vista, 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ê 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
  • 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 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

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, 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 6.1 para a Versão 7.0:

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

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

mqsimigratecomponents MYBROKER -t 6.1.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-08-02 07:48:54


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