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
- Someter un trabajo para recopilar inventario
- Someter un trabajo para recopilar el estado del destino
- Someter trabajos para gestionar archivos
- Someter un trabajo que ejecuta un script wsadmin
- Envío de trabajos para gestionar aplicaciones
- Envío de trabajos para gestionar servidores
- Envío de trabajos para gestionar el tiempo de ejecución del servidor
- Someter un trabajo para ejecutar mandatos
- Someter un trabajo para gestionar perfiles
- Someter trabajos de Installation Manager
- Cómo someter trabajos de Liberty
Parámetros comunes para todos los tipos de trabajo
- 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]')
- 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]](../images/iseries.gif)
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
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
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.

- 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.
- Escriba el mandato siguiente: mkdir JobManager
- Escriba el mandato siguiente: chown -R QEJBSVR JobManager
- Copie el archivo que se debe distribuir en el directorio JobManager.
- Desde la consola administrativa, envíe el trabajo distributeFile.
Parámetros de trabajo
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
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
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.
Parámetros de trabajo
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
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.
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.
Parámetros de trabajo
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
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
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 |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
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
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
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
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
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 |
![]() |
![]() |
![]() |
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
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
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 |
![]() |
![]() |
![]() |
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
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
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
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
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
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
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
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]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command versionInfo.bat]]')
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
![[Windows]](../images/windows.gif)
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
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.

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
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 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
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.

La vía de acceso debe comenzar con una letra de unidad.
La vía de acceso debe comenzar con /.
Parámetros de trabajo
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.
- 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
Parámetros de trabajo
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.
- 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.
El archivo server.env debe estar en codificación EBCDIC.
Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE en el archivo .bashrc del usuario.
Añada la vía de acceso de JDK o JRE a la variable de entorno PATH.
Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE como una variable de entorno de sistema.
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.
El archivo server.env debe estar en codificación EBCDIC.
- 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.
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
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: ![]() ![]() ![]() ![]()
![]()
|
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:
Si los recursos residen en un servidor FTP:
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: ![]() ![]() ![]() ![]()
![]()
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
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
-description installLibertyProfileResources
-jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [nombre_host]
-description installLibertyProfileResources
-jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
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] ]]')
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] ]]')
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 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.

Parámetros de trabajo
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.
- 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.
El archivo server.env debe estar en codificación EBCDIC.
Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE en el archivo .bashrc del usuario.
Añada la vía de acceso de JDK o JRE a la variable de entorno PATH.
Establezca la propiedad JAVA_HOME en la ubicación de JDK o JRE como una variable de entorno de sistema.
Añada la vía de acceso de JDK o JRE a la variable de sistema PATH.
Parámetros de trabajo
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
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/.
<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. - 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
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]]]')