Anulación del registro de nodos del agente administrativo

Puede anular el registro de los nodos del servidor de aplicaciones de modo que ya no están registrados en un agente administrativo. Puede anular el registro de un nodo si deja de necesitarlo en el entorno del agente administrativo o si desea suprimir el perfil de nodo de servidor de aplicaciones. Tras anular el registro de un nodo de un agente administrativo, puede utilizar el nodo como autónomo, registrar en nodo en otro agente administrativo o suprimir el perfil de nodo de servidor de aplicaciones.

Antes de comenzar

El nodo de servidor de aplicaciones que desea eliminar del entorno del agente administrativo debe estar registrado en el agente administrativo. Inicie el agente administrativo si no se está ejecutando.

Si el nodo del servidor de aplicaciones está registrado en un gestor de trabajos, anule el registro del nodo del gestor de trabajos. Puede utilizar la consola del agente administrativo o los mandatos wsadmin para eliminar el nodo:

Utilice la consola del agente administrativo para anular el registro de un nodo autónomo de servidor de aplicaciones de un gestor de trabajo.
1. Inicie una sesión en la consola del agente administrativo. El nombre del agente administrativo se parece a host_nameAANode01.
2. Pulse Administración del sistema > Agente administrativo.
3. En la pestaña Configuración de la página Agente administrativo, pulse Nodos.
4. En la página Nodos, seleccione el nodo del que desea anular el registro del gestor de trabajos y pulse Anular registro de un gestor de trabajos.
5. En la página Anular el registro de un gestor de trabajos, especifique un nombre de nodo especifique un número de puerto de consola administrativa de un gestor de trabajos, opcionalmente, especifique otros parámetros tales como el nombre de usuario y contraseña del gestor de trabajos, y pulse Aceptar.
  Para Puerto, si la seguridad no está habilitada, especifique 9960 para indicar un puerto no seguro de la consola administrativa del gestor de trabajos. Si no se especifica ningún número de puerto, se utiliza el número de puerto seguro predeterminado, 9943.
Ejecute el mandato unregisterWithJobManager de wsadmin en el grupo de mandatos ManagedNodeAgent para anular el registro del nodo autónomo de servidor de aplicaciones autónomo de un gestor de trabajos.
Al ejecutar el mandato unregisterWithJobManager, especifique el nombre del nodo autónomo de servidor de aplicaciones que gestiona el gestor de trabajos para el parámetro obligatorio -managedNodeName. Los demás parámetros son opcionales.
```
AdminTask.unregisterWithJobManager('[-host myJobMgrHostname -port 8989
 -managedNodeName myAppServerNodeName]') 
```
El valor predeterminado para el parámetro -host es localhost.

El valor predeterminado para el parámetro -port es 9943, el número de puerto seguro de la consola administrativa del gestor de trabajos. Si la seguridad está inhabilitada, especifique 9960, el número de puerto no seguro predeterminado.

Para obtener más información sobre el mandato unregisterWithJobManager y sus parámetros, consulte el tema sobre el grupo de mandatos ManagedNodeAgent para el objeto AdminTask.

Si el sistema falla al anular el registro de un servidor de aplicaciones autónomo de un gestor de trabajos, ejecute el mandato cleanupTarget en el grupo JobManagerNode para limpiar la información de registro del gestor de trabajos. Consulte el tema sobre el grupo de mandatos JobManagerNode para el objeto AdminTask.

Acerca de esta tarea

Para anular el registro de un nodo, ejecute el mandato deregisterNode desde el directorio bin del agente administrativo. El Paso 1 describe cómo ejecutar el mandato deregisterNode .

Al anular el registro de un nodo, se retiene su configuración, pero se marca como no registrado con el agente administrativo. Si el nodo del que ha anulado el registro tenía instaladas la consola administrativa o las aplicaciones EJB (Enterprise JavaBeans ) de gestión antes de registrar el nodo, se vuelven a habilitar.

Al ejecutar el mandato deregisterNode se podría producir una excepción de puntero nulo si el perfil del nodo de servidor de aplicaciones está dañado o inutilizable. Si recibe la excepción de puntero nulo, ello indica que el proceso para anular el registro del servidor de aplicaciones del agente administrativo ha fallado. Recibirá mensajes ADMU0116I, ADMU0128I, ADMU0211I, ADMU0113E y ADMU1211I en el registro cronológico de errores. El Paso 2 describe cómo eliminar un nodo y los puntos finales relacionados si hay una excepción de puntero nulo.

Si se suprime el perfil del nodo de servidor de aplicaciones antes de anular el registro del nodo, el hecho de ejecutar el mandato deregisterNode no produce ningún efecto. Como el perfil ya no existe, el agente administrativo no reconoce el perfil. Complete el Paso 2 para eliminar el nodo y los puntos finales relacionados del entorno del agente administrativo.

Procedimiento

Anular el registro de un nodo utilizando el mandato deregisterNode .
Si el nodo del que desea anular el registro existe, ejecute el mandato deregisterNode, especificando la vía de acceso del perfil del nodo del que desea anular el registro:
```
deregisterNode -profilePath profile_root/profile_name
```
Por ejemplo, para eliminar el perfil AppSrv02 del entorno de agente administrativo, ejecute el mandato siguiente:
```
deregisterNode -profilePath profile_root/AppSrv02
```
Consulte el tema sobre el mandato deregisterNode para obtener más información acerca de los parámetros del mandato.
Si se produce una excepción de puntero nulo al ejecutar el mandato deregisterNode o si se ha suprimido el perfil de nodo, ejecute los mandatos wsadmin que eliminan el nodo registrado y los puntos finales relacionados.
1. En una línea de mandatos, ejecute un mandato para iniciar la herramienta de scripts wsadmin desde el directorio bin del agente administrativo.
  Si utiliza el lenguaje de scripts Jython, especifique:
```
wsadmin -lang jython
```
  Si utiliza el lenguaje de scripts Jacl, especifique:
```
wsadmin
```
2. Si no conoce el nombre del nodo que se va a eliminar, ejecute el mandato AdminConfig list para listar los nodos que están registrados con el agente administrativo y busque el nodo que se va a eliminar en la lista.
  Para Jython:
```
print AdminConfig.list('ManagedNode')
```
  Para Jacl:
```
$AdminConfig list ManagedNode
```
  La lista de nodos registrados que se muestra es similar a la siguiente:
```
nodeA(cells/myAACell01/managednodes/nodeA|managednode.xml#ManagedNode_1239121412703)
nodeB(cells/myAACell01/managednodes/nodeB|managednode.xml#ManagedNode_1239121498500)
```
  Esta lista muestra que nodeA y nodeB son nodos registrados del agente administrativo myAACell01.
3. Emitir mandatos wsadmin para eliminar el nodo.
  Para eliminar nodeA y guardar los cambios, ejecute los mandatos siguientes sucesivamente.
  Para Jython:
```
mn = AdminConfig.getid('/ManagedNode:nodeA/')

AdminConfig.remove(mn)

AdminConfig.save()
```
  Para Jacl:
```
set mn [$AdminConfig getid /ManagedNode:nodeA/]

$AdminConfig remove $mn

$AdminConfig save
```
4. Ejecute los mandatos wsadmin para eliminar los puntos finales que se han generado para el subsistema al registrar el perfil de nodo.
  Ejecute los siguientes mandatos de forma secuencial para eliminar los puntos finales para el nodo nodeA. El mandato for en Jython y el mandato foreach en Jacl son mandatos en línea que se muestran en diversas líneas para una mejor visualización.
  Para Jython:
```
import java.lang.System as System

lineSeparator = System.getProperty("line.separator")

neps = AdminConfig.list("NamedEndPoint").split(lineSeparator)

for nep in neps:
  set name = AdminConfig.showAttribute(nep, "endPointName")
  if (name.endswith("nodeA") == 1):
     AdminConfig.remove(nep)

AdminConfig.save()

quit
```
  Para Jacl:
```
set neps [$AdminConfig list NamedEndPoint]

foreach nep $neps {set name [$AdminConfig showAttribute $nep endPointName]; 
if {[string last "nodeA" $name] != -1} {$AdminConfig remove $nep}}

$AdminConfig save

quit
```
5. Reinicie el agente administrativo.
  Para reiniciar un agente administrativo denominado adminagent, ejecute los mandatos siguientes desde un indicador de mandatos en el directorio bin del perfil del agente administrativo:
```
stopServer adminagent

startServer adminagent
```
6. Compruebe que el nodo ya no está registrado en el agente administrativo.

Resultados

El nodo de servidor de aplicaciones ya no está registrado en el agente administrativo.

Qué hacer a continuación

Puede utilizar el nodo sin registrar autónomo o registrar el nodo en otro agente administrativo. Opcionalmente, utilice el mandato manageprofiles para suprimir el perfil del servidor de aplicaciones.