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

Avoid trouble Avoid trouble: Los nodos registrados deben tener los mismos productos que el agente administrativo y los productos deben estar en los mismos niveles de versión en el nodo registrado y el agente administrativo. Este requisito se aplica porque el agente administrativo debe tener un entorno coincidente para manejar todas las funciones administrativas del nodo registrado. A un nodo no se le permite registrarse en un agente administrativo a menos que el nodo tenga un conjunto idéntico de productos y versiones. gotcha

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.

transition: Si anteriormente estaba ejecutando la Versión 7.0.0.11 o anterior y tienen un agente administrativo con un nodo gestionado que tiene productos o versiones que no coinciden, cuando migre a la Versión 8.0, dicho agente administrativo no podrá iniciar el subsistema para los nodos que no coincidan. Debe actualizar estos nodos para que tengan los mismos productos y versiones que los agentes administrativos, reiniciar los servidores en el nodo y, a continuación, reiniciar el agente administrativo, para que el agente administrativo pueda reanudar la gestión de estos nodos registrados.

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 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]
registerNode.sh -conntype SOAP -port 8878 
 -profilePath raíz_servidor_aplicaciones/profiles/default
[AIX][HP-UX][Linux][Solaris]
registerNode.sh -conntype SOAP -port 8878
 -profilePath raíz_servidor_aplicaciones/profiles/AppSrv01
[Windows]
registerNode.bat -conntype SOAP -port 8878 
 -profilePath raíz_servidor_aplicaciones\profiles\AppSrv01
[IBM i]
registerNode -conntype SOAP -port 8878 
 -profilePath raíz_datos_usuario/profiles/AppSrv01

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ragt_registerNode
File name: ragt_registerNode.html