Empaquetado de recursos de Liberty
Los recursos de Liberty pueden empaquetarse en uno o más archivos (.zip) comprimidos para su despliegue por el gestor de trabajos de WebSphere Application Server, Network Deployment Versión 9.0. La agrupación de los recursos dentro de archivos comprimidos afecta al ámbito y al uso compartido de los recursos. Para que los recursos de los archivos comprimidos se desplieguen correctamente, los nombres de vía de acceso de los recursos deben satisfacer las reglas del gestor de trabajos.
Antes de empezar
El tema "Empaquetado de un servidor de Liberty desde indicador de mandatos" describe cómo ejecutar el mandato package para crear un archivo comprimido que contenga un tiempo de ejecución de Liberty, archivos en el directorio de recursos compartidos, un servidor incorporado y toda las aplicaciones incorporadas en el servidor. Si desea desplegar una instalación Liberty de este tipo y no necesita colocar la instalación en un directorio de proyecto, considere utilizar el mandato package para crear el archivo comprimido. Para otros tipos de instalaciones de Liberty, debe crear manualmente uno o más archivos comprimidos.
Acerca de esta tarea
Los tipos de recursos de Liberty incluyen el proyecto, el tiempo de ejecución, el servidor de Liberty, el binario de aplicación y el kit de desarrollo de software (SDK). Para obtener más información, lea el tema que trata sobre "recursos de Liberty".
El gestor de trabajos distingue entre los distintos tipos de recursos de Liberty en un archivo comprimido utilizando las siguientes reglas:
Procedimiento
Determine el tipo de instalación de Liberty que necesita y cree uno o más archivos comprimidos (.zip) que contengan recursos de Liberty.
Ejemplo
- Este primer ejemplo muestra cómo empaquetar una instalación de Liberty autocontenida para su despliegue en uno o más hosts de servidor. Después ilustra cómo empaquetar una nueva versión de un servidor y la aplicación a los que se da soporte.
A continuación se muestra la estructura básica de los recursos de Liberty:
- Host de servidor
- Recursos de trabajo
- Proyecto
- Tiempo de ejecución de Liberty
- Servidor 1 de Liberty
- Binario de aplicación 1
- Servidor 2 de Liberty
- Binario de aplicación 2
- Servidor 1 de Liberty
- Tiempo de ejecución de Liberty
- Proyecto
- Recursos de trabajo
Las siguientes suposiciones se aplican para esta instalación de ejemplo:- Estructura cuando se despliega
- Esta instalación de Liberty ejemplo tiene la siguiente estructura de directorios en los hosts de servidor:
[-] liberty [-] working [-] samples [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] usr [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
- Estructura de paquete para el despliegue inicial
- Los siguientes directorios y archivos se incluyen en el archivo comprimido
(.zip) para el despliegue inicial de la instalación de Liberty. El directorio de
proyecto, samples, se encuentra en el directorio raíz del archivo comprimido.
[-] samples [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] usr [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
Si un servidor debe utilizar un SDK (JRE) que no es el valor predeterminado, debe especificar la ubicación del JRE adecuado en un archivo server.env a nivel de tiempo de ejecución o de servidor; por ejemplo:JAVA_HOME=/opt/jre-06.00.31
- Estructura del paquete que contiene una nueva versión de servidor y aplicación
- Los siguientes directorios y archivos se incluyen en un archivo comprimido
(.zip) para una nueva versión de un servidor y la aplicación a los que se da soporte. El directorio de
proyecto, samples, se encuentra en el directorio raíz del archivo comprimido.
[-] samples [-] wlp-08.05.00.00 [-] usr [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.01.war
- Host de servidor
- Este ejemplo primero ilustra cómo empaquetar los recursos de Liberty para un entorno donde cada host de servidor incluye una instancia compartida individual de un
SDK (JRE), una instancia compartida individual del tiempo de ejecución de Liberty y dos servidores de trabajo aislados que dependen del SDK compartido y el tiempo de ejecución compartido de Liberty. A continuación muestra cómo empaquetar una nueva versión de un servidor y la aplicación a la que da soporte. El uso del gestor de trabajos es obligatorio para entornos que incluyen servidores de Liberty aislados; no puede utilizar el script de servidor de Liberty para gestionar los servidores.
Para obtener información sobre el uso compartido de los valores de configuración de servidor a niveles de host y de red, consulte la documentación de Liberty sobre la utilización de inclusiones en la configuración.
La estructura básica de los recursos de Liberty es la siguiente. Este enfoque le ayudará a simplificar el mantenimiento y a ahorrar espacio en disco cuando los servidores adicionales se desplieguen en el futuro.- Hosts de servidor
- Recursos compartidos
- SDK (JRE)
- Tiempo de ejecución de Liberty
- Recursos de trabajo
- Proyecto
- Servidor 1 de Liberty
- Binario de aplicación 1
- Servidor 2 de Liberty
- Binario de aplicación 2
- Servidor 1 de Liberty
- Proyecto
- Recursos compartidos
Las siguientes suposiciones se aplican para esta instalación de ejemplo:- Estructura cuando se despliega
- Este entorno de Liberty de ejemplo tiene la siguiente estructura de directorios en cada host de servidor:
[-] liberty [-] shared [-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] working [-] samples [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
Cada servidor aislado se configura para que utilice el SDK (JRE) compartido y el tiempo de ejecución de Liberty compartido. Las ubicaciones de los recursos compartidos se almacenan en cada archivo server.env; por ejemplo:
Las vías de acceso incluyen la variable WLP_SHARED_DIR de WebSphere en lugar de una vía de acceso insertada en el código fuente. Cuando los servidores aislados se despliegan en los hosts de servidor, el gestor de trabajos sustituye ${WLP_SHARED_DIR} por la vía de acceso del directorio compartido real, en este caso /liberty/shared.JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31 WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
- Estructura de paquetes para despliegue inicial
- Los siguientes directorios y archivos se incluyen en el archivo
(.zip) comprimido para el despliegue inicial de SDK
(JRE) y el tiempo de ejecución de Liberty en el directorio de recursos compartidos que se define mediante la variable
WLP_SHARED_DIR de WebSphere. Dado que es probable que el SDK y el tiempo de ejecución de Liberty se utilizará entre proyectos, estos recursos no se incluyen en un directorio de proyecto.
En este ejemplo, el SDK y el tiempo de ejecución de Liberty se empaquetan en un archivo comprimido único. Sin embargo, puede empaquetarlos en dos archivos comprimidos separados y someter dos trabajos de instalación distintos.
[-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates
Los siguientes directorios y archivos se incluyen en el archivo comprimido (.zip) para el despliegue inicial de los servidores de Liberty y sus aplicaciones en el directorio de recursos de trabajo que define la variable WLP_WORKING_DIR de WebSphere. El directorio de proyecto, samples, se encuentra en el directorio raíz del archivo comprimido.
[-] samples [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
- Estructura de paquete para actualizar servidor y aplicación
- Los siguientes directorios y archivos se incluyen en un archivo comprimido
(.zip) para su despliegue posterior de una nueva versión de un servidor y su aplicación en el directorio de recursos de trabajo que define la variable WLP_WORKING_DIR de WebSphere. El directorio de
proyecto, samples, se encuentra en el directorio raíz del archivo comprimido.
[-] samples [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.01.war
- Hosts de servidor
- Restricción: El ejemplo 3 no funciona en el sistema operativo Windows.
Este ejemplo primero muestra cómo empaquetar los recursos de Liberty para un entorno donde el SDK (JRE), el tiempo de ejecución de Liberty, y varias aplicaciones se almacenan en un disco compartido y dos servidores aislados (trabajo) se almacenan en cada host de servidor. A continuación muestra cómo empaquetar una nueva versión de un servidor y la aplicación a la que da soporte. El uso del gestor de trabajos es obligatorio para los entornos que incluyen servidores de Liberty aislados. No puede utilizar el script de servidor de Liberty para gestionar los servidores. Para obtener información sobre el uso compartido de los valores de configuración de servidor a niveles de host y de red, consulte la documentación de Liberty sobre la utilización de inclusiones en la configuración.
La estructura básica de los recursos de Liberty es la siguiente. Este enfoque le ayudará a simplificar el mantenimiento y a ahorrar espacio en disco cuando los servidores adicionales se desplieguen en el futuro.- Disco compartido
- Recursos compartidos
- SDK (JRE)
- Tiempo de ejecución de Liberty
- Binario de aplicación 1
- Binario de aplicación 2
- Recursos compartidos
- Hosts de servidor
- Recursos de trabajo
- Proyecto
- Servidor 1 de Liberty
- Servidor 2 de Liberty
- Proyecto
- Recursos de trabajo
Las siguientes suposiciones se aplican para esta instalación de ejemplo:- Estructura cuando se despliega
- Este entorno de Liberty de ejemplo tiene las siguientes estructuras de directorio en disco compartido y en los hosts de servidor:
Disco compartido [-] liberty [-] shared [-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] samples [ ] apps o SecuritySample-01.00.war o ServletSample-01.00-01.war
Hosts de servidor [-] liberty [-] working [-] samples [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml
Cada servidor aislado se configura para que utilice el SDK (JRE) compartido y el tiempo de ejecución de Liberty compartido. Las ubicaciones de los recursos compartidos se almacenan en cada archivo server.env; por ejemplo:
Las vías de acceso incluyen la variable WLP_SHARED_DIR de WebSphere en lugar de una vía de acceso insertada en el código fuente. Cuando los servidores aislados se despliegan en los hosts de servidor, el gestor de trabajos sustituye ${WLP_SHARED_DIR} por la vía de acceso del directorio compartido real, en este caso /liberty/shared. En cada host de servidor, el directorio de recursos compartidos remoto se monta en /liberty/shared.JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31 WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
Dado que las aplicaciones se encuentran en el almacenamiento compartido aparte de los servidores, el elemento de la aplicación en cada archivo server.xml debe incluir la vía de acceso completa al archivo WAR correspondiente; por ejemplo:<application id="SecuritySample" location="/liberty/shared/apps/SecuritySample-01.00.war" name="SecuritySample" type="war"/>
Para minimizar los cambios en el archivo server.xml, el directorio de la aplicación y la información de versión se puede almacenar en dos propiedades en el archivo bootstrap.properties de cada servidor; por ejemplo:apps.dir=${WLP_SHARED_DIR}/${CURRENT_PROJECT}/apps security.sample.version=1.00
A continuación, puede incluir tanto la variable de WebSphere WLP_SHARED_DIR como la variable del gestor de trabajos incorporado CURRENT_PROJECT en el elemento de la aplicación en cada archivo server.xml; por ejemplo:<application id="SecuritySample" location="${apps.dir}/SecuritySample-${security.sample.version}.war" name="SecuritySample" type="war"/>
- Estructura de paquetes para despliegue inicial
- Los siguientes directorios y archivos se incluyen en el archivo comprimido
(.zip) para el despliegue inicial del SDK
(JRE), el tiempo de ejecución de Liberty y las aplicaciones en la ubicación de disco compartido que ha definido la variable
WLP_SHARED_DIR de WebSphere. Puesto que es probable que el SDK y el tiempo de ejecución de Liberty se compartirán entre proyectos, estos recursos no se incluyen en un directorio de proyecto. Las aplicaciones se incluyen en el directorio de proyecto samples. En este ejemplo, empaquete todos los recursos compartidos en un archivo comprimido único.
Sin embargo, puede empaquetarlos en tres archivos comprimidos separados y someter tres trabajos de instalación distintos.
[-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] samples [ ] apps o SecuritySample-01.00.war o ServletSample-01.00.war
Los siguientes directorios y archivos se incluyen en un archivo comprimido (.zip) para el despliegue inicial de los servidores de Liberty en el directorio de recursos de trabajo que define la variable WLP_WORKING_DIR de WebSphere:
[-] samples [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml [ ] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml
- Estructura de paquetes para actualización a la aplicación y el servidor
- Los siguientes directorios y archivos están incluidos en un archivo
(.zip) comprimido para el despliegue posterior de una nueva versión de una aplicación en la ubicación de disco compartida que define la variable WLP_SHARED_DIR de WebSphere. El directorio de proyecto, samples, se encuentra en el directorio raíz del archivo.
[-] samples [ ] apps o SecuritySample-01.01.war
Los siguientes directorios y archivos se incluyen en un archivo comprimido (.zip) para el despliegue posterior de una nueva versión de un servidor al directorio de recursos de trabajo que define la variable WLP_WORKING_DIR de WebSphere. El directorio de proyecto, samples, se encuentra en el directorio raíz del archivo comprimido.
[-] samples [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml
Debe cambiar el elemento de aplicación en el archivo server.xml para incluir Versión 1.01 del archivo WAR; por ejemplo:
<application id="SecuritySample" location="/liberty/shared/apps/SecuritySample-01.01.war" name="SecuritySample" type="war"/>
De forma alternativa, si el archivo bootstrap.properties contiene la información de versión de aplicación, debe cambiar el archivo en consecuencia; por ejemplo:
security.sample.version=1.01
A continuación, utilice la información de versión actualizada en el elemento de aplicación en el archivo server.xml; por ejemplo:
<application id="SecuritySample" location="${apps.dir}/SecuritySample-${security.sample.version}.war" name="SecuritySample" type="war"/>
- Disco compartido
Qué hacer a continuación
Establecer variables que permiten al gestor de trabajos instalar y buscar recursos de Liberty.