Comando registerNode
Use o comando registerNode para registrar um nó independente com um agente administrativo para que o agente administrativo possa gerenciar o nó.
Execute o comando registerNode a partir do diretório bin do servidor do agente administrativo para registrar um nó com o agente administrativo. Quando você executa o comando, o nó independente é convertido em um nó que o agente administrativo gerencia.
O agente administrativo e o nó que está sendo registrado devem estar no mesmo computador.
O agente administrativo fornece uma interface única para administrar vários nós de servidor de aplicativos não federados (independentes) em, por exemplo, ambientes de desenvolvimento, de teste de unidade ou de server farm. O uso de uma única interface para administrar os servidores de aplicativos reduz a sobrecarga da execução de serviços administrativos em cada servidor de aplicativos.
O console administrativo do agente administrativo pode ser utilizado para configurar o agente administrativo, visualizar e alterar as propriedades dos nós registrados no agente administrativo, registrar e remover o registro dos nós do servidor de aplicativos com gerenciadores de tarefas e visualizar e alterar as configurações do gerenciador de tarefas de um nó registrado. Um gerenciador de tarefas permite enviar e administrar tarefas de forma assíncrona de um nó registrado no agente administrativo, quando o nó também for registrado no gerenciador de tarefas. Para obter mais detalhes sobre o subsistema do agente administrativo, consulte a seção Agente administrativo no artigo Visão geral dos aprimoramentos administrativos do developerworks.

Você pode executar o comando apenas em um nó não federado. Se o comando for executado em um nó federado, o comando sairá com um erro.
Quando você executa o comando registerNode, ele para todos os servidores de aplicativos em execução no nó. Opcionalmente, é possível parar os servidores de aplicativos no nó que está registrando antes de executar o comando registerNode.
Se o console administrativo ou os aplicativos EJB (Enterprise JavaBeans) de gerenciamento do servidor de aplicativos que estão sendo registrados estiverem ativados, o processo de registro do nó os desativará.
Sintaxe
A sintaxe de comando registerNode é a seguinte:
registerNode [opções]
Parâmetros
As opções a seguir estão disponíveis para o comando registerNode:
- -conntype<JSR160RMI|IPC|RMI|SOAP>
- O tipo de conector opcional utilizado para conectar-se ao agente administrativo para
iniciar o registro do nó. O padrão é SOAP.
Recurso Reprovado: Você deverá, eventualmente, alternar do conector RMI para o conector JSR160RMI, pois o suporte para o conector RMI está obsoleto.depfeat
- -host host_name
- Um parâmetro opcional que especifica o nome do host do agente administrativo.
- -name managed_node_name
- Um parâmetro opcional que especifica o nome do nó gerenciado depois que o nó é registrado no agente administrativo.
- -nodepassword node_password
- Um parâmetro opcional que especifica a senha do nó que você está registrando. Especifique esse parâmetro se a segurança estiver ativada no nó e a senha for diferente da senha do agente administrativo. Utilize esse parâmetro com o parâmetro -nodeusername. Os parâmetros -nodeusername e -nodepassword são utilizados para parar todos os servidores no nó.
- -nodeusername node_user_name
- Um parâmetro opcional que especifica o nome do usuário do nó que está sendo registrado. Especifique esse parâmetro se a segurança estiver ativada no nó e o nome de usuário for diferente do nome de usuário do agente administrativo. Utilize esse parâmetro com o parâmetro -nodepassword. Os parâmetros -nodeusername e -nodepassword são utilizados para parar todos os servidores no nó.
- -openConnectors connectors
- Um parâmetro opcional que especifica uma lista de conectores separados por vírgula dos conectores que o agente administrativo abrirá. Por padrão, todos os conectores são abertos.
- -port port_number
- Um parâmetro opcional que especifica o número da porta do conector do agente
administrativo.
O número da porta é 8878 para a porta SOAP padrão do agente administrativo. SOAP é o tipo de conector JMX (Java™ Management Extensions) padrão para o comando. Se você tiver múltiplas instalações do produto ou múltiplos perfis, a porta SOAP pode ser diferente de 8878. Examine o arquivo SystemOut.log do agente administrativo para ver as portas atuais em uso.
Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM® i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL. - -profilePath profile_path
- Um parâmetro obrigatório que especifica o caminho para o perfil do nó do servidor de aplicativos a ser registrado.
- -trace
- Um parâmetro opcional que fornece saída de rastreio para o comando registerNode.
- -portsFile ports_file
- Um parâmetro opcional que especifica o caminho para um arquivo que define
configurações de porta para o nó recém-registrado.
Durante o registro do nó, o comando registerNode usará um conjunto de portas recomendadas gerado automaticamente se você não especificar o parâmetro -portsFile. Os valores de porta recomendados podem ser diferentes dos valores de porta padrão com base na disponibilidade das portas padrão.
O formato do arquivo ports_file especificado é o mesmo que o arquivo portdef.props, exceto que apenas as portas a seguir são usadas: SOAP_CONNECTOR_ADDRESS, RMI_CONNECTOR_ADDRESS, JSR160RMI_CONNECTOR_ADDRESS e IPC_CONNECTOR_ADDRESS.
- -profileName profile_name
- Um parâmetro opcional que especifica o nome do perfil do agente administrativo.
- -username username
- Um parâmetro opcional que especifica o ID do usuário para efetuar logon no agente administrativo.
- -password password
- Um parâmetro opcional que especifica a senha para efetuar logon no agente administrativo.
- -help
- Um parâmetro opcional que imprime uma instrução de uso.
- -?
- Um parâmetro opcional que imprime uma instrução de uso.
Cenários de Uso
Os exemplos a seguir demonstram a sintaxe correta. Os comandos são divididos em várias linhas para fins de impressão.
![[z/OS]](../images/ngzos.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath app_server_root/profiles/default
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath app_server_root/profiles/AppSrv01
![[Windows]](../images/windows.gif)
registerNode.bat -conntype SOAP -port 8878
-profilePath app_server_root\profiles\AppSrv01
![[IBM i]](../images/iseries.gif)
registerNode -conntype SOAP -port 8878
-profilePath user_data_root/profiles/AppSrv01