WebSphere Virtual Enterprise, Version 6.1.1
             Sistemas Operacionais: AIX,, HP-UX, Linux, Solaris, Windows


Comando xd_hadmgrAdd

O comando xd_hadmgrAdd incorpora um novo perfil de gerenciador de implementação em uma célula. O novo perfil do gerenciador de implementação é convertido em um gerenciador de implementação HA (altamente disponível) no mesmo nível na mesma célula que o perfil do gerenciador de implementação existente. O comando deve ser executado dentro do novo perfil do gerenciador de implementação que está sendo incluído.

Sintaxe

[For distributed platforms] A sintaxe do comando é:
xd_hadmgrAdd -hostname (primary_dmgr_host) [-port (primary_dmgr_port)]
-configRoot(fully_qualified_path_to_shared_'configuration)]
-workspaceRoot(fully_qualified_path_to_workspace)
-proxyServerJmxSoapAddress(JMX_SOAP_host):(JMX_SOAP_host)
-proxyServerHttpPort (HTTP_port)(HTTP_secure_port) [-uniquePort] [-user (uid)]
[-password (pwd)] [-quiet] [-logfile (filename)] [-replacelog] [-trace] [-help] 

Os parâmetros proxyServerJmxSoapAddress e proxyServerHttpPort são necessários apenas quando se está criando o primeiro gerenciador de implementação em espera.

Parâmetros

As seguintes opções estão disponíveis para o comando xd_hadmgrAdd:

-hostname <host name>
Especifica o nome do host utilizado para conectar-se ao gerenciador de implementação existente.
-port <port>
Especifica a porta utilizada para conectar-se ao gerenciador de implementação existente.
-configRoot <fully qualified path>
Especifica o caminho de configuração completo.
-workspaceRoot <fully qualified path>
Especifica o caminho de espaço de trabalho completo.
-proxyServerJmxSoapAddress <host:port>
Especifica o endereço SOAP JMX (Java Management Extensions) para o servidor proxy.
-proxyServerHttpPort <port> <secure_port>
Especifica as portas HTTP do servidor proxy.
-user <user>
Especifica o nome do usuário utilizado para conectar-se ao gerenciador de implementação existente.
-password<password>
Especifica a senha utilizada para conectar-se ao gerenciador de implementação existente.
-quiet
Suprime as informações de progresso que o comando xd_hadmgrAdd imprime em modo normal.
-logfile <filename>
Especifica a localização do arquivo de registro no qual as informações são gravadas. Por padrão, o arquivo hadmgrAdd.log é criado no diretório logs do perfil do nó que está sendo incluído.
-replacelog
Substitui o arquivo de registro ao invés de anexar o registro atual. Por padrão, o comando xd_hadmgrAdd é anexado ao arquivo de rastreio existente. Essa opção faz com que o comando xd_hadmgrAdd sobrescreva o arquivo de rastreio.
-trace
Gera informações de rastreio adicionais no arquivo de registro para finalidades de depuração.
-uniquePort
Verifica se há conflito de porta. Se a nova porta estiver em conflito com as portas existentes, a nova porta será incrementada por um até uma porta livre ser localizada. Este processo não será necessário se portas exclusivas tiverem sido designadas ao perfil do gerenciador de implementação durante sua criação.
-help
Exibe a ajuda da sintaxe.

Uso

Os exemplos a seguir demonstram a sintaxe correta:

Iniciando com uma célula preexistente do Network Deployment, instalada e configurada na seguinte estrutura de diretórios:

Descrição Nome
Home do WebSphere Application Server /WebSphere/AppServer/
Perfil do gerenciador de implementação existente /shared/profiles/PrimaryManagerNode

em que /shared mountpoint está em um dispositivo SAN FS.

Execute a ferramenta de configuração do perfil ou o utilitário de linha de comandos wasprofile para criar outro perfil de gerenciador de implementação associado a esta mesma instalação do Network Deployment. Crie esse perfil no disco compartilhado, /shared mountpoint para este exemplo. Você deve especificar o nome de host correto para esse gerenciador de implementação atender. Você pode especificar os números de porta explícitos de seu gerenciador de implementação em espera ao criar o perfil ou pode especificar o parâmetro -uniquePort ao executar o comando xd_hadmgrAdd, conforme mostrado neste exemplo. Você pode especificar qualquer valor para o nome de célula, porque ele é alterado para corresponder ao nome de célula em que este par de gerenciadores de implementação HA é incluído durante o processo de conversão. Especifique um nome de nó que seja exclusivo na célula em que esse par de gerenciadores de implementação HA está incluído.

Depois de criar o perfil, você tem:
Descrição Nome
Home do WebSphere Application Server /WebSphere/AppServer/
Perfil do gerenciador de implementação existente /shared/profiles/PrimaryManagerNode
Novo perfil do gerenciador de implementação /shared/profiles/StandbyManagerNode
Execute o comando xd_hadmgrAdd para converter o novo perfil de gerenciador de implementação em um par de gerenciadores de implementação HA na mesma célula em que o perfil do gerenciador de implementação existente está:
xd_hadmgrAdd.bat.sh –hostname a.a.a.a -port 8880
-configRoot /shared/profiles/PrimaryManagerNode/config
-workspaceRoot /shared/profiles/PrimaryManagerNode
-proxyServerJmxSoapAddress x.x.x.x:8880

-proxyServerHttpPort 9060 9043
-user wsadmin
-password ********
-uniquePort

Se você instalar o repositório do gerenciador de instalação centralizada e depois criar o segundo perfil do gerenciador de implementação, altere o valor da propriedade CENTRALIZED_INSTALL_REPOSITORY_ROOT no arquivo install_root\properties\cimgr.props de c:\ProgramFiles\IBM\WebSphere\AppServer\repository_folder para ${WAS_INSTALL_ROOT}/repository_folder.

O uso do comando xd_hadmgrAdd faz as seguintes alterações na configuração da célula:

  1. O novo gerenciador de implementação é configurado para utilizar a mesma instância de repositório de configuração que o gerenciador de implementação existente, o qual deve estar em um dispositivo compartilhado com o gerenciador de implementação existente.
  2. O novo gerenciador de implementação é configurado para utilizar o mesmo diretório compartilhado de espaço de trabalho especificado, o qual deve estar em um dispositivo compartilhado com o gerenciador de implementação existente.
  3. O ODR (On Demand Router) é configurado com:
    1. Canais de transporte HTTP wc_admin e ws_admin_secure.
    2. Nó de extremidade JMX_SOAP_PROXY_ADDRESS.
  4. Os gerenciadores de implementação são reconfigurados da seguinte forma:
    1. Seus endereços JMX_SOAP_CONNECTOR apontam para o JMX_SOAP_PROXY_ADDRESS do ODR.
    2. Eles têm um JMX_SOAP_PROXY_ADDRESS incluído que contém o mesmo host ou porta configurada que seus JMX_SOAP_ADDRESS originais.

O uso do comando xd_hadmgrAdd faz as seguintes alterações na configuração da célula:

Como resultado da alteração na configuração, o ODR hospeda os nós de extremidade lógicos para o gerenciador de implementação e determina proxies de pedidos de comunicação para o gerenciador de implementação no gerenciador de implementação ativo.

Por exemplo, em uma configuração de ODR não-HA, o gerenciador de implementação configurou pontos de nome do host para o ODR:

Figura 1. Configuração do ODR Sem Alta Disponibilidade
Configuração de ODR com um Gerenciador de Implementação Não-altamente Disponível

Para eliminar o ODR como um ponto único de falha, um configuração de ODR com HA é recomendada com no mínimo dois ODRs (On Demand Routers) recebendo tráfegos de um dispositivo sprayer de protocolo da Internet. Neste caso, os gerenciadores de implementação JMX_SOAP_ADDRESS configuraram pontos de nome do host para o dispositivo:

Figura 2. Configuração de ODR com Alta Disponibilidade Com Dois ODRs Que Incluem um Sprayer de IP
O IP sprayer usar mapeamentos de porta para rotear para um conjunto de dois ODRs. Também há dois gerenciadores de implementação: Um gerenciador de implementação primário e um gerenciador de implementação em espera.

A função do gerenciador de implementação HA suporta apenas o uso do conector JMX SOAP. O conector JMX RMI não é suportado nessa configuração.

  1. O novo gerenciador de implementação é configurado para utilizar a mesma instância de repositório de configuração que o gerenciador de implementação existente, o qual deve estar em um dispositivo compartilhado com o gerenciador de implementação existente.
  2. O novo gerenciador de implementação é configurado para utilizar o mesmo diretório compartilhado de espaço de trabalho especificado, o qual deve estar em um dispositivo compartilhado com o gerenciador de implementação existente.
  3. O ODR (On Demand Router) é configurado com:
    1. Canais de transporte HTTP wc_admin e ws_admin_secure.
    2. Nó de extremidade JMX_SOAP_PROXY_ADDRESS.
  4. Os gerenciadores de implementação são reconfigurados da seguinte forma:
    1. Seus endereços JMX_SOAP_CONNECTOR apontam para o JMX_SOAP_PROXY_ADDRESS do ODR.
    2. Eles têm um JMX_SOAP_PROXY_ADDRESS incluído que contém o mesmo host ou porta configurada que seus JMX_SOAP_ADDRESS originais.



Conceitos relacionados
Gerenciador de Implementação High Availability
Tarefas relacionadas
Configurando um Ambiente do Gerenciador de Implementação High Availability
Instalando o Produto
Informações relacionadas
Comando xd_hadmgrRemove
Tópico de Referência    

Termos de Uso | Feedback

Última atualização: 24/09/2009 14h17min28s EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/odoe_task/rxd_hadmgrAdd.html