Migre as informações do
Publicação/Assinatura do
WebSphere Message Broker Versão 6.1 para o
WebSphere MQ
Propósito
Use o comando
migmbbrk do
WebSphere MQ para migrar as informações do
Publicação/Assinatura de um broker
WebSphere Message Broker Versão 6.1 para um gerenciador de filas do
WebSphere MQ. O comando executa um processo de migração que migra as seguintes informações de
Publicação/Assinatura para o gerenciador de filas que está
associado ao broker denominado:
- Assinaturas
- Pontos de assinatura (pontos de assinatura são suportados apenas quando mensagens
RFH2 são usadas)
- Fluxos
- Publicações Retidas
Ao executar o comando migmbbrk,
você deve usar o perfil da versão do WebSphere Message
Broker a partir do qual está migrando.
O comando migmbbrk não migra
a Lista de Controle de Acesso (ACL). Em vez disso, executar a migração com os parâmetros -t ou -r produz um arquivo contendo comandos setmqaut sugeridos para configurar um ambiente de segurança no gerenciador de filas que é equivalente ao ambiente de segurança que existia no broker. Você deve revisar e
modificar o arquivo de comando de segurança, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker, antes de executar a migração com o parâmetro -c para concluir a migração.
Nota: No
Sistemas UNIX, todas as autoridades são retidas por grupos de usuários internamente, não por diretores, os quais possuem as seguintes implicações:
- Se você usar o comando setmqaut para conceder uma autoridade a um
diretor, a autoridade será concedida ao grupo de usuários principal do diretor. Portanto, a autoridade é efetivamente concedida a todos os membros desse grupo de usuários.
- Se você usar o comando setmqaut para revogar uma autoridade de um
diretor, a autoridade será revogada do grupo de usuários principal do diretor. Portanto, a autoridade é efetivamente revogada de todos os membros desse grupo de usuários.
Você deve emitir o comando migmbbrk a partir de um ambiente de comando que possa processar com êxito os comandos WebSphere MQ e WebSphere Message
Broker. Geralmente, é possível emitir esses comandos a partir de um console do comando WebSphere Message
Broker.
Os dados de configuração de Publicação/Assinatura do WebSphere Message Broker Versão 6.1, que estão armazenados nas tabelas de banco de dados de assinatura, não são excluídos pelo processo de migração. Portanto, estes dados de configuração
ficarão disponíveis para uso até serem explicitamente excluídos.
Sintaxe

.----------.
V |
>>-migmbbrk--+- -c -+----+------+-+-- -b --BrokerName----------><
+- -r -+ +- -l -+
'- -t -' +- -o -+
+- -s -+
'- -z -'
Parâmetros
- -b BrokerName
- (Obrigatório) O nome do broker que é a origem das informações de Publicação/Assinatura que devem ser migradas.
O gerenciador de filas para o qual as informações de Publicação/Assinaturasão migradas é o gerenciador de filas que está associado ao broker denominado.
- -c
- (Obrigatório) Conclua a migração dos dados de configuração do Publicação/Assinatura. A fase de conclusão da migraçaõ usa os objetos do tópico que são criados na fase -t inicial. O estado do broker pode ter sido alterado desde que a fase inicial foi executada e novos objetos do tópico adicional são agora obrigatórios. Se este for o caso, a fase de conclusão
criará estes novos objetos do tópico conforme necessário. A fase de conclusão não exclui nenhum dos objetos do tópico que se tornaram
desnecessários; pode ser preciso excluir todos os objetos do tópico que não são
necessários.
Antes de concluir a migração, você deve revisar e modificar o comando
de segurança produzido na fase -r ou -t,
conforme necessário, e executar os comandos para configurar um ambiente de segurança
no gerenciador de filas, equivalente ao que existia no broker.
Antes de executar
essa fase de conclusão, você deve executar a fase -t inicial.
Não é possível usar o parâmetro -c com o parâmetro -r ou o parâmetro
-t. Esta fase também cria um log de migração.
- -r
- (Necessário) Ensaia o processo de migração mas não altera nada.
Isso pode ser usado antes da migração com o parâmetro -t, para criar um log de migração, incluindo quaisquer erros, de modo que você possa observar
qual seria o resultado do processo de migração, mas sem alterar as configurações atuais.
Ensaiar a migração também produz um arquivo contendo comandos
setmqaut sugeridos para configurar um ambiente de segurança no gerenciador de filas que é
equivalente ao ambiente de segurança que existia no broker. Antes de concluir a migração com o parâmetro
-c, você deve revisar e modificar o arquivo de comando de segurança, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker.
Não é possível usar o parâmetro -r com o parâmetro -c ou o parâmetro -t.
- -t
- (Necessário) Cria objetos do tópico que podem ser necessários no gerenciador de filas,
com base nas entradas ACL definidas no broker.
O uso do parâmetro
-t também produz um arquivo contendo os comandos
setmqaut sugeridos para configurar um ambiente de
segurança no gerenciador de filas que seja equivalente ao ambiente de
segurança que existia no broker. Os objetos do tópico são criados antes da execução dos comandos de segurança
para criar ACLs para os objetos do tópico. Antes de concluir a migração com o parâmetro
-c, você deve revisar e modificar o arquivo de comando de segurança, conforme necessário, e executar os comandos para configurar um ambiente de segurança no gerenciador de filas, equivalente ao que existia no broker.
Você deve executar essa fase antes de executar a fase de conclusão com o parâmetro -c.
Não é possível usar o parâmetro -t com o parâmetro -c ou o parâmetro -r. Esta fase também cria um log de migração.
- -l
- (Opcional) Deixa o broker em execução. Se você não especificar este
parâmetro, o broker será encerrado por padrão no final do processo
de migração.
- -o
- (Opcional) Sobrescreva a assinatura ou a publicação retida que já existe no gerenciador de filas, que possui o mesmo nome de uma assinatura ou uma publicação retida que está sendo migrada do broker pelas informações de Publicação/Assinatura que foram recuperadas do broker. O parâmetro -o não terá efeito se você usá-lo com o parâmetro -r.
- -s
- (Opcional) Descarte informações intermediárias que foram retidas de uma instância anterior do processo de migração que falhou ou que foi interrompido. O processo de migração preenche filas privadas com dados
temporários. Se o processo de migração for concluído com êxito, os dados
temporários serão incluídos. Se você não especificar este parâmetro e o processo de migração
falhar ou for interrompido, os dados temporários serão retidos e
usados pelo processo de migração se você reiniciá-lo, para que o processo
continue no ponto em que falhou ou foi interrompido anteriormente.
- -z
- (Opcional) Execute o processo de migração, independentemente se ele
tenha sido executado anteriormente até uma conclusão bem-sucedida. Se você não especificar
este parâmetro e o processo de migração tiver sido executado anteriormente até uma conclusão
bem-sucedida, o processo reconhecerá esse fato e sairá. É possível usar o parâmetro
-o com o parâmetro -z, mas isso não é
obrigatório. Um ensaio anterior da migração usando o parâmetro -r não conta como uma conclusão bem-sucedida.
Códigos de Retorno
| 0 |
Migração concluída com êxito |
| 20 |
Ocorreu um erro durante o processamento |
Arquivos de saída
O processo de migração grava
dois arquivos de saída no diretório atual:
- amqmigrateacl.txt
- Um arquivo contendo uma lista de comandos setmqaut, para você revisar, alterar e
executar, se apropriado, para ajudá-lo a reproduzir suas ACLs.
- amqmigmbbrk.log
- Um arquivo de log contendo um registro dos detalhes da migração.
Exemplos
Este comando migra as informações de
publicação/assinatura do broker BRK1 para seu gerenciador de filas associado e especifica que o processo de migração é executado independentemente se ele foi
executado anteriormente até uma conclusão bem-sucedida. Também especifica que qualquer assinatura ou publicação retida que já existe no gerenciador de filas,
que possui o mesmo nome que uma assinatura ou publicação retida que
está sendo migrada do broker, deve ser sobrescrita.
migmbbrk -r -z -o -b BRK1
Sistemas Operacionais Suportados
O comando migmbbrk é
suportado apenas nas seguintes plataformas que suportam o WebSphere Message Broker Versão 6.1:
- Microsoft Windows XP Professional com SP2,
apenas versões de 32 bits
- Solaris
em x86-64: Solaris 10
- Solaris em SPARC: Solaris 9 (64 bits)
- AIX Versão 5.2 ou mais recente,
apenas 64 bits
- HP-Itanium: HP-UX 11i
- Linux em System
z (64 bits)
- Linux em POWER (64 bits)
- Linux em x86
- Linux em
x86-64
No z/OS, a função equivalente ao comando migmbbrk é
fornecida pelo utilitário CSQUMGMB.
Para
obter os detalhes mais recentes sobre todos os níveis suportados de hardware e software,
visite o web site do WebSphere Message Broker.