Tipos de trabajo administrativos utilizando el script wsadmin

En un entorno de gestión flexible, puede utilizar la herramienta wsadmin para someter trabajos administrativos al gestor de trabajos. En este tema se proporciona información detallada sobre los trabajos administrativos, los parámetros de trabajo y sintaxis de mandato de ejemplo.

En un entorno de gestión flexible, puede configurar un agente administrativo y un gestor de trabajos para someter trabajos a varios destinos o grupos de destino de la configuración. A continuación, puede enviar trabajos administrativos a los trabajos de cola del entorno gestionado. Cada trabajo administrativo tiene un tipo de trabajo correspondiente, que define los parámetros necesarios para enviar el trabajo. Puede utilizar los mandatos del grupo de mandatos AdministrativeJobs para enviar los trabajos administrativos al gestor de trabajos.

Puede enviar los trabajos administrativos para gestionar las aplicaciones.

Parámetros comunes para todos los tipos de trabajo

Utilice el mandato submitJob para enviar los trabajos administrativos. Al someter los trabajos se incluye esta información:
Parámetros necesarios
Cada mandato submitJob requiere al menos el parámetro jobType. Muchos mandatos submitJob requieren también los parámetros targetList o jobParams:
Tabla 1. Descripciones de los parámetros de submitJob necesarios. Ejecute un mandato submitJob con sus parámetros necesarios.
Parámetro Descripción Tipo
jobType Especifica el tipo de trabajo que se ha de realizar. Existen muchos tipos de trabajo en el entorno de gestión flexible que incluyen la gestión de aplicaciones, el mantenimiento de productos, la configuración y los trabajos de control de tiempo de ejecución del servidor de aplicaciones. Serie
targetList Especifica uno o varios destinos gestionados donde se ejecuta el trabajo. Serie
jobParams Especifica la información de configuración además del tipo y el destino del trabajo para poder ejecutar el trabajo. Los parámetros de trabajo son específicos de cada tipo de trabajo. Serie
Parámetros genéricos opcionales
Además de los parámetros específicos del trabajo, puede incluir cualquiera de los parámetros opcionales siguientes al someter el trabajo:
Tabla 2. Descripciones del parámetro genérico opcional submitJob. Ejecute un mandato submitJob con sus parámetros necesarios y con los parámetros opciones adecuados a su situación.
Parámetro Descripción Tipo
group Especifica el nombre del grupo de destinos gestionados donde se ejecuta el trabajo. Serie
nombre de usuario Especifica el nombre de usuario que se ha utilizar en los destinos cuando se ejecuta el trabajo. Si el nombre de usuario y la contraseña no se especifican, y la seguridad está habilitada, se utiliza el ID de usuario del gestor de trabajos. Serie
password Especifica la contraseña del nombre de usuario que se ha utilizar en los destinos cuando se ejecuta el trabajo. Si el nombre de usuario y la contraseña no se especifican, y la seguridad está habilitada, se utiliza el ID de usuario del gestor de trabajos. Serie
privateKeyFile Especifica el archivo de clave privada plenamente cualificado que se ha utilizar en los destinos cuando se ejecuta el trabajo. Especifique la vía de acceso completa para el almacén de claves. Serie
passphrase Especifica la frase de contraseña plenamente cualificada que se ha de utilizar en los destinos cuando se ejecuta el trabajo. Especifique una frase de contraseña si el almacén de claves la requiere. Serie
useSudo Especifica que se debe habilitar el uso de un usuario sustituto para llevar a cabo mandatos en el host de destino. El valor predeterminado es no utilizar sudo. La opción sudo solamente recibe soporte en sistemas operativos AIX, HP-UX, Linux y Solaris.

Habilite useSudo para cambiar usuarios antes que se ejecute un trabajo y, a continuación, especifique el nombre de usuario y la contraseña para el usuario sustituir según sea necesario. sudo significa "substitute user do" (acción que realiza un usuario sustituto). Si el host de destino no requiere ninguna contraseña, deje los campos de contraseña en blanco. Son válidas las siguientes combinaciones de selección:

  • Habilite useSudo y no especifique valores para sudoUsername ni sudoPassword. Estas selecciones utilizan el usuario predeterminado que se establece en el archivo /etc/sudoers y utiliza la contraseña del usuario de conexión.
  • Habilite useSudo, especifique un valor para sudoUsername y no especifique ningún valor para sudoPassword. Estas selecciones utilizan el usuario especificado y utilizan la contraseña del usuario de conexión.
  • Habilite useSudo, especifique un valor para sudoUsername y especifique un valor para sudoPassword. Estas selecciones utilizan el usuario especificado y la contraseña sudo.
Booleano
sudoUsername Especifica un nombre de usuario para el usuario sustituto. Para obtener información acerca de cuándo se debe especificar un valor para sudoUsername, consulte la descripción de useSudo. Serie
sudoPassword Especifica una contraseña para un usuario sustituto. Para obtener información acerca de cuándo se debe especificar un valor para sudoPassword, consulte la descripción de useSudo. Serie
descripción Especifica una descripción del trabajo. Serie
activationDateTime Especifica la fecha y la hora a las que se va a activar el trabajo, con el formato 2006-05-03T10:30:45-0000. La sección -0000 del valor del parámetro activationDateTime representa el formato RFC 822. Puede especificar Z como una abreviatura para la hora media de Greenwich (GMT) como, por ejemplo, 2006-05-03T10:30:45Z. Si no especifica el huso horario, el sistema utiliza el huso horario del gestor de trabajos. Serie
expirationDateTime Especifica la fecha de caducidad para el trabajo, con el formato 2006-05-03T10:30:45-0000. La sección -0000 del valor del parámetro activationDateTime representa el formato RFC 822. Puede especificar Z como una abreviatura para la hora media de Greenwich (GMT) como, por ejemplo, 2006-05-03T10:30:45Z. Si no especifica el huso horario, el sistema utiliza el huso horario del gestor de trabajos. Serie
executionWindow Especifica el intervalo de repetición, si existe, del trabajo. Serie
executionWindowUnit Especifica la unidad de medida del intervalo de repetición. Los valores válidos incluyen HOURS, DAYS, WEEKS, MONTHS, CONNECT y ONCE. El valor predeterminado es HOURS. Serie
email Especifica la dirección de correo electrónico a la que el sistema envía las notificaciones de trabajo. Serie

Escriba los mandatos wsadmin desde el directorio bin del perfil del gestor de trabajos. Este tema muestra ejemplos en lenguaje de script Jython.

Ejemplo de uso:

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp] -email admin@company.com ')

Ejemplo de utilización de la modalidad interactiva:

AdminTask.submitJob('-interactive')

Uso del ejemplo de resultados de trabajo:

Al ejecutar un mandato submitJob se devuelve un símbolo de trabajo como, por ejemplo, 124231200726586682. Para obtener información acerca del símbolo del trabajo, ejecute un mandato getJobTargetStatus:

AdminTask.getJobTargetStatus('[-jobToken 124231200726586682]')
Se generan registros de trabajos administrativos como resultado de lo siguiente:
  • El valor NOT_ATTEMPTED especifica que el sistema no ha intentado completar el trabajo.
  • El valor DISTRIBUTED especifica que el agente para el destino ha recibido el trabajo, pero el trabajo no está completo.
  • El valor ASYNC_IN_PROGRESS especifica que el destino está ejecutando el trabajo de forma simultánea con otros trabajos.
  • El valor FAILED especifica que el trabajo ha fallado.
  • El valor REJECTED especifica que el destino ha rechazado el trabajo debido a que, por ejemplo, el destino no da soporte al tipo de trabajo.
  • El valor SUCCEEDED especifica que el trabajo se ha completado correctamente.
  • El valor PARTIALLY_SUCCEEDED especifica que el trabajo se ha completado parcialmente. Por ejemplo, se puede producir un éxito parcial si un destino representa a varios servidores y sólo algunos de los servidores en el destino completan el trabajo correctamente.

El estado del trabajo generalmente genera un progreso de DISTRIBUTED a ASYNC_IN_PROGRESS a SUCCEEDED. Es posible que deba ejecutar un mandato getJobTargetStatus más de una vez, hasta que el resultado sea FAILED, REJECTED o SUCCEEDED.

De forma predeterminada, un trabajo permaneces activo durante un día (24 horas).

Someter un trabajo para recopilar inventario

El trabajo administrativo de inventario recopila datos de inventario de los destinos. Estos datos de inventario incluyen los tipos de trabajos disponibles y el estado de los recursos gestionados como, por ejemplo, aplicaciones y servidores, para cada destino.

Cuando un destino es un host, los datos de inventario incluyen información sobre el host como, por ejemplo, el nombre del sistema operativo, la versión, Installation Manager, el grupo de paquetes, los paquetes, los perfiles y otros recursos.

Si desea que el trabajo de inventario encuentre recursos de Liberty, tendrá que tener definidas las variables WLP_WORKING_DIR, WLP_SHARED_DIR o WLP_ADDITIONAL_DIRS. Consulte cómo establecer variables para servidores de Liberty.

[IBM i]Nota: El gestor de instalación centralizada no puede descubrir perfiles para Aplicaciones Cliente y Plugin en plataformas IBM i.

Parámetros de trabajo

Ninguno.

Ejemplo de uso

AdminTask.submitJob('-jobType inventario -targetList [Target1 Target2 Target3]')

Someter un trabajo para recopilar el estado del destino

El trabajo administrativo de estado recopila datos de estado desde los destinos. Utilice este trabajo, en lugar del trabajo de inventario, si únicamente desea renovar datos en los recursos gestionados, por ejemplo, aplicaciones y servidores para cada destino.

Cuando un servidor de Liberty es el destino, este trabajo actualiza el estado del servidor sólo de los recursos de servidor de Liberty. No descubre nuevos recursos de servido ni elimina recursos de servidor suprimidos. Para descubrir nuevos recursos de servidor, someta un trabajo de inventario.

Parámetros de trabajo

Ninguno.

Ejemplo de uso

AdminTask.submitJob('-jobType status -targetList [Target1 Target2 Target3]')

Someter trabajos para gestionar archivos

Puede utilizar los trabajos de gestión de archivos para recopilar, distribuir y eliminar archivos. Por ejemplo, puede someter el trabajo collectFile para transferir un archivo al gestor de trabajos. El trabajo distributeFile transfiere un archivo desde el gestor de trabajos a los destinos para el trabajo. El trabajo removeFile elimina un archivo que se distribuyó previamente al destino:

Puede utilizar trabajos de gestión de archivos con destinos de host remoto. Utilice distributeFile para enviar un archivo a hosts remotos, collectFile para recopilar archivos de hosts remotos y removeFile para suprimir archivos de hosts remotos.

collectFile

El trabajo administrativo collectFile recopila un archivo de destino y lo transfiere al gestor de trabajos. Si la ubicación de origen es un directorio en lugar de un archivo, el trabajo comprime de forma recursiva el contenido del directorio y transfiere el archivo zip comprimido resultante.

Parámetros de trabajo

Tabla 3. Descripciones del parámetro collectFile. Ejecute un mandato submitJob collectFile con al menos un parámetro de origen y otro de destino.
Parámetro Descripción Tipo
source Especifica la ubicación de origen del archivo o directorio de interés. El sistema determina que la ubicación del archivo es relativa al directorio raíz_perfil del destino. Serie
destino Especifica la ubicación de destino. El valor es relativo a un directorio denominado raíz_perfil/config/temp/NombreGestorTrabajos/señalTrabajo/nombreDestino. Serie
distributionProvider Especifica de forma opcional el nombre del proveedor de distribución. Serie

Ejemplo de uso

El ejemplo siguiente ejecuta el trabajo collectFile:
AdminTask.submitJob('[-jobType collectFile -targetList [Target1]
 -jobParams [[source logs][destination targetLocationOfFile]]]')

distributeFile

El trabajo administrativo distributeFile transfiere un archivo del gestor de trabajos a los destinos para el trabajo. El sistema almacena el archivo en el destino como preparación para trabajos subsiguientes que utilicen el archivo. Los trabajos administrativos installApplication y updateApplication hacen referencia al destino que proporciona al trabajo distributeFile como ubicación del contenido de la aplicación en el destino. Además, puede utilizar este trabajo para distribuir archivos de script y archivos de configuración basados en propiedades.

El archivo que se va a distribuir desde el gestor de trabajos debe encontrarse inicialmente en el directorio /config/temp/JobManager del perfil del gestor de trabajos. A continuación, el sistema mueve el archivo al directorio downloadedContent del agente administrativo o del perfil del gestor de despliegue. El parámetro de destino es relativo al directorio downloadedContent y puede ser un nombre de archivo o un nombre de vía de acceso relativa. Puede utilizar una vía de acceso relativa para crear subdirectorios separados bajo el directorio downloadedContent para organizar los archivos descargados.

Avoid trouble Avoid trouble: Para enviar el trabajo distributeFile antes de enviar otros trabajos, primero debe colocar el archivo que se debe distribuir bajo el directorio JobManager. Para crear el directorio JobManager manualmente, complete los siguientes pasos:
  1. Mediante un usuario administrativo con permiso de *ALLOBJ y *SECADM, utilice el indicador de mandatos para cambiar los directorios a raíz_perfil/JobManagerName/config/temp.
  2. Escriba el mandato siguiente: mkdir JobManager
  3. Escriba el mandato siguiente: chown -R QEJBSVR JobManager
  4. Copie el archivo que se debe distribuir en el directorio JobManager.
  5. Desde la consola administrativa, envíe el trabajo distributeFile.
gotcha

Parámetros de trabajo

Tabla 4. Descripciones del parámetro distributeFile. Ejecute un mandato submitJob distributeFile con al menos un parámetro de origen y otro de destino.
Parámetro Descripción Tipo
source Especifica la ubicación de origen del contenido que debe distribuirse. Serie
destino Especifica la ubicación de destino en el destino en el que el sistema guarda el contenido. Serie
distributionProvider Especifica de forma opcional el nombre del proveedor de distribución. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType distributeFile -targetList [Target1 Target2 Target3]
-jobParams [[source file:/MyApp.ear][destination MyApp.ear]]')

removeFile

El trabajo administrativo removeFile suprime un archivo que anteriormente se ha distribuido al destino. El parámetro de ubicación es relativo al directorio downloadedContent, y la ubicación debe ser la misma que la que se especificó para el parámetro de destino cuando se distribuyó el archivo.

Parámetros de trabajo

Tabla 5. Descripciones del parámetro removeFile. Ejecute un mandato submitJob removeFile con al menos un parámetro de ubicación.
Parámetro Descripción Tipo
ubicación Especifica la ubicación del archivo que se debe eliminar del destino. Utilice el valor de destino del trabajo distributeFile. Serie
distributionProvider Especifica de forma opcional el nombre del proveedor de distribución. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType removeFile -targetList [Target1 Target2 Target3]
 -jobParams [location MyApp.ear]')

Someter un trabajo que ejecuta un script wsadmin

Puede someter un trabajo para ejecutar un script wsadmin en un destino gestionado del gestor de trabajos. El destino gestionado puede ser un gestor de despliegue o un servidor de aplicaciones no federado. Antes de ejecutar un script wsadmin en un destino gestionado, transfiera el script wsadmin y cualquier perfil de script del gestor de trabajos al destino gestionado mediante el trabajo distributeFile. Recuerde cualquier valor de destino que se especifique al distribuir el archivo. A continuación, utilice el trabajo siguiente para ejecutar el script wsadmin. Utilice el valor de destino para el parámetro scriptFileLocation. Si ha especificado un valor de destino de perfil, opcionalmente utilice el valor de destino de perfil para el parámetro profileLocation.

El resultado del estado de un trabajo runWsadminScript depende del código de retorno del script. Si éste es cero, el trabajo se marca como satisfactorio. Si es un valor distinto de cero, el trabajo se marca como anómalo.

Parámetros de trabajo

Tabla 6. Descripción del parámetro de trabajo. Ejecute un mandato submitJob runWsadminScript con al menos un parámetro scriptFileLocation.
Parámetro Descripción Tipo
scriptFileLocation Especifica la ubicación del archivo de script que se debe ejecutar en el destino gestionado. La ubicación es el destino que se ha asignado al distribuir el archivo en el destino. Serie
profileLocation Opcionalmente especifica la ubicación del script de perfil que se ejecutará con el script wsadmin. Este parámetro se corresponde con el parámetro -profile de wsadmin. La ubicación es el destino especificado cuando se distribuyó el archivo al destino. Serie
scriptParameters Opcionalmente especifica los parámetros que se van a escribir en el script wsadmin. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType ejecutar_script_Wsadmin -targetList [DmgrManagedNodeName]
 -jobParams [ [scriptFileLocation myScript.py] [profileLocation scriptProfile.py] [scriptParameters [param1 param2]] ]]')

Para los scripts wsadmin que procesan varios pares de palabra clave y valor para los parámetros de mandatos, por ejemplo, los parámetros de mandato argv[], utilice scriptParameters para especificar las palabras clave y los valores:

AdminTask.submitJob('[-jobType ejecutar_script_Wsadmin -targetList [miNodo01]
 -jobParams [ [scriptFileLocation myScript.py] [scriptParameters [-keyword1 value1 -keyword2 value2]] ]]')

Envío de trabajos para gestionar aplicaciones

Puede utilizar los trabajos de gestión de aplicaciones para distribuir, instalar, actualizar, eliminar y controlar aplicaciones en el servidor de aplicaciones. Por ejemplo, puede someter los trabajos distributeFile, installApplication y startApplication para desplegar aplicaciones de su entorno. Para eliminar aplicaciones del entorno, envíe los trabajos stopApplication, uninstallApplication y removeFile. Utilice los trabajos de gestión de aplicaciones siguientes para administrar las configuraciones de aplicación:

installApplication

El trabajo administrativo installApplication instala y enlaza una aplicación o un elemento de aplicación en el entorno de destino. Debe ejecutar el trabajo distributeFile y distribuir el contenido desplegable en los destinos antes de poder instalar la aplicación.

El trabajo installApplication no proporciona un modo de suministrar información de enlaces ni otros atributos de despliegue. Si necesita esta posibilidad, puede utilizar los trabajos runWsadminScript o configureProperties.

Importante: Para poder someter este trabajo, debe existir el directorio profile_root/downloadedContent para el gestor de despliegue o el agente administrativo. Si no existe, debe crearlo.

Parámetros de trabajo

Tabla 7. Descripciones de los parámetros de installApplication. Ejecute un mandato submitJob installApplication con al menos un parámetro applicationName.
Parámetro Descripción Tipo
applicationName Especifica un nombre de aplicación para utilizarse para identificar la aplicación que se va a instalar. Generalmente, este es el nombre de archivo base de la aplicación empresarial (por ejemplo, MyApp paraMyApp.ear), pero puede elegir cualquier nombre. Serie
appLocation Opcionalmente, especifica la ubicación del archivo de aplicación que se va a instalar. De manera predeterminada, el trabajo installApplication añade la notación del formato de archivos .ear al nombre de la aplicación, y busca la aplicación en la ubicación de destino predeterminada.

De este modo, si especifica MyApp para applicationName, de forma predeterminada appLocation es downloadedContent/myapp.ear en el destino gestionado. Si especifica un valor para appLocation, utilice el valor de destino que ha especificado cuando ha distribuido la aplicación.

Serie
serverName Especifica de forma opcional el nombre del servidor donde el sistema instala la aplicación. Serie
nodeName Opcionalmente, especifica el nodo de interés, que identifica el servidor en una célula de WebSphere Application Server, Network Deployment. Serie
clusterName Opcionalmente especifica el nombre del clúster en el que se instala la aplicación. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp]]')

o:

AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')

startApplication

El trabajo administrativo startApplication inicia una aplicación previamente instalada en el destino. El sistema cambia el estado de la aplicación a activa o RUNNING, carga la aplicación en el tiempo de ejecución y la abre para recibir las solicitudes de cliente. Éste es el último paso del proceso de despliegue de la aplicación.

Parámetros de trabajo

Tabla 8. Descripción del parámetro startApplication. Ejecute un mandato submitJob startApplication con un parámetro applicationName.
Parámetro Descripción Tipo
applicationName Especifica el nombre de la aplicación que se va a iniciar. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType startApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp]')

stopApplication

El trabajo administrativo stopApplication detiene la aplicación en el destino. El sistema cambia el estado de la aplicación a detenido y ya no recibe más solicitudes de cliente. Puede utilizar el trabajo startApplication para reiniciar la aplicación. Éste es el primer paso del proceso de eliminación de la aplicación.

Tabla 9. Descripción del parámetro stopApplication. Ejecute un mandato submitJob stopApplication con un parámetro applicationName.
Parámetro Descripción Tipo
applicationName Especifica el nombre de la aplicación que se va a detener. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType stopApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp]')

updateApplication

El trabajo administrativo updateApplication actualiza una aplicación o un elemento de aplicación en el entorno de destino. Debe ejecutar el trabajo distributeFile y distribuir el contenido desplegable en los destinos antes de poder actualizarla aplicación.

Importante: Para poder someter este trabajo, debe existir el directorio profile_root/downloadedContent para el gestor de despliegue o el agente administrativo. Si no existe, debe crearlo.

Parámetros de trabajo

Tabla 10. Descripciones del parámetro updateApplication. Ejecute un mandato submitJob updateApplication con al menos un parámetro applicationName.
Parámetro Descripción Tipo
applicationName Especifica un nombre de aplicación para utilizarse para identificar la aplicación que se va a actualizar. Generalmente, este es el nombre de archivo base de la aplicación empresarial (por ejemplo, MyApp paraMyApp.ear), pero puede elegir cualquier nombre. Serie
appLocation Opcionalmente, especifica la ubicación del archivo de aplicación que se va a instalar. De manera predeterminada, el trabajo updateApplication añade la notación del formato de archivos .ear al nombre de la aplicación, y busca la aplicación en la ubicación de destino predeterminada.

De este modo, si especifica MyApp para applicationName, de forma predeterminada appLocation es downloadedContent/myapp.ear en el destino gestionado. Si especifica un valor para appLocation, utilice el valor de destino que ha especificado cuando ha distribuido la aplicación.

Serie
serverName Especifica de forma opcional el nombre del servidor donde el sistema actualiza la aplicación. Serie
nodeName Opcionalmente, especifica el nodo de interés, que identifica el servidor en una célula de WebSphere Application Server, Network Deployment. Serie
clusterName Opcionalmente especifica el nombre del clúster en el que se actualiza la aplicación. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp]]')

o:

AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3]
 -jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')

uninstallApplication

El trabajo administrativo uninstallApplication desinstala la aplicación de los destinos.

Parámetros de trabajo

Tabla 11. Descripción del parámetro uninstallApplication. Ejecute un mandato submitJob uninstallApplication con un parámetro applicationName.
Parámetro Descripción Tipo
applicationName Especifica el nombre de la aplicación que se va a eliminar. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType desinstallApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp]')

Envío de trabajos para gestionar servidores

El administrador del sistema puede utilizar los trabajos de configuración del servidor de aplicaciones para modificar la configuración de los servidores de aplicaciones locales y remotos.

createApplicationServer

El trabajo administrativo createApplicationServer crea un servidor de aplicaciones en el entorno de destino.

Parámetros de trabajo

Tabla 12. Descripciones del parámetro createApplicationServer. Ejecute un mandato submitJob createApplicationServer con al menos los parámetros serverName y nodeName.
Parámetro Descripción Tipo
serverName Especifica el nombre del servidor de aplicaciones que se va a crear. El nombre del servidor debe ser exclusivo en el nodo de destino. Serie
nodeName Cuando el destino es una célula de WebSphere Application Server, Network Deployment, debe especificar el nombre de nodo para indicar en qué nodo de la célula se ha de crear el servidor. No tiene que especificar el nombre de nodo para un nodo base. Serie
templateName Opcionalmente especifica la plantilla del servidor. Serie
templateLocation Opcionalmente, especifica la ubicación donde se guarda la plantilla. Utilice el valor predeterminado, la ubicación definida por el sistema a menos que deba especifica r la ubicación de la plantilla. Serie
genUniquePorts Opcionalmente, especifica que se han de generar puertos http para un servidor. De forma predeterminada, el producto genera números de puerto exclusivos. Booleano
[z/OS]specificShortName [z/OS]Únicamente para entornos z/OS, especifica opcionalmente el nombre abreviado específico del servidor. Cada servidor debe tener un nombre abreviado específico y exclusivo. De forma predeterminada, el producto asigna un nombre abreviado específico y exclusivo. El valor debe tener 8 caracteres y todos en mayúsculas. [z/OS]Serie
[z/OS]genericShortName [z/OS]Únicamente para entornos z/OS, especifica opcionalmente el nombre abreviado genérico del servidor. Todos los miembros de un clúster comparten el mismo nombre abreviado genérico. Cada servidor debe tener un nombre abreviado genérico y exclusivo. De forma predeterminada, el producto asigna un nombre abreviado genérico y exclusivo. El valor debe tener 8 caracteres y todos en mayúsculas. [z/OS]Serie
[z/OS]bitMode [z/OS]Únicamente para entornos z/OS, especifica opcionalmente la modalidad de bits del servidor. Los valores válidos son 31 y 64 bits. Si no se proporciona un valor, el producto asigna la modalidad de bits predeterminada. [z/OS]Entero

Ejemplo de uso

AdminTask.submitJob('-jobType crear_servidor_aplicaciones -targetList
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

deleteApplicationServer

El trabajo administrativo deleteApplicationServer elimina un servidor de aplicaciones del entorno de destino.

Parámetros de trabajo

Tabla 13. Descripciones del parámetro deleteApplicationServer. Ejecute un mandato submitJob deleteApplicationServer con los parámetros serverName y nodeName.
Parámetro Descripción Tipo
serverName Especifica el nombre del servidor de aplicaciones que se va a suprimir. Serie
nodeName Cuando el destino es una célula de WebSphere Application Server, Network Deployment, debe especificar el nombre de nodo para indicar de qué nodo de la célula se ha de suprimir el servidor. No tiene que especificar el nombre de nodo para un nodo base. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType suprimir_servidor_aplicaciones -targetList
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

createProxyServer

El trabajo administrativo createProxyServer crea un servidor proxy en la célula de un gestor de despliegue que es un destino gestionado de un gestor de trabajos.

Parámetros de trabajo

Tabla 14. Descripciones del parámetro createProxyServer. Ejecute un mandato submitJob createProxyServer con los parámetros serverName y nodeName.
Parámetro Descripción Tipo
serverName Especifica el nombre del servidor proxy que debe crearse. Serie
nodeName Especifica el nodo en el que residirá el servidor proxy. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType createProxyServer -jobParams [[nombre_servidor
 testServer1][nodeName testNode1]] ]')

deleteProxyServer

deleteProxyServer suprime un servidor proxy de una célula de un gestor de despliegue que es un destino gestionado de un gestor de trabajos.

Parámetros de trabajo

Tabla 15. Descripciones del parámetro deleteProxyServer. Ejecute un mandato submitJob deleteProxyServer con los parámetros serverName y nodeName.
Parámetro Descripción Tipo
serverName Especifica el nombre del servidor proxy que debe suprimirse. Serie
nodeName Especifica el nodo en el que reside el servidor proxy. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType deleteProxyServer -jobParams [[nombre_servidor
 testServer1][nodeName testNode1]] ]')

createCluster

El trabajo administrativo createCluster crea u clúster. Para crear un clúster en una célula, debe registrar el gestor de despliegue de la célula en un gestor de trabajos.

Parámetros de trabajo

Tabla 16. Descripciones del parámetro createCluster. Ejecute un mandato submitJob createCluster con al menos el parámetro clusterConfig.clusterName.
Parámetro Descripción Tipo
clusterConfig.clusterName Especifica el nombre del clúster de servidores. Serie
clusterConfig.preferLocal Opcionalmente habilita la optimización de direccionamiento con ámbito de nodo para el clúster. Serie
clusterConfig.clusterType Opcionalmente especifica el tipo de clúster de servidores. Serie
[z/OS]clusterConfig.shortName [z/OS]Opcionalmente especifica el nombre corto del clúster de servidores. [z/OS]Serie
replicationDomain.createDomain Opcionalmente crea un dominio de réplica cuyo nombre está establecido en el nombre del nuevo clúster. Serie
convertServer.serverNode Opcionalmente especifica el nombre del nodo del servidor existente que debe convertirse en el primer miembro del clúster. Serie
convertServer.serverName Opcionalmente especifica el nombre del servidor existente que debe convertirse en el primer miembro del clúster. Serie
convertServer.memberWeight Opcionalmente especifica el valor de peso del nuevo miembro del clúster. Serie
convertServer.nodeGroup Opcionalmente especifica el nombre del grupo de nodos al que deben pertenecer todos los nodos miembros del clúster. Serie
convertServer.replicatorEntry Opcionalmente especifica que se crea una entrada de replicador para este miembro en el dominio de réplica del clúster. La entrada de replicador se utiliza para la réplica de datos de sesión HTTP. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterConfig.clusterName newCluster1]]')

Si especifica parámetros adicionales en el mandato createCluster, utilice el formato [nombrePaso.nombreParámetro valorParámetro] en la lista de parámetros -jobParams.

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterConfig.clusterName newCluster1] [clusterConfig.clusterType PROXY_SERVER] ]]')

deleteCluster

El trabajo administrativo deleteCluster suprime un clúster. Para suprimir un clúster de una célula, debe registrar el gestor de despliegue de la célula en un gestor de trabajos.

Parámetros de trabajo

Tabla 17. Descripciones del parámetro deleteCluster. Ejecute un mandato submitJob deleteCluster con al menos el parámetro ClusterName.
Parámetro Descripción Tipo
clusterName Especifica el nombre del clúster de servidores que debe suprimirse. Serie
replicationDomain.deleteRepDomain Opcionalmente se utiliza para indicar que el dominio de réplica del clúster se va a suprimir cuando se suprima el clúster. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType suprimirClúster -targetList [DmgrManagedNodeName]
 -jobParams [ [clusterName newCluster1] [replicationDomain.deleteRepDomain true] ]]')

createClusterMember

El trabajo administrativo createClusterMember crea un miembro de clúster en un clúster que se encuentra en una célula. Debe registrar el gestor de despliegue de la célula con un gestor de trabajos.

Parámetros de trabajo

Tabla 18. Descripciones del parámetro createClusterMember. Ejecute un mandato submitJob createClusterMember con al menos los parámetros clusterName, memberConfig.memberNode y memberConfig.memberName.
Parámetro Descripción Tipo
clusterName Especifica el nombre del clúster de servidores al que pertenece el nuevo miembro del clúster. Serie
memberConfig.memberNode Especifica el nombre del nodo en el que debe residir el nuevo miembro del clúster. Serie
memberConfig.memberName Especifica el nombre del nuevo miembro del clúster. Serie
memberConfig.memberWeight Opcionalmente especifica el peso del nuevo miembro del clúster. Serie
memberConfig.memberUUID Opcionalmente especifica el identificador único universal (UUID) del nuevo miembro del clúster. Serie
memberConfig.genUniquePorts Opcionalmente especifica que deben generarse números de puerto exclusivos para los transportes HTTP definidos en el servidor. Serie
memberConfig.replicatorEntry Opcionalmente especifica que se crea una entrada de replicador para este miembro en el dominio de réplica del clúster. La entrada de replicador se utiliza para la réplica de datos de sesión HTTP. Serie
[z/OS]memberConfig.specificShortName [z/OS]Opcionalmente especifica el nombre corto del miembro del clúster. [z/OS]Serie
firstMember.templateName Opcionalmente especifica el nombre de la plantilla de servidor de aplicaciones que debe utilizarse como modelo para los nuevos miembros del clúster. Serie
firstMember.templateServerNode Opcionalmente especifica el nombre del nodo de un servidor existente que debe utilizarse como plantilla para los nuevos miembros del clúster. Serie
firstMember.templateServerName Opcionalmente especifica el nombre del servidor que debe utilizarse como modelo para los nuevos miembros del clúster. Serie
firstMember.nodeGroup Opcionalmente especifica el nombre del grupo de nodos al que deben pertenecer todos los nodos miembros del clúster. Serie
firstMember.coreGroup Opcionalmente especifica el nombre del grupo núcleo al que deben pertenecer todos los miembros del clúster. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType createClusterMember
 -targetList [DmgrManagedNodeName]
 -jobParams [ [memberConfig.memberName newCluster1mem1]
   [memberConfig.memberNode FederatedNode] [clusterName newCluster1] ]]')

deleteClusterMember

El trabajo administrativo deleteClusterMember suprime un miembro de clúster de un clúster que se encuentra en una célula. Debe registrar el gestor de despliegue de la célula con un gestor de trabajos. El clúster debe tener como mínimo un clúster en un nodo federado.

Parámetros de trabajo

Tabla 19. Descripciones del parámetro deleteClusterMember. Ejecute un mandato submitJob deleteClusterMember con al menos los parámetros clusterName, memberNode y memberName.
Parámetro Descripción Tipo
clusterName Especifica el nombre de un clúster de servidor al que pertenece el miembro del clúster que debe suprimirse. Serie
memberNode Especifica el nombre del nodo en el que reside el miembro del clúster. Serie
memberName Especifica el nombre de servidor del miembro del clúster que debe suprimirse. Serie
replicatorEntry.deleteEntry Opcionalmente especifica que debe suprimirse del dominio de réplica del clúster la entrada de replicador que tiene el nombre de servidor de este miembro del clúster. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType deleteClusterMember -targetList 
 [DmgrManagedNodeName] -jobParams [ [memberName newCluster1mem1]
 [memberNode FederatedNode] [clusterName newCluster1] ]]')

configureProperties

El trabajo administrativo configureProperties aplica un archivo de propiedades a la configuración del servidor de aplicaciones. Este trabajo utiliza el mandato applyConfigProperties del grupo de mandatos PropertiesBasedConfiguration para el objeto AdminTask para configurar las propiedades para el destino.

Parámetros de trabajo

Tabla 20. Descripciones del parámetro configureProperties. Ejecute un mandato submitJob configureProperties con al menos el parámetro propertiesFileLocation.
Parámetro Descripción Tipo
propertiesFileLocation Especifica la ubicación del archivo de propiedades que se va a aplicar al servidor de aplicaciones especificado.

La vía de acceso especificada en este parámetro es la vía de acceso relativa del directorio raíz_perfil/downloadedContent del gestor de despliegue. Debe crear este directorio si todavía no existe, antes de iniciar el trabajo administrativo configureProperties.

Serie
variableMapLocation Especifica de forma opcional la ubicación de un archivo de correlaciones de variable que se va a incluir con el archivo de propiedades. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType configureProperties -targetList 
 [Target1 Target2 Target3] -jobParams [propertiesFileLocation  myProperties.props]')

Envío de trabajos para gestionar el tiempo de ejecución del servidor

El administrador del sistema puede utilizar los trabajos de control del tiempo de ejecución del servidor de aplicaciones para iniciar y detener los servidores de aplicaciones.

startServer

El trabajo administrativo startServer lanza e inicializa el servidor de aplicaciones de interés.

Parámetros de trabajo

Tabla 21. Descripciones del parámetro startServer. Ejecute un mandato submitJob startServer con al menos el parámetro serverName.
Parámetro Descripción Tipo
serverName Especifica el servidor de aplicaciones que se va a iniciar. Serie
nodeName Si el destino del trabajo es un nodo del gestor de despliegue, especifique el nombre del nodo federado donde existe el servidor. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType startServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

stopServer

El trabajo administrativo stopServer detiene el servidor de aplicaciones de interés. Utilice el trabajo startServer para reiniciar el servidor de aplicaciones.

Parámetros de trabajo

Tabla 22. Descripciones del parámetro stopServer. Ejecute un mandato submitJob stopServer con al menos el parámetro serverName.
Parámetro Descripción Tipo
serverName Especifica el servidor de aplicaciones que se va a detener. Serie
nodeName Si el destino del trabajo es un nodo del gestor de despliegue, especifique el nombre del nodo federado donde existe el servidor. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType stopServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

startCluster

El trabajo administrativo startCluster inicia un clúster. Para iniciar un clúster en una célula, debe registrar el gestor de despliegue de la célula en un gestor de trabajos.

Parámetros de trabajo

Tabla 23. Descripciones de los parámetros de startCluster. Ejecute un mandato submitJob startCluster con al menos el parámetro clusterName.
Parámetro Descripción Tipo
clusterName Especifica el nombre del clúster que debe iniciarse. Serie
rippleStart Opcionalmente especifica si el clúster se inicia en un de forma escalonada. El valor predeterminado es false. Serie

Ejemplo de uso

El ejemplo siguiente inicia un clúster:

AdminTask.submitJob('[-jobType startCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

El ejemplo siguiente inicia un clúster de forma escalonada.

AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterName newCluster1] [rippleStart true] ]]')

stopCluster

El trabajo administrativo stopCluster detiene un clúster. Para detener un clúster en una célula, debe registrar el gestor de despliegue de la célula en un gestor de trabajos.

Parámetros de trabajo

Tabla 24. Descripción del parámetro stopCluster. Ejecute un mandato submitJob stopCluster con al menos el parámetro clusterName.
Parámetro Descripción Tipo
clusterName Especifica el nombre del clúster que debe detenerse. Serie

Ejemplo de uso

AdminTask.submitJob('[-jobType stopCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

Someter un trabajo para ejecutar mandatos

El administrador del sistema puede utilizar el trabajo runCommand del gestor de trabajos para ejecutar un mandato en un host remoto. El mandato puede ser un programa de utilidad de la línea de mandatos como startServer en un directorio raíz_servidor_aplicaciones/bin, un mandato wsadmin o un mandato de sistema operativo.

Parámetros de trabajo

Tabla 25. Descripciones de los parámetros de runCommand. Ejecute un mandato submitJob runCommand con al menos el parámetro command.
Parámetro Descripción Tipo
mandato Especifica el nombre del mandato que debe ejecutarse. Serie
workingDir Especifica la ubicación del archivo de mandatos en el host remoto. El valor predeterminado es el directorio raíz_servidor_aplicaciones en el host remoto. Serie

Ejemplo de uso

[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command versionInfo.bat]]')
[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "java -version"][workingDir C:/WAS_v800/IBM/WebSphere/AppServer/java/bin]]')

Someter un trabajo para gestionar perfiles

El administrador del sistema puede utilizar el trabajo manageprofiles del gestor de trabajos para crear, aumentar, o suprimir un perfil de WebSphere Application Server. Este trabajo ejecuta el mandato administrativo manageprofiles.

Parámetros de trabajo

Tabla 26. Descripciones de los parámetros de manageprofiles. Ejecute un mandato submitJob manageprofiles con al menos los parámetros wasHome y responseFile.
Parámetro Descripción Tipo
wasHome Especifica la ubicación de la instalación de WebSphere Application Server. Es la vía de acceso raíz_servidor_aplic en el host remoto. Serie
responseFile Especifica la ubicación del archivo de respuestas de manageprofiles que reside en el gestor de trabajos. Serie
nombre de usuario Especifica el nombre de usuario que se ha utilizar en los destinos cuando se ejecuta el trabajo. Si el nombre de usuario y la contraseña no se especifican, y la seguridad está habilitada, se utiliza el ID de usuario del gestor de trabajos. Serie
password Especifica la contraseña del nombre de usuario que se ha utilizar en los destinos cuando se ejecuta el trabajo. Si el nombre de usuario y la contraseña no se especifican, y la seguridad está habilitada, se utiliza el ID de usuario del gestor de trabajos. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType manageprofiles -targetList Target1 -username user1 -password *******
 -jobParams [[wasHome /WAS80GA][responseFile /temp/mp1.txt]]')

Someter trabajos de Installation Manager

El administrador del sistema puede utilizar trabajos de Installation Manager para instalar instancias de Installation Manager, actualizar Installation Manager con un repositorio, gestionar ofertas de Installation Manager e instalar productos WebSphere Application Server.

Supported configurations Supported configurations: Se necesita IBM Installation Manager 1.4.3 o posterior.sptcfg

installIM

El trabajo administrativo installIM instala una nueva instancia de Installation Manager enviando un kit de instalación desde el gestor de trabajos a los hosts.

Parámetros de trabajo

Tabla 27. Descripciones de los parámetros de installIM. Ejecute un mandato submitJob installIM con al menos el parámetro kitPath.
Parámetro Descripción Tipo
kitPath Especifica la ubicación del kit de Installation Manager. Si no especifica este parámetro, el trabajo busca el kit de instalación de la más reciente en la ubicación predeterminada. Serie
dataPath Especifica la ubicación de los datos de Installation Manager. Serie
installPath Especifica la ubicación para instalar Installation Manager en el host de destino. Especifique este parámetro sólo si hay varias ubicaciones de instalaciones dentro de la célula actual en el mismo sistema host. Serie
skipPrereqCheck Cuando se establece en true, opcionalmente especifica que no se realiza ninguna comprobación de requisitos previos al instalar Installation Manager y que la comprobación de espacio de disco de Installation Manager se inhabilita.

El valor predeterminado es false. La comprobación de requisitos previos y de espacio de disco se realiza a menos que se especifique el valor true.

Booleano
acceptLicense Se debe establecer en true, si no especifica este parámetro, el trabajo fallará. Booleano

Ejemplo de uso

AdminTask.submitJob('-jobType installIM -targetList [Host1 Host2 Host3] 
 -jobParams [acceptLicense TRUE] [kitPath /IM/agent.installer.zip] -username user1 -password pw')

Si no especifica la vía de acceso del kit de instalación de IBM Installation Manager, el trabajo installIM buscará el kit de instalación de IBM Installation Manager más reciente que sea adecuado para la plataforma de destino desde el repositorio del kit de instalación del gestor de trabajos. De forma predeterminada, el repositorio del kit de instalación es raíz_servidor_aplic/IMKits. Puede cambiar la ubicación del gestor de trabajos. Pulse Trabajos > Kits de instalación de Installation Manager y, a continuación, cambie Ubicación de los kits de instalación de Installation Manager en una ubicación distinta.

updateIM

El trabajo administrativo updateIM actualiza un Installation Manager existente con un repositorio, en lugar de enviar un kit de instalación desde el gestor de trabajos. Este mandato updateIM requiere Installation Manager Versión 1.4 o posterior.

Parámetros de trabajo

Tabla 28. Descripciones de los parámetros de updateIM. Ejecute un mandato submitJob updateIM con al menos los parámetros repository e installPath.
Parámetro Descripción Tipo
repository Especifica la ubicación del repositorio para actualizar Installation Manager. La vía de acceso puede ser un archivo local del sistema del gestor de trabajo o un URL que apunte a un archivo remoto. Serie
installPath Especifica la ubicación de la instalación de Installation Manager. Serie
keyringFile Si el repositorio de la oferta que se especifica en el archivo de respuestas requiere que se inicie sesión, especifica la ubicación del archivo de conjunto de claves que se debe utilizar. Si el repositorio no requiere que se inicie sesión, no especifique este parámetro. Serie
keyringPassword Opcionalmente, especifica la contraseña para el archivo de conjunto de claves. Si el archivo de claves no requiere una contraseña, no especifique este parámetro. Serie
acceptLicense Se debe establecer en true, si no especifica este parámetro, el trabajo fallará. Booleano

Ejemplo de uso

AdminTask.submitJob('-jobType updateIM -targetList [Host1] 
 -jobParams [acceptLicense TRUE][ [repository /IM/repository] [installPath /IM] ]')

manageOfferings

El trabajo administrativo manageOfferings puede instalar, actualizar, modificar, retrotraer o desinstalar ofertas en Installation Manager. Someta un trabajo que utilice un archivo de respuestas de Installation Manager y, opcionalmente un archivo de conjunto de claves, para gestionar una oferta utilizando un repositorio remoto.

Avoid trouble Avoid trouble: De forma predeterminada, el trabajo obliga a la ubicación de datos especificada que sea una vía de acceso absoluta.
  • [Windows]La vía de acceso debe comenzar con una letra de unidad.
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]La vía de acceso debe comenzar con /.
Para eliminar esta restricción, establezca la propiedad Java siguiente en true: com.ibm.ws.admin.cimjm.disabledatalocationabsolutepathcheck=true. gotcha

Parámetros de trabajo

Tabla 29. Descripciones de los parámetros de manageOfferings. Ejecute un mandato submitJob manageOfferings con al menos el parámetro responseFile.
Parámetro Descripción Tipo
responseFile Especifica la ubicación del archivo de respuestas para actualizar, modificar, retrotraer o desinstalar ofertas de Installation Manager. La vía de acceso puede ser un archivo local del sistema del gestor de trabajo o un URL que apunte a un archivo remoto. Serie
IMPath Especifica la ubicación de la instalación de Installation Manager. Si este parámetro no se especifica, el trabajo intenta descubrir y utilizar la vía de acceso del Installation Manager predeterminado en el host de destino. Si se encuentra ningún Installation Manager o se encuentra más de un Installation Manager, el trabajo fallará. En esta situación, el mandato manageOfferings submitJob debe especificar la vía de acceso de Installation Manager. Serie
keyringFile Especifica la ubicación del archivo de conjunto de claves que se debe utilizar si el repositorio de la oferta que se especifica en el archivo de respuestas requiere que se inicie sesión. Si el archivo de respuestas no requiere que se inicie sesión, no especifique este parámetro. Serie
keyringPassword Opcionalmente, especifica la contraseña para el archivo de conjunto de claves. Si el archivo de claves no requiere una contraseña, no especifique este parámetro. Serie

Ejemplo de uso

AdminTask.submitJob('-jobType manageOfferings -targetList [Host1 Host2 Host3] 
 -jobParams [responseFile /IM/agent.installer.zip] -username user1 -password pw')

findIMDataLocation

El trabajo administrativo findIMDataLocation puede añadir o buscar ubicaciones da datos de Installation Manager.

Si una vía de acceso contiene un punto y coma (;), escriba la vía de acceso entre comillas ("). Por ejemplo: "/opt/my,path";/opt/data1. El trabajo puede detectar ubicaciones de datos registrados en el registro de Installation Manager. En plataformas Unix, el registro predeterminado para una instalación no administrativa se encuentra en userhome/etc/.ibm/registry. El registro predeterminado para una instalación administrativa se encuentra en /etc/.ibm/registry. No es necesario añadir ubicaciones de datos que se registran en el registro predeterminado. El trabajo lleva a cabo los pasos siguientes:
  • Valida las ubicaciones de datos especificadas en el campo Ubicaciones de datos de IM adicionales y las ubicaciones de datos encontradas en el trabajo durante la búsqueda (si la opción de buscar en el sistema está establecida en true)
  • Añade las ubicaciones de datos válidas a la lista existente de ubicaciones de datos para un uso futuro
  • Elimina las ubicaciones de datos duplicadas
  • Ejecuta el trabajo de inventario
Cuando se termina el trabajo, el inventario para el destino es el actual.

Parámetros de trabajo

Tabla 30. Descripciones del parámetro findIMDataLocation. Ejecute un mandato findIMDataLocation de submitJob con al menos el parámetro responseFile. Puede especificar los parámetros searchSystem y dataLocations simultáneamente.
Parámetro Descripción Tipo
targetList Especifica la ubicación de los sistema de destino del trabajo. Serie
searchSystem Especifica el CIM para buscar en todo el sistema de destino las ubicaciones de los datos de Installation Manager. Serie
dataLocations Especifica la ubicación de datos utilizables de Installation Manager. El trabajo sólo lista ubicaciones de datos de Installation Manager que se pueden utilizar para el usuario de destino actual que está registrado en la consola de administración. Serie

Ejemplo de uso

AdminTask.submitJob ('[-jobType findDataLocation -targetList targetList -jobParams [[searchSystem true] 
[datalocations vía_acceso_a_ubicaciones_datos_separada_por_punto_y_coma]  ]]')

Cómo someter trabajos de Liberty

Puede someter trabajos para instalar y desinstalar recursos de Liberty y para iniciar y detener servidores de Liberty. Un servidor de Liberty es una forma rápida de iniciar un servidor de aplicaciones dinámico al que puede añadir fácilmente características y administrarlo editando los archivos de configuración XML.

Una instalación de Liberty requiere que un kit de desarrollo Java (JDK) o un entorno de ejecución Java (JRE) ejecuten trabajos que inicien o detengan el servidor. Establezca la ubicación de JDK o JRE realizando una de las siguientes acciones:
  • Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE en el archivo server.env . El trabajo lee la propiedad JAVA_HOME y la establece en el entorno de destino antes de ejecutar el mandato para iniciar o detener el servidor. Sin embargo, esta propiedad no se utiliza en el mandato del servidor de Liberty si se inicia o detiene el servidor manualmente.

    [z/OS]El archivo server.env debe estar en codificación EBCDIC.

  • [AIX][HP-UX][Linux][Solaris][z/OS]Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE en el archivo .bashrc del usuario.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Añada la vía de acceso de JDK o JRE a la variable de entorno PATH.
  • [Windows]Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE como una variable de entorno de sistema.
  • [Windows]Añada la vía de acceso de JDK o JRE a la variable de sistema PATH.

Si JAVA_HOME no se especifica en server.env o en el entorno del usuario, el gestor de trabajo busca el JDK o JRE en la vía de búsqueda de usuario.

installLibertyProfileResources

El trabajo installLibertyProfileResources extrae recursos de una imagen de Liberty en directorios de destino relacionados con el directorio raíz. Antes de ejecutar este trabajo, deben existir las condiciones siguientes:

  • Se debe haber registrado un sistema principal (host) con el gestor de trabajos.
  • La imagen, un archivo comprimido zip, debe contener recursos de Liberty en una estructura de directorios que cumpla las reglas del gestor de trabajos. Consulte cómo empaquetar recursos de Liberty.
  • Se debe haber definido el directorio raíz para instalar los recursos en el host de destino. Al menos, establezca la variable WLP_WORKING_DIR en un directorio válido que esté en un host de destino. Para instalar los recursos en un directorio compartido del host de destino, debe establecer la variable WLP_SHARED_DIR en un directorio válido. Consulte cómo establecer variables para servidores de Liberty.

Durante el despliegue de los recursos, el producto aplica la sustitución de variable al archivo bootstrap.properties de cada servidor de Liberty.

[z/OS]El archivo server.env debe estar en codificación EBCDIC.

El trabajo extrae la imagen del host de destino intentando los siguientes métodos en secuencia:
  • Utilice el programa de utilidad unzip en el host.
  • Utilice el programa de utilidad jar en el host, incluyendo el programa de utilidad jar desde un kit de desarrollo de software (SDK) que ha encontrado un trabajo de inventario.
  • [Windows]Utilice el programa de utilidad unzip que se copia al host remoto mientras dure el trabajo, si el administrador no lo ha inhabilitado específicamente. El programa de utilidad unzip se suprime después de completar el trabajo.
  • Desempaquete el archivo zip en el gestor de trabajos y copie los archivos de uno en uno en el host de destino. Este método se aplica sólo si la imagen del servidor de Liberty reside en el gestor de trabajos.

El trabajo no consigue instalar un recurso si la instancia de recursos ya existe en un directorio de destino.

Parámetros de trabajo

Tabla 31. Descripciones del parámetro installLibertyProfileResources. Ejecute un mandato submitJob installLibertyProfileResources con al menos el parámetro image o url.
Parámetro Descripción Tipo
image Si el archivo comprimido que proporciona la imagen de Liberty reside en un host del gestor de trabajos, especifica el nombre completo de la vía de acceso del archivo comprimido; por ejemplo:
[AIX][HP-UX][Linux][Solaris]
/resources/my_liberty_server.zip
[Windows]
c:/resources/my_liberty_server.zip
Serie
url Si el archivo comprimido que proporciona los recursos de Liberty no reside en un host del gestor de trabajos, especifica la vía de acceso del URL del archivo comprimido. Los nombres de esquema admitidos para el URL (ubicador de recursos universal) son http, https, ftp y file.
Restricción: Para especificar un protocolo de URL que no sea archivo, el host de destino debe tener un programa de utilidad wget. Seleccione un protocolo de descarga remoto http, https o ftp admitido por el programa de utilidad wget del host de destino. Si el programa de utilidad wget no da soporte al protocolo seleccionado, el trabajo no podrá instalar los recursos.

Por ejemplo, especifique uno de los siguientes URL para los archivos de recursos, my_liberty_server.zip.

Si los recursos del servidor de Liberty residen en un servidor HTTP o HTTPS:

http://www.mycompany.com/resources/my_liberty_server.zip

https://www.mycompany.com/resources/my_liberty_server.zip

Si los recursos residen en un servidor FTP:

ftp://www.mycompany.com/resources/my_liberty_server.zip

Si los recursos residen en el sistema host de destino, el URL puede utilizar el esquema de archivo para describir la vía de acceso y el nombre del archivo comprimido:

[AIX][HP-UX][Linux][Solaris]
file:///resources/my_liberty_server.zip
[Windows]
file://c:/resources/my_liberty_server.zip

Si el URL está protegido con contraseña, también deberá especificar los valores de urluser y urlpassword.

Serie
share Especifica si se deben instalar los recursos de Liberty en un directorio compartido. Cuando se establece en true, los recursos se instalan en la ubicación definida por la variable WLP_SHARED_DIR. Si no está definida la variable WLP_SHARED_DIR o no especifica un directorio válido, el producto devolverá un error y no extraerá recursos de la imagen.

Cuando se establece en false, el valor predeterminado, el trabajo instala los recursos en la ubicación que se ha definido mediante la variable WLP_WORKING_DIR.

Booleano
urluser Especifica un nombre de usuario para el URL. Si ha especificado un URL y el URL está protegido con contraseña, debe especificar un nombre de usuario. De lo contrario, no proporcione ningún valor para urluser. Serie
urlpassword Especifica una contraseña que permite que urluser acceda URL. Si ha especificado un URL y el URL está protegido con contraseña, debe especificar una contraseña. De lo contrario, no proporcione ningún valor para urlpassword. Serie

Ejemplo de uso

El siguiente ejemplo tiene la imagen en el mismo host que el gestor de trabajos y se instala en WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
 -description installLibertyProfileResources
 -jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
El ejemplo siguiente tiene la imagen en el mismo host de destino, especifica un URL de archivo para la imagen y se instala en WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
 -description installLibertyProfileResources
 -jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
El siguiente ejemplo tiene la imagen en servidor ftp remoto y protegido con contraseña, y se instala en WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword contraseña_ftp] [url ftp://www.mycompany.com/projects/liberty/image-0111003.zip]
     [share FALSE] [urluser usuario_ftp] ]]')
El siguiente ejemplo tiene la imagen en servidor http remoto y protegido con contraseña, y se instala en WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword contraseña_http] [url http://www.mycompany.com/projects/liberty/image-0111003.zip]
    [share FALSE] [urluser usuario_http] ]]')
El siguiente ejemplo tiene la imagen en servidor https remoto y protegido con contraseña, y se instala en WLP_SHARED_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
 -description installLibertyProfileResources
 -jobParams [ [urlpassword contraseña_http] [url https://www.mycompany.com/projects/liberty/image-0111003.zip]
    [share TRUE] [urluser usuario_http] ]]')

uninstallLibertyProfileResources

El trabajo uninstallLibertyProfileResources elimina un recurso de administración del gestor de trabajos. El recurso fue instalado anteriormente en un directorio de destino en el host por parte del trabajo installLibertyProfileResources o, después de una instalación manual descomprimiendo una imagen de Liberty, el trabajo de inventario lo encontró.

El producto devuelve un error y no elimina el recurso si se da alguna de las siguientes condiciones:
  • El mandato especifica más de un tipo de recurso para eliminarlo.
  • El nombre de recurso se resuelve en más de un recurso del mismo nombre.
  • El recurso no existe en un directorio al que el gestor de trabajos puede acceder y realizar búsquedas.
Avoid trouble Avoid trouble: Si el trabajo falla, puede que sea porque se han suprimido algunos archivos. El recurso puede tener un estado corrupto. Si cambia manualmente los archivos de recursos para corregir el problema, después de modificar los archivos, ejecute un trabajo de inventario para actualizar el inventario. gotcha

Parámetros de trabajo

Tabla 32. Descripciones de parámetro uninstallLibertyProfileResources. Ejecute un mandato submitJob uninstallLibertyProfileResources sólo con un parámetro que identifica el recurso que se ha de eliminar.
Parámetro Descripción Tipo
projectName Especifica el nombre o el ID de recurso del proyecto que se ha de eliminar. El producto busca todos los servidores para el proyecto. Para cada servidor identificado que se esté ejecutando, el producto detiene el servidor antes de intentar eliminar el recurso. Serie
runtimeName Especifica el nombre o el ID de recurso del tiempo de ejecución de Liberty que se ha de eliminar. El producto busca en todos los servidores el tiempo de ejecución. Para cada servidor identificado que se esté ejecutando, el producto detiene el servidor antes de intentar eliminar el recurso. Serie
sdkName Especifica el nombre o el ID de recurso del kit de desarrollo de software (SDK) que se ha de eliminar. Serie
serverName Especifica el nombre o el ID de recurso del servidor que se ha de eliminar. Si se está ejecutando el servidor, el producto detiene el servidor antes de eliminar el recurso. Serie
applicationBinaryName Especifica el nombre o el ID de recurso del binario de la aplicación que se ha de eliminar. Serie
forceDelete De manera opcional, especifica si se suprimen recursos incluso si su estado no se puede detectar. El valor predeterminado es false, es decir, no suprimir recursos. Cuando el valor es true, los recursos del servidor se suprimen aunque el estado de los recursos de servidor no se pueda detectar o los servidores no se puedan detener. Si el estado de un servidor no se puede detectar, el trabajo uninstallLibertyProfileResources fallará a menos que esta opción forceDelete se haya especificado. Booleano

Ejemplo de uso

En el ejemplo siguiente se elimina el binario de aplicación DefaultWebApplication.war de la administración del gestor de trabajos:

AdminTask.submitJob('[-jobType uninstallLibertyProfileResources -targetList [nombre_host]
 -description uninstallLibertyProfileResources
 -jobParams [ [applicationBinaryName DefaultWebApplication.war] ]]')

startLibertyProfileServer

El trabajo startLibertyProfileServer inicia uno o varios recursos del servidor de Liberty. El estado del los recursos del servidor cambia de Detenido a Iniciado.

Un servidor de Liberty requiere que un kit de desarrollo Java (JDK) o un entorno de ejecución Java (JRE) ejecuten este trabajo. Establezca la ubicación de JDK o JRE realizando una de las siguientes acciones:
  • Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE en el archivo server.env . El trabajo lee la propiedad JAVA_HOME y la establece en el entorno de destino antes de ejecutar el mandato para iniciar el servidor. Sin embargo, esta propiedad no se utiliza en el mandato del servidor Liberty si se inicia el servidor manualmente.

    [z/OS]El archivo server.env debe estar en codificación EBCDIC.

  • [AIX][HP-UX][Linux][Solaris][z/OS]Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE en el archivo .bashrc del usuario.
  • [AIX][HP-UX][Linux][Solaris][z/OS]Añada la vía de acceso de JDK o JRE a la variable de entorno PATH.
  • [Windows]Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE como una variable de entorno de sistema.
  • [Windows]Añada la vía de acceso de JDK o JRE a la variable de sistema PATH.

Parámetros de trabajo

Tabla 33. Descripciones del parámetro startLibertyProfileServer . Ejecute un mandato submitJob startLibertyProfileServer con al menos el parámetro startResource.
Parámetro Descripción Tipo
startResource Especifica un nombre de vía de acceso del recurso del servidor de Liberty para su inicio. Serie

Ejemplo de uso

El ejemplo siguiente inicia el recurso del servidor de Liberty server1:

AdminTask.submitJob('-jobType startLibertyProfileServer -targetList host_name
 -description startLibertyProfileServer
 -jobParams [[startResource runtime/wlp/liberty_server/server1 ]]')

stopLibertyProfileServer

El trabajo stopLibertyProfileServer detiene uno o más recursos del servidor de Liberty que estén en ejecución. El estado de los recursos del servidor cambia de Iniciado a Detenido.

Un servidor de Liberty requiere que un kit de desarrollo Java (JDK) o un entorno de ejecución Java (JRE) ejecuten este trabajo. Asegúrese de que la ubicación de JDK o JRE está establecida en el destino. Para obtener información sobre cómo establecer una ubicación de JDK o JRE, consulte startLibertyProfileServer.

Parámetros de trabajo

Tabla 34. Descripciones del parámetro stopLibertyProfileServer. Ejecute un mandato submitJob stopLibertyProfileServer con al menos el parámetro stopResource.
Parámetro Descripción Tipo
stopResource Especifica un nombre de vía de acceso del recurso del servidor de Liberty para su detención. Serie

Ejemplo de uso

En el ejemplo siguiente se detiene el recurso del servidor de Liberty:

AdminTask.submitJob('-jobType stopLibertyProfileServer -targetList host_name
 -description stopLibertyProfileServer
 -jobParams [[stopResource project/proj1/runtime/wlp/liberty_server/defaultServer]]')

generateMergedPluginConfigForLibertyProfileServers

El trabajo generateMergedPluginConfigForLibertyProfileServers crea un único archivo plugin-cfg.xml mediante la fusión de todos los archivos plugin-cfg.xml que se hayan generado para el servidor de Liberty en los hosts de destino.

Para este trabajo, puede especificar un servidor de Liberty en varios sistemas principales de destino. Después de que el servidor de Liberty se encuentre, se genera un archivo plugin-cfg.xml en dicho servidor y, a continuación, se vuelven a copiar en el gestor de trabajos. Cuando todos los archivos plugin-cfg.xml se han generado para todos los servidores de Liberty de destino, se fusionan en un archivo plugin-cfg.xml . Este archivo fusionado se coloca en el directorio del gestor de trabajos raíz_servidor_aplicaciones/profiles/perfil_gestor_trabajos/config/temp/JobManager/ID_trabajo/_mergedPluginDir/.

Este trabajo requiere una conexión JMX con los servidores de Liberty en los sistemas principales de destino. Puede configurar la conexión JMX utilizando el conector local o el conector HTTP/REST. Especifique el nombre de la característica del conector en el archivo server.xml de los servidores de Liberty. El siguiente ejemplo muestra los nombres de característica en un archivo server.xml para los conectores locales y HTTP/REST:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Si utiliza el conector HTTP/REST, debe especificar un nombre de usuario y una contraseña para la conexión JMX al enviar el trabajo.
El trabajo se detiene y el producto devuelve un error si alguna de las condiciones siguientes existen:
  • Un servidor de Liberty de destino no se está ejecutando.
  • Ningún conector JMX está configurado para un servidor de Liberty de destino.
  • El mandato no especifica las credenciales válidas para una conexión JMX.

Parámetros de trabajo

Tabla 35. Descripciones de parámetro generateMergedPluginConfigForLibertyProfileServers. Ejecute un mandato submitJob generateMergedPluginConfigForLibertyProfileServers con los parámetros serverName y de conexión.
Parámetro Descripción Tipo
serverName Especifica el nombre o el ID de recurso del servidor para el que se deben generar archivos plugin-cfg.xml en los sistemas principales de destino. El servidor de Liberty debe estar en ejecución en los hosts de destino. Serie
jmxuser Especifica el nombre de usuario para una conexión JMX. Especifique este parámetro si utiliza el conector HTTP/REST para una conexión JMX. Serie
jmxpassword Especifica la contraseña para una conexión JMX. Especifique este parámetro si utiliza el conector HTTP/REST para una conexión JMX. Serie

Ejemplo de uso

El siguiente ejemplo genera un archivo plugin-cfg.xml fusionado para el servidor Liberty defaultServer en los hosts de destino, host1 y host2:

AdminTask.submitJob('[-jobType generateMergedPluginConfigForLibertyProfileServers
 -targetList [host1 host2] -description generateMergedPluginConfigForLibertyProfileServers
 -jobParams [[jmxpassword ********][serverName runtime/wlp/liberty_server/defaultServer][jmxuser c]]]') 

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_7jobtypes
File name: rxml_7jobtypes.html