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:

  • El recurso de proyecto está en un directorio raíz de nivel superior opcional en el archivo comprimido. Los subdirectorios de este directorio raíz de nivel superior están en el directorio raíz de otros recursos. Puede utilizar el recurso de proyecto para agrupar recursos relacionados y para evitar conflictos de nombres.
  • El recurso de tiempo de ejecución contiene la vía de acceso de archivo nombre_tiempo_ejecución/bin/server o nombre_tiempo_ejecución/bin/server.bat. Todo lo que se encuentra bajo el directorio nombre_tiempo_ejecución se considera parte del recurso de tiempo de ejecución.
  • El recurso de servidor de Liberty satisface una de las siguientes reglas:
    • Si se incorpora dentro del recurso de tiempo de ejecución, el recurso de servidor de Liberty contiene la vía de acceso de archivo nombre_tiempo_ejecución/usr/servers/nombre_servidor/server.xml.
    • Si se aísla (separa) del recurso de tiempo de ejecución, el recurso de servidor de Liberty contiene la vía de acceso de archivo servers/nombre_servidor/server.xml.
  • El recurso de binario de aplicación satisface una de las siguientes reglas:
    • Si se incorpora dentro del recurso de servidor de Liberty, el recurso de binario de aplicación contiene la vía de acceso de archivo nombre_servidor/dropins/nombre_aplicación o nombre_servidor/apps/nombre_aplicación, donde nombre_aplicación finaliza en .ear, .war o .eba.
    • Si se incorpora dentro del recurso de tiempo de ejecución, el binario de aplicación contiene la vía de acceso de archivo nombre_tiempo_ejecución/usr/shared/apps/nombre_aplicación, donde nombre_aplicación finaliza en .ear, .war o .eba.
    • Si se aísla (separa) de los recursos de tiempo de ejecución y de servidor, el recurso de binario de aplicación contiene el archivo nombre_aplicación en cualquier vía de acceso del directorio, donde nombre_aplicación finaliza en .ear, .war o.eba.
  • El recurso de SDK contiene la vía de acceso del directorio nombre_JRE/jre/bin/java o nombre_JRE/bin/java, donde nombre_JRE es el nombre del entorno de tiempo de ejecución Java.
El gestor de trabajos utiliza el nombre de directorio de un recurso en el archivo comprimido como su nombre de recurso. Por ejemplo, si el nombre de directorio del tiempo de ejecución de Liberty es 08.05.00.00, entonces su nombre de recurso es 08.05.00.00 y su ID de recurso es runtime/08.05.00.00. Cuando asigne un nombre a los recursos, tenga en cuenta las directrices siguientes:
  • Si está desplegando el paquete en varios sistemas operativos, utilice los nombres de directorio y de archivos que sean portables entre sistemas operativos. Por ejemplo, no asigne a los recursos nombres que difieran únicamente en el uso de mayúsculas y minúsculas para que pueda desplegarlas en el sistema operativo Windows; es decir, no mezcle jre-01.06.00 y Jre-01.06.00.
  • Cuando utilice números de versión con números mayores y menores en los nombres de recursos, por ejemplo, 8.5.0.1, asegúrese de que asigna dígitos suficientes, de modo que la comparación de series léxicas se pueda utilizar para comparar versiones. Utilice08.05.00.01 en lugar de 8.5.0.1. Este esquema funciona inclusos si utiliza prefijos, como por ejemplo runtime-08.05.00.01 o jre-01.06.00_32.

    Si utiliza este convenio permite la comparación de versiones durante la consultas de recursos en el gestor de trabajos. Por ejemplo, en el gestor de trabajos puede consultar nombre > 08.05.00.11 para buscar todos los recursos cuyo nombre y versión sean mayores que 8.5.0.11. Para que la consulta resulte efectiva, asigne como mínimo dos dígitos a cada número de versión superior e inferior en el nombre. De lo contrario, obtendrá resultados falsos. Por ejemplo, utilice 08.05.00.02 > 08.05.00.11 para una consulta, en lugar de 8.5.0.2 > 8.5.0.11.

  • Utilice nombres de proyecto para agrupar recursos relacionados y evitar conflictos de nombres.

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

Ejemplo 1: Instalación de Liberty autocontenidos
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
Las siguientes suposiciones se aplican para esta instalación de ejemplo:
  • La instalación incluye dos servidores.
  • Cada servidor incluye un archivo bootstrap.properties, un archivo server.xml y una aplicación.
  • Cada servidor utiliza un SDK (JRE) instalado previamente que cumple los requisitos para Liberty. Si tiene previsto utilizar el gestor de trabajos para instalar un SDK, consulte el Ejemplo 2 para obtener información de configuración de empaquetado y servidor relevante.
  • La instalación de Liberty se despliega en ejemplos de directorio de proyecto en el directorio de trabajo /liberty/working, como por ejemplo /liberty/working/samples.
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
Ejemplo 2: Uso compartido a nivel de host de tiempo de ejecución de SDK y Liberty
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
Las siguientes suposiciones se aplican para esta instalación de ejemplo:
  • El SDK (JRE) y el tiempo de ejecución de Liberty se despliegan en el directorio compartido /liberty/shared.
  • Los dos servidores de trabajo aislados se despliegan en ejemplos de directorio de proyecto en el directorio de trabajo /liberty/working, como por ejemplo /liberty/working/samples. La inclusión de un directorio de proyecto es opcional.
  • Cada servidor incluye un archivo bootstrap.properties, un archivo server.env, un archivo server.xml y una aplicación.
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:
JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31
WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
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.
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
Ejemplo 3: Uso compartido a nivel de red de SDK, tiempo de ejecución y aplicaciones
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
  • Hosts de servidor
    • Recursos de trabajo
      • Proyecto
        • Servidor 1 de Liberty
        • Servidor 2 de Liberty
Las siguientes suposiciones se aplican para esta instalación de ejemplo:
  • El SDK (JRE), tiempo de ejecución de Liberty, y las aplicaciones se instalan en el disco compartido en la vía de acceso /liberty/shared.
  • En cada host de servidor, el directorio de recursos compartido (en el disco compartido) se monta en la misma vía de acceso, /liberty/shared.
  • En cada host de servidor, los dos servidores (de trabajo) aislados se despliegan en los ejemplos del directorio de proyecto en el directorio de ejemplo /liberty/working, tales como /liberty/working/samples. La inclusión de un directorio de proyecto es opcional.
  • Cada servidor incluye un archivo bootstrap.properties, un archivo server.env y un archivo server.xml.
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:
JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31
WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
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.
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"/>

Qué hacer a continuación

Establecer variables que permiten al gestor de trabajos instalar y buscar recursos de Liberty.


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_pkg_cs_res
File name: tagt_jobmgr_pkg_cs_res.html