Grupo de mandatos Utility para el objeto AdminTask
Puede utilizar los lenguajes de script Jython o Jacl para gestionar servidores con la herramienta wsadmin. Los mandatos y parámetros del grupo Utility se pueden utilizar para cambiar el nombre de host de un nodo, para consultar el nombre del gestor de despliegue y para determinar si el sistema está en un servidor único o en un despliegue de red.
El grupo de mandatos Utility para el objeto AdminTask incluye los mandatos siguientes:
changeHostName
Utilice el mandato changeHostName para cambiar el nombre de host de un nodo.
Objeto de destino
Ninguno
Parámetros y valores de retorno
- -hostName
- Nombre de host nuevo. (String, obligatorio)
- -nodeName
- Nombre del nodo cuyo nombre de host se cambia. (String, obligatorio)
Parámetros opcionales:
- -systemName
- Nombre del sistema z/OS en el que se ejecuta este nodo. Este campo sólo es necesario si un nodo
debe trasladarse de un sistema a otro, por ejemplo, desde el sistema SYSA al sistema SYSB. Si no está seguro
del valor que debe especificar para este parámetro, emita el mandato IPLINFO en el sistema z/OS, y utilice
el nombre que se muestra en el campo Sysname= como valor para este parámetro. Nota: Al ejecutar de forma interactiva el mandato changeHostName, aparece el parámetro systemName, pero solo se utiliza para un sistema z/OS. El parámetro systemName representa el nombre del sistema z/OS que está definido en el archivo server.xml como un valor de propiedad, was.ConfiguredSystemName. Cuando el parámetro systemName está seleccionado, esta propiedad se ha modificado.
- -regenDefaultCert
- Una solicitud para volver a generar los certificados predeterminados. El único valor válido para este
parámetro es "true" si desea volver a generar certificados predeterminados. Cualquier otro valor presupone
que NO volverá a generar certificados predeterminados. El argumento de serie se procesa como booleano. El booleano devuelto representa el valor true si el argumento string no es nulo y es igual a
la serie "true", independientemente de las mayúsculas y minúsculas. El parámetro
regenDefaultCert funciona
igual que
AdminTask.createChainedCertificate y tiene los siguientes valores predeterminados:
- -keyStoreName "NodeDefaultKeyStore"
- -keyStoreScope "(node):" + nodeName
- -certificateAlias" "default_" + hostName
- -certificateCommonName" nodeName
- -certificateOrganization" "IBM"
- -certificateOrganizationalUnit" nodeName
- -certificateCountry "US"
Nota: Para los parámetros AdminTask.createChainedCertificate y regenDefaultCert, si se utiliza el nodo del gestor de despliegue el valor DE -keyStoreName cambia a -keyStoreName "CellDefaultKeyStore" y el valor de -keyStoreScope -keyStoreScope "(cell):" + cellname.El conmutador es un conmutador cómodo que hace suposiciones sobre los valores predeterminados de los parámetros del certificado. Si no se utilizan los valores predeterminados, en su lugar se debe utilizar AdminTask.createChainedCertificate o regenDefaultCert.
Tenga en cuenta estos detalles funcionales:- keyStoreName y keyStoreScope no son válidos con el parámetro regenDefaultCert.
- Cuando se ejecuta el mandato changeHostName, no se puede especificar certificateCommonName (CN de la nueva certificación). Para especificar un nuevo nombre de sistema principal como CN, es necesario utilizar AdminTask.createChainedCertificate .
Ejemplos
Ejemplo de utilización de la modalidad por lotes:
Utilizando Jacl:
$AdminTask changeHostName {-hostName nombre_host -nodeName nombre_nodo -systemName nombre_sistema}
Utilizando la serie Jython:
AdminTask.changeHostName('-hostName nombre_host -nodeName nombre_nodo -systemName nombre_sistema')
Utilizando la lista Jython:
AdminTask.changeHostName(['-hostName', 'nombre_host', '-nodeName', 'nombre_nodo', '-systemName', 'system_name'])
Ejemplo de utilización de la modalidad interactiva:
Utilizando Jacl:
$AdminTask changeHostName {-interactive}
Utilizando la serie Jython:
AdminTask.changeHostName ('[-interactive]')
Utilizando la lista Jython:
AdminTask.changeHostName (['-interactive'])
getDmgrProperties
Utilice el mandato getDmgrProperties para devolver el nombre del gestor de despliegue.
Objeto de destino
Ninguno
Parámetros y valores de retorno
- Parámetros: ninguno
- Devuelve el nombre del gestor de despliegue de un sistema de despliegue de red. Devuelve una serie vacía si el sistema es un solo servidor.
Ejemplos
Ejemplo de utilización de la modalidad por lotes:
Utilizando Jacl:
$AdminTask getDmgrProperties {}
Utilizando Jython:
AdminTask.getDmgrProperties()
isFederated
Utilice el mandato isFederated para comprobar si el sistema es un solo servidor o un despliegue de red.
Objeto de destino
Ninguno
Parámetros y valores de retorno
- Parámetros: ninguno
- Devuelve: booleano. true si es sistema es un sistema de despliegue de red. De lo contrario, devuelve false.
Ejemplos
Ejemplo de utilización de la modalidad por lotes:
- Utilizando Jacl:
$AdminTask isFederated {}
- Utilizando la serie Jython:
AdminTask.isFederated ()
renameCell


Objeto de destino
Ninguno
Parámetros y valores de retorno
- -newCellName
- Nuevo nombre de célula. (String, obligatorio)
- -dmgr_host
- Nombre del host o dirección IP del sistema del gestor de despliegue. (String, obligatorio si el mandato se ejecuta en un nodo federado)
- -dmgr_port
- Puerto de conexión JMX (Java Management Extensions). (String, obligatorio si el mandato se ejecuta en un nodo federado. Si no se especifica, se utiliza el valor predeterminado "8879")
- -connType
- Tipo de conector JMX que se utiliza para conectar con el gestor de despliegue. SOAP es el tipo de conector JMX predeterminado para el mandato. Otros tipos válidos son JSR160RMI o RMI (Remote Method Invocation).(String, obligatorio si el mandato se ejecuta en un nodo federado. Si no se especifica, se utiliza el valor predeterminado "SOAP").
- -userName
- Nombre de usuario para la autenticación si está habilitada la seguridad. (String, obligatorio si el mandato se ejecuta en un nodo federado y la seguridad está habilitada).
- -password
- Contraseña para la autenticación si está habilitada la seguridad. (String, obligatorio si el mandato se ejecuta en un nodo federado y la seguridad está habilitada).
Parámetros opcionales:
- -regenCerts
- Determina si se volverán a generar los certificados SSL (Secure Sockets Layer) para todos los nodos de una célula. Sólo se vuelven a generar los certificados para los almacenes de claves predeterminados. Este parámetro no se aplica para las células en sistemas operativos z/OS. Tenga en cuenta que si se vuelven a generar los certificados es posible que los clientes que acceden al servidor restablezcan la confianza con el servidor obteniendo el nuevo certificado. El valor predeterminado es false. Establézcala en true para volver a generar los certificados SSL para los nodos de una célula. (Booleano, opcional)
- -updateJaccContextID
- Determina si se actualizará el ID de contexto de seguridad de las aplicaciones que utiliza un proveedor JAAC (Java Authorization Contract for Containers). El valor predeterminado es false. Establézcala en true para actualizar el ID de contexto de seguridad. (Booleano, opcional)
Ejemplo de utilización de la modalidad por lotes:
- Utilizando la serie Jython:
AdminTask.renameCell('-newCellName nuevo_nombre_célula')
- Utilizando la lista Jython:
AdminTask.renameCell(['-newCellName', 'nuevo_nombre_célula'])
Ejemplo de utilización de la modalidad interactiva:
- Utilizando la serie Jython:
AdminTask.renameCell ('[-interactive]')
- Utilizando la lista Jython:
AdminTask.renameCell (['-interactive'])
Escenarios de ejemplo utilizando renameCell


- Cambio de nombre de una célula para un servidor de aplicaciones autónomo:
- Detenga un servidor autónomo.
- Renombre la célula utilizando wsadmin en modalidad local:
AdminTask.renameCell('-newCellName nuevo_nombre_célula')
- Cambio de nombre de una célula para un gestor de despliegue y sus nodos federados:
Para cambiar el nombre de una célula para una topología de despliegue de red, se debe ejecutar el mandato en un nodo/perfil de gestor de despliegue y todos los nodos/perfiles federados.
Avoid trouble: si la célula forma parte de una topología de varias células, desenlace la célula de las otras células antes de realizar estos pasos y enlácela de nuevo cuando los haya completado.gotcha
- Detenga todos los servidores de la célula, incluidos el servidor de gestor de despliegue, los servidores de agente de nodo y todos los servidores de aplicaciones.
- Renombre la célula de un nodo/perfil de gestor de despliegue: ejecute el siguiente mandato con wsadmin en el nodo local, lo que hace que el nombre de la célula cambie junto con los cambios de certificado SSL en el repositorio maestro del gestor de despliegue.
AdminTask.renameCell('[-newCellName nuevo_nombre_célula]')
- Ejecute el mandato para renombrar la célula para todos los nodos/perfiles federados de la célula.
- Inicie el servidor del gestor de despliegue.
- En el perfil de cada agente de nodo y para cada nodo que no sea el nodo del gestor de despliegue, inicie wsadmin en el nodo local y ejecute el mandato que se muestra a continuación:
AdminTask.renameCell('[-newCellName nuevo_nombre_célula –dmgr_host nombre_host_gestor_despliegue –dmgrPort puerto_conector_gestor_despliegue –connType SOAP –username mi_usuario –password mi_contrasea]')
- Cambio de nombre de una célula para un servidor de agente de administración:
- Detenga un servidor de agente de administración.
- Renombre la célula utilizando wsadmin en modalidad local:
AdminTask.renameCell('-newCellName nuevo_nombre_célula')
Nota: Si desea renombrar una célula para un servidor de aplicaciones autónomo registrado en un servidor de agente de administración, primero debe anular el registro de ese nodo autónomo en ese servidor de administración. Si desea que el servidor de administración continúe gestionando ese nodo autónomo, deberá volver a registrar el nodo en el servidor de administración cuando haya ejecutado el mandato de cambio de nombre de célula.
- Cambio de nombre de una célula para un servidor de gestor de trabajos:
- Detenga un servidor de gestor de trabajos.
- Renombre la célula utilizando wsadmin en modalidad local:
AdminTask.renameCell('-newCellName nuevo_nombre_célula')
Avoid trouble: eso es solo para perfiles de gestor de trabajos autónomo. No lo utilice para un gestor de despliegue que funcione como gestor de trabajos.gotcha
- Cambio de nombre de una célula en una topología de varias células:
Para renombrar la célula en la topología de varias células, como la topología en estrella, antes del cambio de nombre se debe desconectar la célula de las demás células. Tras el cambio de nombre, se debe volver a conectarla a las otras células.