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

New feature New feature:
Utilice el mandato renameCell para cambiar el nombre de célula del servidor de aplicaciones autónomo, el gestor de despliegue, el agente administrativo, el gestor de trabajo y los perfiles de nodos federados. Este mandato sólo se puede ejecutar en la modalidad local de wsadmin, es decir, wsadmin -conntype none.newfeat
Avoid trouble Avoid trouble: No utilice el mandato renameCell en un entorno de célula mixto donde una célula contenga nodos instalados con distintas versiones de WebSphere Application Server.gotcha

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

Avoid trouble Avoid trouble: Se recomienda hacer una copia de seguridad de la configuración del nodo con la herramienta backupConfig desde el directorio profile_root/bin antes de cambiar el nombre de célula para dicho nodo mediante el mandato renameCell. Si no está satisfecho con los resultados del mandato renameCell y la ejecución del mandato renameCell ha fallado de forma inesperada, utilice la herramienta restoreConfig para restaurar una configuración de copia de seguridad.gotcha
Avoid trouble Avoid trouble: Haga una copia de seguridad del archivo de script profile_root/bin/setupCmdLine antes de ejecutar el mandato renameCell. El mandato actualiza el nombre de célula en este archivo con el nuevo nombre de célula, pero no puede revertir el cambio si un usuario decide descartar el cambio de configuración resultado de la ejecución de este mandato. Si decide hacer esto, deberá restaurar el archivo tras descartar el cambio de configuración; de lo contrario, no podrá iniciar el servidor en este perfil.gotcha
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 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 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.


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_atutility
File name: rxml_atutility.html