Use o comando mqsimigratecomponents para fazer a migração de um componente de uma versão de produto para outra no mesmo computador.
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.
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.
.-| 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-'
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.
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.
(Opcional) Imprime menos mensagens de status durante a operação.
(Opcional) Executa somente trabalho do WebSphere MQ.
Essa opção é válida somente para migração avançada para o Versão 9.0.
-3 é válido somente para migração avançada para o Versão 9.0.
(Requerido) O nome do componente a ser migrado.
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 dividida, seu ID de usuário deve ser sempre capaz de ler a partir do registro do produto.
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.
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