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 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.
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-' 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-'
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.
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.
-3 é válido somente para migração avançada para o Versão 8.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 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