Generación de una configuración de plug-in fusionada para servidores de Liberty utilizando el gestor de trabajos

Puede someter el trabajo Generar una configuración de plug-in fusionada para los servidores de perfiles Liberty para crear un único archivo plugin-cfg.xml fusionado que indica a un plug-in de servidor web que redireccione las solicitudes a varios servidores de aplicaciones que residen en varios hosts. El trabajo primero genera archivos plugin-cfg.xml específicos del servidor en cada host de destino. A continuación el trabajo fusiona los archivos plugin-cfg.xml específicos del servidor en un archivo plugin-cfg.xml en el host del gestor de trabajos.

Antes de empezar

Inicie el gestor de trabajos y los servidores Liberty en los hosts de destino.

Si necesita generar una configuración de plugin de servidor web para una instancia individual de un servidor de Liberty, consulte en la configuración de liberty cómo configurar Liberty con un plugin de servidor web.

Su ID en el gestor de trabajos debe estar autorizado por el rol de administrador o el rol de operador para poder someter trabajos.

Al registrar un host de destino con el gestor de trabajos, puede guardar información de seguridad del sistema operativo. Al someter un trabajo a uno o más destinos para los que no se ha guardado la información de seguridad, deberá especificar un nombre de usuario de sistema operativo autorizado así como una contraseña o información de clave pública-privada para el nombre de usuario. Las credenciales de seguridad deben ser válidas para todos los destinos de trabajo.

Este trabajo requiere una conexión JMX (Java™ Management Extensions) con los servidores de Liberty en los hosts de destino. Para configurar un servidor Liberty para dar soporte a conexiones JMX, añada la característica de conector local o la característica de conector HTTP/REST a su archivo server.xml. En el siguiente ejemplo se muestra la característica de conector local y la característica de conector HTTP/REST dentro del elemento del gestor de características de un archivo server.xml:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
Al someter un trabajo, si uno o más servidores de Liberty incluyen sólo la característica de conector HTTP/REST, debe especificar el nombre de usuario y la contraseña de un administrador de Liberty. El gestor de trabajos utiliza estas credenciales al establecer una conexión JMX con los servidores. Si todos los servidores incluyen la característica de conector local, no es necesario especificar un nombre de usuario y una contraseña.

Para obtener más información sobre la definición de administradores de servidor, consulte "Correlación del rol de administrador para Liberty."

Un servidor de Liberty requiere un kit de desarrollo Java (JDK) o un entorno de ejecución Java (JRE) para poder ejecutar 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 generar un archivo plugin-cfg.xml para el servidor Liberty.
  • [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.

Acerca de esta tarea

Puede utilizar la consola administrativa del gestor de trabajos o el gestor de despliegue para generar un único archivo plugin-cfg.xml fusionado que indica a un plug-in de servidor web que redireccione las solicitudes a varios servidores de Liberty que residan en varios hosts. Desde la consola, elija el trabajo Generar una configuración de plug-ins fusionada para los servidores Liberty, especifique los servidores y las opciones de trabajo, revise el resumen y someta el trabajo.

Los pasos describen cómo ejecutar el trabajo Generar una configuración de plug-ins fusionada para los servidores de perfiles Liberty utilizando la consola del gestor de trabajos o la consola del gestor de despliegue. En lugar de utilizar una consola, puede ejecutar el script de trabajo generateMergedPluginConfigForLibertyProfileServers del grupo de mandatos AdministrativeJobs. Consulte el tema sobre tipos de trabajos administrativos.

Procedimiento

  1. Pulse Trabajos > Someter en el árbol de navegación de la consola administrativa.
  2. Elija un trabajo para generar una configuración de plug-in de servidor web fusionada para varios servidores de Liberty.
    1. Seleccione el tipo de trabajo Generar una configuración de plug-ins fusionada para los servidores de perfiles Liberty en la lista.
    2. Opcionalmente especifique una descripción del trabajo.
    3. Pulse Siguiente.
  3. Elija los destinos del trabajo.
    1. Seleccione un grupo de destinos de la lista o seleccione Nombres de destino.

      En la lista de grupos de destino sólo aparecen los grupos de destinos que son válidos para el tipo de trabajo que ha seleccionado.

    2. Si ha seleccionado Nombres de destino, especifique un nombre de destino y pulse Añadir o pulse Buscar y especifique los destinos seleccionados en la página Buscar destinos.
    3. Si no ha elegido guardar la información de autenticación de seguridad al registrar los hosts de destino con el gestor de trabajos, especifique un nombre de usuario y una contraseña del sistema operativo o información de claves pública-privada para acceder a los hosts de destino. Las credenciales de seguridad deben ser válidas para todos los destinos de trabajos.
    4. Pulse Siguiente.
  4. Especifique parámetros para el trabajo Generar una configuración de plug-ins fusionada para los servidores de perfiles Liberty.
    1. Para Servidores, especifique el nombre de recurso del ID de recurso completo de un servidor, o un patrón que identifique uno o más servidores.

      Si un nombre de servidor se resuelve en más de un servidor del mismo nombre, el producto devuelve un error y no genera el archivo plugin-cfg.xml.

      Por ejemplo, suponga que desea especificar defaultServer para el servidor. Puede especificar uno de los valores siguientes para identificar el recurso de servidor:

      Nombre de recurso
      defaultServer
      ID de recurso completo
      runtime/wlp/liberty_server/defaultServer
      Patrón de nombre de recurso
      *Server
      Patrón de ID de recurso completo
      runtime/wlp/liberty_server/*

      Para ver los nombres de servidores de Liberty en los destinos, pulse Buscar en la página Especificar parámetros de trabajo. En la página Buscar recursos de destino, pulse Buscar para buscar un identificador de servidor de Liberty que exista en todos los hosts de destino. Seleccione el ID de recurso de servidor para el que generar una configuración de plug-in de servidor web fusionado.

    2. Si uno o más de los servidores incluyen sólo la característica de conector HTTP/REST (restConnector), para Nombre de usuario, especifique el nombre de usuario de un administrador de servidor de Liberty. El gestor de trabajos utiliza este valor al establecer una conexión JMX con los servidores.
    3. Si uno o más de los servidores incluyen sólo la característica de conector HTTP/REST (restConnector), para Contraseña, especifique la contraseña del administrador del servidor de Liberty. El gestor de trabajos utiliza este valor al establecer una conexión JMX con los servidores.
    4. Pulse Siguiente.
  5. Planifique el trabajo.

    Las fechas y horas que especifique son relativas al gestor de trabajos.

    1. También puede especificar una o varias direcciones de correo electrónico a las que enviar las notificaciones cuando el trabajo haya finalizado.

      Si especifica varias direcciones de correo electrónico, sepárelas con comas.

    2. Seleccione el momento en que el trabajo estará disponible para someterlo.
    3. Seleccione la caducidad del trabajo.
    4. Opcionalmente especifique un intervalo recurrente para el trabajo, una fecha y hora de inicio para el intervalo y una fecha y hora final para el intervalo.
    5. Pulse Siguiente.
  6. Revise el resumen y pulse Finalizar para someter el trabajo.

Resultados

Los archivos plugin-cfg.xml específicos del servidor se generan en cada host de destino. A continuación el gestor de trabajos fusiona los archivos en un único archivo plugin-cfg.xml fusionado en el host del gestor de trabajos.

Qué hacer a continuación

En la página Estado del trabajo, pulse el ID del trabajo Generar una configuración de plug-ins fusionada para los servidores de perfiles Liberty y vea el estado del trabajo. Pulse el icono de renovación de estado Especifica el icono de renovación de vista para el estado del trabajo para renovar el estado mostrado.

Si el trabajo es satisfactorio, el producto graba el archivo plugin-cfg.xml fusionado en el directorio raíz_servidor_aplicaciones/profiles/perfil_gestor_trabajos/config/temp/JobManager/ID_trabajo/_mergedPluginDir/.

Si el trabajo no es satisfactorio, el trabajo se detiene y el producto devuelve un error cuando existe alguna de las siguientes condiciones:
  • Un servidor de Liberty de destino no se está ejecutando.
  • Ningún conector JMX está configurado para un servidor de Liberty de destino.
  • Las propiedades de trabajo no especifican credenciales de administrador de servidor válidas para establecer una conexión JMX con un servidor de Liberty que incluye sólo la característica HTTP/REST (restConnector).
Consulte los mensajes de error que se han generado al ejecutar el trabajo, corrija la condición de error y someta el trabajo de nuevo.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_jobmgr_liberty_plugin_merge
File name: tagt_jobmgr_liberty_plugin_merge.html