Use o comando mqsimigratecomponents para migrar um componente de uma versão instalada anteriormente do produto para outra versão 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.
Também é possível usar o comando mqsimigratecomponents para retornar um broker da Versão 8.0 para uma versão anterior para reverter os efeitos da migração de encaminhamento. Ao restaurar um broker para a Versão 6.1, o broker é restaurado com a configuração que estava ativa no momento da migração de encaminhamento e as atualizações 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.
Ao restaurar um broker para a Versão 7.0, as mudanças feitas no estado do broker que são compatíveis com a Versão 7.0 são mantidas. No entanto, mudanças feitas que não forem compatíveis com a Versão 7.0 não serão refletidas no estado do broker restaurado, podendo causar erros.
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.
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.
.-| 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.
Esta opção é válida somente para migração avançada para o Versão 8.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.
-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 dividida da Versão 7.0 para a Versão 8.0:
mqsimigratecomponents BROKER1 -1
mqsimigratecomponents BROKER1 -2
mqsimigratecomponents BROKER1 -3
O exemplo a seguir mostra uma migração da Versão 8.0 de volta para a Versão 7.0:
mqsimigratecomponents MYBROKER -t 7.0.0.3