Empaquetado de un servidor de Liberty desde la línea de mandatos

Desde la línea de mandatos, puede crear un archivo comprimido que contenga un entorno de tiempo de ejecución de Liberty, los archivos del directorio de recursos compartido, un servidor específico y las aplicaciones que están incorporadas en el servidor. También puede elegir excluir los binarios de tiempo de ejecución del archivo comprimido.

Acerca de esta tarea

El servidor Liberty es ligero, así que puede empaquetar fácilmente una instalación de servidor en un archivo comprimido. A continuación, puede almacenar este paquete, distribuirlo a compañeros y, después, utilizarlo para desplegar la instalación en una ubicación diferente o en otra máquina o, incluso, incorporar la instalación en una distribución de producto.

La instalación del servidor que desea empaquetar no puede estar unida ya a un colectivo. Puede empaquetar solo un servidor autónomo.

Procedimiento

  1. Abra un indicador de mandatos y vaya al directorio wlp/bin.
  2. Detenga el servidor.
  3. Ejecute el mandato package para crear un paquete.

    Puede empaquetar Liberty server o runtime.

    • Empaquete el servidor de Liberty.

      El formato de archivado predeterminado es .zip en todas las plataformas a parte de z/OS donde es .pax. También puede generar un .jar.

      En z/OS, utilice .pax en lugar de .zip en los ejemplos siguientes.

      Si no especifica un nombre de servidor, se utiliza defaultServer. Si no especifica el parámetro --archive, se utiliza el valor de nombre_servidor para nombre_archivo_paquete, y el archivo comprimido se crea en el directorio ${server.output.dir}.

      Elija el mandato correcto para su entorno.

      • Utilice este mandato para generar un archivo .pax.

        server package nombre_servidor --archive=nombre_archivo_paquete.pax --include=todos
        donde nombre_archivo_paquete.pax es el nombre de archivo elegido. El nombre de archivo puede incluir también una vía de acceso completa. Si se omite la vía de acceso completa, se crea un archivo comprimido denominado nombre_archivo_paquete.pax en el directorio ${server.output.dir}.

        El formato de archivado pax guarda los atributos ampliados necesarios para que Liberty funcione según lo diseñado en todos los casos de ejemplo soportados. Si se necesita un archivo comprimido con formato ZIP, especifique el nombre de archivado de destino e incluya la extensión .zip.

        Los formatos de archivado de .jar y .zip no son válidos en z/OS.

      También puede utilizar la opción --include con este mandato. Por ejemplo, la opción --include=all empaqueta los archivos binarios de tiempo de ejecución y los archivos relevantes en el directorio ${WLP_USER_DIR} directory; the --include=usr ${WLP_USER_DIR}, excluyendo de forma eficaz los archivos binarios de tiempo de ejecución del archivo comprimido.

      La opción --include=usr no es válida con un formato de archivo .jar.

      Si utiliza la opción --include=minify, el mandato server empaqueta solo los componentes del entorno de ejecución y los archivos del directorio ${WLP_USER_DIR}, que es necesario que ejecute el servidor. Esta opción reduce significativamente el tamaño del archivo resultante.

      Los componentes del entorno de ejecución que están retenidos por la operación minify dependen de las características configuradas en el servidor que está empaquetando. Solo se retienen las características que es necesario que ejecute el servidor y se eliminan las características restantes. Por lo tanto, no puede habilitar más tarde una característica que se haya eliminado. Por ejemplo, si solo se retiene la característica servlet-3.0, no puede habilitar posteriormente la característica jpa-2.0.

      Puede repetir la operación minify para reducir más el tamaño del archivo si se cambia la configuración. No hay sin embargo una operación inversa para la operación minify, de modo que si más adelante requiere una o varias características que se han eliminado, debe comenzar de nuevo con un servidor de Liberty completo.

      Mientras se está ejecutando la operación minify, el servidor se inicia temporalmente y verá los mensajes asociados. Por este motivo, no puede utilizar la opción --include=minify con un servidor que no se puede iniciar, pero puede empaquetarlo con las opciones --include=all o --include=usr.

      Puede especificar los sistemas operativos que desea que el servidor empaquetado admita mediante la opción --os con la opción --include=minify.

      Por ejemplo, para empaquetar un servidor con el soporte de z/OS eliminado, utilice el mandato siguiente:
      server package --archive="nozos.zip" --include=minify --os=-z/OS
      Para empaquetar un servidor con el soporte de OS/400 retenido, pero con el soporte de z/OS eliminado, utilice el mandato siguiente:
      server package --archive="small.zip" --include=minify --os=OS/400,-z/OS
      Para empaquetar un servidor que admite solo Linux, utilice el mandato siguiente:
      server package --archive="linux.zip" --include=minify --os=Linux
      Nota: Para descomprimir un archivo pax en z/OS, vaya a la ubicación donde desea descomprimir el archivo y, a continuación, ejecute el mandato siguiente. La opción -ppx se utiliza para conservar los atributos ampliados.
      pax -ppx -rf ubicación nombre_archivo.pax
      donde ubicación es la vía de acceso donde existe el archivo y nombre_archivo.pax es el nombre del archivo.
    • Empaquete el tiempo de ejecución de Liberty.

      En z/OS, utilice .pax en lugar de .zip para los ejemplos siguientes.

      Cree un archivo de archivado de tiempo de ejecución que contenga el directorio wlp, pero no contenga el directorio usr. El convenio de denominación para un paquete de servidor es nombre_paquete.zip, como en el ejemplo siguiente: CustomerPortalApp.zip. Para crear un archivado de tiempo de ejecución, ejecute el mandato package sin un nombre de servidor y con la opción --include=wlp.

      server package --include=wlp

      Para especificar un nombre de archivo de paquete y una ubicación de destino, añada la opción --archive=package_path_name, tal como se muestra en el ejemplo siguiente.

      server package --include=wlp --archive=c:\temp\myPackage.zip

      Si no especifica un nombre de paquete o una ubicación de destino válidos con la opción --archive, el mandato crea el archivado de tiempo de ejecución wlp.zip en la ubicación $WLP_OUTPUT_DIR, que es el directorio ${wlp.install.dir}/usr/servers de forma predeterminada. La ubicación de destino debe existir antes de ejecutar el mandato. Por lo tanto, si la ubicación de destino es c:\temp, el directorio C:\temp debe existir y tener permiso de escritura para que el mandato pueda escribir el archivado en el directorio C:\temp.


Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_setup_package_server.html