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.

Nota de configuración: Con el lenguaje de scripts Jacl, el mandato subst le permite sustituir un valor establecido previamente por una variable en el mandato. Por ejemplo:
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
Los mandatos AdminTask siguientes están disponibles pero no pertenecen a un grupo:

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:

Los siguientes ejemplos de mandatos devuelven información de ayuda general para el objeto AdminTask:
  • Utilizando Jacl:
    $AdminTask help
  • Utilizando Jython:
    print AdminTask.help()
Los siguientes ejemplos de mandatos muestran cada mandato para el objeto AdminTask:
  • Utilizando Jacl:
    $AdminTask help -commands
  • Utilizando Jython:
    print AdminTask.help('-commands')
Los siguientes ejemplos de mandatos devuelven información detallada del mandato para el mandato createJ2CConnectionFactory del objeto AdminTask:
  • Utilizando Jacl:
    $AdminTask help createJ2CConnectionFactory
  • Utilizando Jython:
    print AdminTask.help('createJ2CConnectionFactory')
Los siguientes ejemplos demuestran la utilización del carácter de comodín (*) para devolver los mandatos que contengan la serie create:
  • Utilizando Jacl:
    $AdminTask help -commands *create*
  • Utilizando Jython:
    print AdminTask.help('-commands *create*')
Los ejemplos siguientes demuestran la sintaxis para utilizar expresiones Java normales (.*):
  • 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')

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=rxml_admintask
File name: rxml_admintask.html