Mandato registerNode
Utilice el mandato registerNode para registrar un nodo autónomo con un agente administrativo de manera que este último pueda gestionar el nodo.
Ejecute el mandato registerNode desde el directorio bin del servidor del agente administrativo para registrar un nodo con el agente administrativo. Al ejecutar el mandato, se convierte el nodo autónomo en un nodo que el agente administrativo gestiona.
El agente administrativo y el nodo que se va a registrar deben estar en el mismo sistema.
El agente administrativo proporciona una única interfaz para administrar varios nodos de servidores de aplicaciones no federados en, por ejemplo, entorno de desarrollo, pruebas unitarias o granjas de servidores. Utilizando una única interfaz para administrar los servidores de aplicaciones, reducirá la sobrecarga de ejecución de servicios administrativos en cada servidor de aplicaciones.
Puede utilizar la consola de administración del agente administrativo para configurar el agente administrativo, ver y cambiar las propiedades de los nodos registrados en el agente administrativo, registrar y anular el registro de los nodos del servidor de aplicaciones con gestores de trabajo, y ver y modificar las configuraciones del gestor de trabajos para un nodo registrado. Un gestor de trabajos le permite enviar y administrar de forma asíncrona trabajos para un nodo registrado en el agente administrativo cuando el nodo también se registra en el gestor de trabajos. Para obtener más detalles acerca del subsistema del agente administrativo, consulte la sección Agente administrativo en el artículo de Developer Works Overview of administrative enhancements (Visión general de las mejoras administrativas).

Sólo puede ejecutar el mandato en un nodo no federado. Si el mandato se ejecuta en un nodo federado, aquél finaliza con un error.
Al ejecutar el mandato registerNode, el mandato detiene todos los servidores de aplicación en ejecución del nodo. Si lo desea, puede detener los servidores de aplicaciones que esté registrando antes de ejecutar el mandato registerNode.
Si las aplicaciones EJB (Enterprise JavaBeans) de gestión o de consola administrativa del servidor de aplicaciones que se van registrar están habilitadas, el proceso de registro del nodo las inhabilita.
Sintaxis
La sintaxis del mandato registerNode es la siguiente:
registerNode [opciones]
Parámetros
Hay las siguientes opciones disponibles para el mandato registerNode:
- -conntype<JSR160RMI|IPC|RMI|SOAP>
- El tipo de conector opcional utilizado para conectar con el agente administrativo para iniciar
el registro del nodo. El valor predeterminado es SOAP.
Deprecated feature: Debe cambiar el conector RMI por el conector JSR160RMI con el tiempo porque el soporte del conector RMI está en desuso.depfeat
- -host nombre_host
- Parámetro opcional que especifica el nombre de host del agente administrativo.
- -name nombre_nodo_gestionado
- Parámetro opcional que especifica el nombre del nodo gestionado una vez que el nodo se ha registrado con el agente administrativo.
- -nodepassword contraseña_nodo
- Parámetro opcional que especifica la contraseña del nodo que se está registrando. Especifique este parámetro si la seguridad se encuentra en el nodo y la contraseña es diferente de la contraseña del agente administrativo. Utilice este parámetro con el parámetro -nodeusername. Los parámetros -nodeusername y -nodepassword se utilizan para detener todos los servidores del nodo.
- -nodeusername nombre_usuario_nodo
- Parámetro opcional que especifica la contraseña del nodo que se está registrando. Especifique este parámetro si la seguridad se encuentra en el nodo y el nombre de usuario es diferente del nombre de usuario del agente administrativo. Utilice este parámetro con el parámetro -nodepassword. Los parámetros -nodeusername y -nodepassword se utilizan para detener todos los servidores del nodo.
- -openConnectors conectores
- Parámetro opcional que especifica una lista de conectores separados por comas que el agente administrativo abrirá. De manera predeterminada, todos los conectores están abiertos.
- -port número_puerto
- Parámetro opcional que especifica el número de puerto del puerto de conector del agente administrativo.
El número de puerto predeterminado es 8878 para el puerto SOAP por omisión del agente administrativo. SOAP es el tipo de conector JMX (Java™ Management Extensions) del mandato. Si tiene diversas instalaciones del producto o diversos perfiles, el puerto SOAP podría ser distinto de 8878. Examine el archivo SystemOut.log del agente administrativo para ver los puertos actuales en uso.
Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL. - -profilePath vía_acceso_perfil
- Parámetro necesario que especifica la vía de acceso al perfil del nodo del servidor de aplicaciones que se va a registrar.
- -trace
- Parámetro opcional que proporciona una salida de seguimiento del mandato registerNode.
- -portsFile archivo_puertos
- Un parámetro opcional que especifica la vía de acceso a un archivo que define los valores del puerto para el nodo recién registrado.
Durante el registro del nodo, el mandato registerNode utiliza un conjunto de puertos recomendados generados automáticamente si no especifica el parámetro -portsFile. Los valores de puerto recomendados pueden ser distintos de los valores de puerto predeterminado en función de la disponibilidad de los puertos por omisión.
El formato del archivo archivo_puertos que especifique es el mismo que el archivo portdef.props, excepto por el hecho de que se utilizan únicamente los puertos siguientes: SOAP_CONNECTOR_ADDRESS, RMI_CONNECTOR_ADDRESS, JSR160RMI_CONNECTOR_ADDRESS e IPC_CONNECTOR_ADDRESS.
- -profileName nombre_perfil
- Parámetro opcional que especifica el nombre de perfil del agente administrativo.
- -username nombre_usuario
- Parámetro opcional que especifica el ID de usuario para iniciar sesión en el agente administrativo.
- -password contraseña
- Parámetro opcional que especifica el ID de usuario para iniciar sesión en el agente administrativo.
- -help
- Parámetro opcional que imprime una sentencia de uso.
- -?
- Parámetro opcional que imprime una sentencia de uso.
Ejemplos de uso
Los siguientes ejemplos muestran la sintaxis correcta. Los mandatos se han dividido en varias líneas con fines de impresión.
![[z/OS]](../images/ngzos.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath raíz_servidor_aplicaciones/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 raíz_servidor_aplicaciones/profiles/AppSrv01
![[Windows]](../images/windows.gif)
registerNode.bat -conntype SOAP -port 8878
-profilePath raíz_servidor_aplicaciones\profiles\AppSrv01
![[IBM i]](../images/iseries.gif)
registerNode -conntype SOAP -port 8878
-profilePath raíz_datos_usuario/profiles/AppSrv01