Mandatos del objeto AdminTask con scripts wsadmin
Utilice el objeto AdminTask para ejecutar mandatos de administración con la herramienta wsadmin.
Los mandatos administrativos se cargan de manera dinámica cuando se inicia la herramienta wsadmin. Los mandatos administrativos que están disponibles, y las acciones que se puedan realizar con ellos, dependen de la edición del producto que se utilice.
Puede iniciar el cliente de scripts sin necesidad de tener un servidor ejecutándose, mediante el uso de la opción -conntype NONE con la herramienta wsadmin. Los mandatos administrativos de AdminTask están disponibles en las modalidades conectada y local. Si se está ejecutando un servidor en ese momento, no se recomienda ejecutar los mandatos AdminTask en modalidad local porque los cambios de configuración realizados en la modalidad local no se reflejan en la configuración del servidor en ejecución y viceversa. Si guarda una configuración que entre en conflicto, puede dañar la configuración.
En un entorno del gestor de despliegue, las actualizaciones de la configuración sólo están disponibles si un cliente de scripts está conectado a un gestor de despliegue. Cuando se conecta a un agente de nodo o a un servidor de aplicaciones gestionado, no podrá actualizar la configuración porque la configuración de estos procesos servidor son copias de la configuración maestra que reside en el gestor de despliegue. Las copias se crean en la máquina del nodo cuando se produce una sincronización de la configuración entre el gestor de despliegue y el agente de nodo. Realice los cambios de configuración en los procesos del servidor conectando un cliente de scripts a un gestor de despliegue. Para cambiar la configuración, no ejecute el cliente de scripts en la modalidad local en una máquina nodo, ya que no está modalidad no está soportada.
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
createTCPEndPoint
El mandato createTCPEndPoint crea un nuevo punto final que se puede asociar a un canal de entrada TCP.
Objeto de destino
Instancia padre de TransportChannelService que contiene TCPInboundChannel. (ObjectName, obligatorio)Parámetros necesarios
- -name
- Especifica el nombre del nuevo punto final. (String, obligatorio)
- -host
- Especifica el host del nuevo punto final. (String, obligatorio)
- -port
- Especifica el puerto del nuevo punto final. (String, obligatorio)
Parámetros opcionales
Ninguna.Salida de ejemplo
El mandato devuelve el nombre de objeto del punto final que se ha creado.Ejemplos
Uso del ejemplo de modalidad por lotes:
- En Jacl:
$AdminTask createTCPEndPoint (cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1) {-name Sample_End_Pt_Name -host mybuild.location.ibm.com -port 8978}
- Utilizando la serie Jython:
AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', '[-name nombre_punto_final_ejemplo -host ubicación.mi_edificio.ibm.com -port 8978]')
- Utilizando la lista Jython:
AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', ['-name', 'Sample_End_Pt_Name', '-host', 'mybuild.location.ibm.com', '-port', '8978'])
Ejemplo de utilización de la modalidad interactiva:
- Utilizando Jacl:
$AdminTask createTCPEndPoint {-interactive}
- En Jython:
AdminTask.createTCPEndPoint('-interactive')
getTCPEndPoint
El mandato getTCPEndPoint obtiene el punto final especificado asociado con un canal de entrada TCP o con una cadena que contiene un canal de entrada TCP.
Objeto de destino
Instancia de TCPInboundChannel, o cadena que lo contiene, asociada a un NamedEndPoint. (ObjectName, obligatorio)Parámetros necesarios
Ninguna.Parámetros opcionales
Ninguna.Salida de ejemplo
El mandato devuelve el nombre de objeto de un punto final existente asociado a la instancia de canal de entrada TCP o una cadena de canal.Ejemplos
Uso del ejemplo de modalidad por lotes:
- Utilizando Jacl:
$AdminTask getTCPEndPoint TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)
$AdminTask getTCPEndPoint DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)
- Utilizando la serie Jython:
print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)')
print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)')
- Utilizando la lista Jython:
print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)')
print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)')
Ejemplo de utilización de la modalidad interactiva:
- Utilizando Jacl:
$AdminTask getTCPEndPoint {-interactive}
- Utilizando Jython:
print AdminTask.getTCPEndPoint('-interactive')
help
El mandato help proporciona un resumen de los mandatos de ayuda y formas de invocar un mandato administrativo. Puede utilizar caracteres comodín (*) o expresiones regulares Java (.*) en la sintaxis del mandato para personalizar la consulta de búsqueda.
Objeto de destino
Ninguna.Parámetros opcionales
- -commands
- El mandato help proporciona una lista de mandatos administrativos disponibles, si utiliza el parámetro -commands. (String, opcional)
- -commandGroups
- El mandato help proporciona una lista de grupos de mandatos administrativos, si utiliza el parámetro -commandGroups. (String, opcional)
- -commandName
- El mandato help proporciona información de ayuda para un determinado mandato de administración. (String, opcional)
- -stepName
- El mandato help proporciona información de ayuda sobre un paso determinado de un mandato de administración. (String, opcional)
Salida de ejemplo
El mandato devuelve la información general del mandato para el objeto AdminTask.Ejemplos
Ejemplo de uso de la modalidad de proceso por lotes:
- Utilizando Jacl:
$AdminTask help
- Utilizando Jython:
print AdminTask.help()
- Utilizando Jacl:
$AdminTask help -commands
- Utilizando Jython:
print AdminTask.help('-commands')
- Utilizando Jacl:
$AdminTask help createJ2CConnectionFactory
- Utilizando Jython:
print AdminTask.help('createJ2CConnectionFactory')
- Utilizando Jacl:
$AdminTask help -commands *create*
- Utilizando Jython:
print AdminTask.help('-commands *create*')
- Utilizando Jacl:
$AdminTask help -commands <pattern>
- Utilizando Jython:
print AdminTask.help('-commands <pattern>')
listTCPEndPoints
El mandato listTCPEndPoints lista todos los puntos finales con nombre que se pueden asociar a un canal TCP de entrada.
Objeto de destino
Instancia de canal de entrada TCP para la cual se listan los puntos finales indicados. (ObjectName, obligatorio)Parámetros necesarios
Ninguna.Parámetros opcionales
- -excludeDistinguished
- Especifica si mostrar sólo los puntos finales con nombre no distinguidos. Este parámetro no necesita un valor. (Boolean, opcional)
- -unusedOnly
- Especifica si mostrar los puntos finales con nombre que no está utilizando ninguna otra instancia del canal de entrada TCP. Este parámetro no necesita un valor. (Boolean, opcional)
Salida de ejemplo
El mandato devuelve una lista de nombres de objetos para los puntos finales identificados disponibles.Ejemplos
Uso del ejemplo de modalidad por lotes:
- Utilizando Jacl:
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1) {-excludeDistinguished}
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1) {-excludeDistinguished -unusedOnly}
- Utilizando la serie Jython:
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished]')
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished]')
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished -unusedOnly]')
- Utilizando la lista Jython:
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished'])
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished'])
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished', '-unusedOnly'])
Ejemplo de utilización de la modalidad interactiva:
- Utilizando Jacl:
$AdminTask listTCPEndPoints {-interactive}
- Utilizando Jython:
print AdminTask.listTCPEndPoints('-interactive')
listTCPThreadPools
El mandato listTCPThreadPools lista todas las agrupaciones de hebras que se pueden asociar a un canal de entrada TCP o a un canal de salida TCP.
Objeto de destino
Instancia de TCPInboundChannel o TCPOutboundChannel para la cual se listan los candidatos ThreadPool. (ObjectName, obligatorio)Parámetros necesarios
Ninguna.Parámetros opcionales
Ninguna.Salida de ejemplo
El mandato devuelve una lista de nombres de objeto de agrupaciones de hebras disponibles.Ejemplos
Uso del ejemplo de modalidad por lotes:
- Utilizando Jacl:
$AdminTask listTCPThreadPools TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
- Utilizando la serie Jython:
print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
- Utilizando la lista Jython:
print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
Ejemplo de utilización de la modalidad interactiva:
- Utilizando Jacl:
$AdminTask listTCPThreadPools {-interactive}
- Utilizando Jython:
print AdminTask.listTCPThreadPools('-interactive')
updateAppOnCluster
El mandato updateAppOnCluster se puede utilizar para sincronizar nodos y reiniciar los miembros del clúster para una actualización de aplicaciones desplegada en un clúster. Después de la actualización de aplicaciones, este mandato puede utilizare para sincronizar los nodos sin detener todos los miembros del clúster en todos los nodos a la vez. Este mandato sincroniza los nodos uno por uno. Para que los nodos se sincronicen se detienen los miembros del clúster al que se aplica la aplicación, se lleva a cabo la operación de sincronización de nodos y luego se reinician los miembros del clúster.
Este mandato puede exceder el periodo de tiempo de espera del conector predeterminado, en función del número de nodos que abarque el clúster de destino. Asegúrese de establecer los valores de tiempo de espera apropiados en el archivo soap.client.props en el directorio raíz_perfil/properties, cuando se utiliza un conector SOAP; en el archivo sas.client.props, cuando se utiliza un conector JSR160RMI o un conector RMI; y en el archivo ipc.client.props cuando se utiliza un conector IPC.
Este mandato no recibe soporte en modalidad loca.
Objeto de destino
Ninguna.Parámetros necesarios
- -ApplicationNames
- Especifica los nombres de las aplicaciones que se actualizan. (String, obligatorio)
Parámetros opcionales
- -timeout
- Especifica el valor del tiempo de espera excedido en segundos para cada sincronización de nodos. El valor predeterminado es de 300 segundos. (Integer, opcional)
Salida de ejemplo
El mandato no devuelve ninguna salida.Ejemplos
Uso del ejemplo de modalidad por lotes:
- Utilizando Jacl:
$AdminTask updateAppOnCluster {-ApplicationNames app1}
$AdminTask updateAppOnCluster { -ApplicationNames app1 -timeout 600}
- Utilizando la serie Jython:
AdminTask.updateAppOnCluster('[-ApplicationNames app1]')
AdminTask.updateAppOnCluster('[-ApplicationNames app1 -timeout 600]')
- Utilizando la lista Jython:
AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1'])
AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1', '-timeout', '600'])
Ejemplo de utilización de la modalidad interactiva:
- Utilizando Jacl:
$AdminTask updateAppOnCluster -interactive
- En Jython:
AdminTask.updateAppOnCluster('-interactive')