Comando migrateServerMEtoCluster
Quando um servidor que é membro de um barramento é convertido em um cluster, use o comando migrateServerMEtoCluster para migrar o mecanismo do sistema de mensagens (ME) no servidor para o escopo do cluster. Durante a conversão, a associação do barramento não é automaticamente transferida para o escopo do cluster. Se desejar que o cluster seja um membro do barramento, use este comando para executar essa transferência.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
Esse comando é válido apenas quando utilizado com servidores de aplicativos WebSphere Application Server Versão 7.0 ou posterior. Não o utilize com versões anteriores.
- Para obter uma lista dos comandos de barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBAdminCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
AdminConfig.save()
Propósito
O comando migrateServerMEtoCluster migra um mecanismo do sistema de mensagens em um servidor para o escopo de um cluster. Isso é útil quando um servidor que é membro de um barramento de integração de serviços foi convertido em um cluster. A conversão para um cluster não torna o cluster automaticamente em um membro do barramento. Use esse comando para transferir a associação do barramento para o cluster. Isso pode ser usado para permitir que o mecanismo do sistema de mensagens esteja altamente disponível ou para o caso de desejar incluir mais mecanismos do sistema de mensagens no cluster para obter escalabilidade. Nessa situação, você não deve excluir o mecanismo do sistema de mensagens do escopo do servidor e recriá-lo no escopo do cluster, pois o identificador exclusivo (UUID) do mecanismo do sistema de mensagens será perdido e o mecanismo do sistema de mensagens não funcionará com os destinos previamente configurados.
O comando migrateServerMEtoCluster torna o novo cluster de servidores um membro do barramento.
Um exemplo de uma situação em que esse comando é útil é após um servidor, que é um membro de um barramento, ter sido federado em uma célula usando a opção de incluir o barramento, o servidor será promovido a um membro de um cluster criando um novo cluster com o servidor como o primeiro membro.
Objeto de destino
Um mecanismo do sistema de mensagens.
O mecanismo do sistema de mensagens é copiado para o escopo do cluster e todas as referências de localização de destino são copiadas, garantindo que ele continue a funcionar com destinos previamente configurados. A definição do mecanismo do sistema de mensagens no escopo do servidor será excluída.
Parâmetros necessários
- -bus bus_name
- O nome do barramento de integração de serviços do qual o servidor é um membro, quando esse servidor hospeda o mecanismo do sistema de mensagens a ser migrado. Você pode utilizar o comando listSIBuses para listar os nomes de barramentos existentes.
- -node node_name
- O nome do nó no qual o servidor é executado, quando esse servidor hospeda o mecanismo do sistema de mensagens a ser migrado.
- -server server_name
- O nome do servidor que hospeda o mecanismo do sistema de mensagens a ser migrado.
O servidor deve ser um membro do barramento especificado e deve ser executado no nó especificado e já deve estar convertido no cluster especificado no comando.
- -cluster cluster_name
- O nome do cluster de servidores no qual o servidor foi convertido e
para o qual deseja migrar o mecanismo do sistema de mensagens.
O cluster deve existir e o servidor deve ser um membro do cluster. O cluster não deve ainda ser um membro do barramento de integração de serviços do qual o servidor é um membro.
Parâmetros Opcionais
- -rename TRUE | FALSE
- Se é para renomear ou não o mecanismo do sistema de mensagens e os pontos de mensagens e
usar as convenções de nomenclatura para esses recursos em um cluster. Por exemplo,
o nome de um mecanismo do sistema de mensagens em um servidor que usa a convenção de nomenclatura node_name.server_name-bus_name é alterado para usar a convenção de nomenclatura cluster_name.nnn-bus_name.
- TRUE
- O mecanismo do sistema de mensagens e os pontos de mensagens são renomeados usando as convenções de nomenclatura para esses recursos em um cluster.
- FALSE
- O mecanismo do sistema de mensagens e os pontos de mensagens não são renomeados usando as convenções de nomenclatura para esses recursos em um cluster.
Por exemplo:
Migre um mecanismo do sistema de mensagens que esteja atualmente configurado no node1 server1 para o cluster1 e renomeie o mecanismo do sistema de mensagens e todos os pontos de mensagem para usar a terminologia do cluster. O server1 é um membro do bus1 e já foi convertido em cluster1. O cluster1 ainda não é um membro do bus1.
AdminTask.migrateServerMEtoCluster ('-bus bus1 -node node1 -server server1 -cluster cluster1 -rename TRUE')