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.

[IBM i][IBM i]O cliente de script wsadmin é executado do Qshell. [IBM i]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.

A ajuda da linha de comandos é fornecida para comandos do barramento de integração de serviços:
  • 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')

Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:

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.
O valor padrão é FALSE.

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')

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjk_cli_me_promote
Nome do arquivo: rjk_cli_me_promote.html