Ejecución de un servidor Liberty desde un archivo JAR

Puede iniciar un servidor Liberty desde un archivo de archivado Java (JAR). Este método proporciona una forma compacta y portable de iniciar un servidor Liberty. Cree el archivo JAR utilizando el mandato del servidor Liberty y, después, ejecute como un archivo JAR ejecutable utilizando el mandato Java -jar.

Crear el archivo JAR ejecutable

Puede especificar minify para obtener el archivo más pequeño posible. Debe especificar un archivo de tipo JAR para obtener un archivo JAR ejecutable. El tipo de archivo predeterminado es .zip en todas las plataformas excepto z/OS, donde el único tipo soportado es pax. Por ejemplo:

server package <nombre servidor>
--include=[minify,]runnable --archive=<nombre archivo jar>.jar

Ejecutar el archivo JAR

Ejecute el archivo JAR utilizando el mandato java estándar con la opción -jar, por ejemplo:
java -jar <jar file name>.jar

Operación

Cuando se ejecuta el archivo JAR, se extrae en una ubicación temporal y, después, el servidor se ejecuta en primer plano, iniciado por el mandato de ejecución del servidor Liberty. Toda la salida se graba en stdout o stderr. De forma predeterminada, los archivos se extraen en ubicaciones temporales:
  • Para Windows: %HOMEPATH%/wlpExtract/<nombre archivo jar>_nnnnnnnnnnnnnnnnnnn
  • Para todas las demás plataformas: $HOME/wlpExtract/<nombre archivo jar>_nnnnnnnnnnnnnnnnnnn

Puede controlar la ubicación de salida utilizando la variable de entorno WLP_JAR_EXTRACT_ROOT o WLP_JAR_EXTRACT_DIR.

Detención del servidor

Para detener el servidor Liberty, pulse Ctrl-C. Cuando el servidor Liberty se detiene, el directorio de extracción se suprime automáticamente. Si detiene el shell activo de cualquier otra forma, el directorio de extracción no se limpia automáticamente y se debe limpiar manualmente.

Ejecutar en modalidad de depuración

Puede ejecutar el servidor Liberty en la modalidad de depuración si establece la variable de entorno WLP_JAR_DEBUG antes de iniciar el servidor.

Control de la salida

De forma predeterminada, la salida de servidor se graba en el directorio de extracción, que se suprime cuando el servidor se detiene. Si desea guardar la salida, especifique una ubicación de salida duradera utilizando la variable de entorno WLP_OUTPUT_DIR antes de iniciar el servidor.

Transacciones de confirmación en dos fases

De forma predeterminada, las transacciones de confirmación de dos fases están inhabilitadas porque los registros de transacciones están en el directorio de expansión y se suprimen cuando se detiene el servidor Liberty. Por lo tanto, la recuperación de transacción no es posible.

Para habilitar la confirmación en dos fases, configure el registro de transacciones para que esté en una ubicación duradera en el sistema de archivos o un RDBMS y establezca la variable de entorno WLP_JAR_ENABLE_2PC.

Para configurar el registro de transacciones, utilice el atributo transactionLogDirectory o dataSourceRef en el elemento de transacción en la configuración de server.xml.

Ejecución bajo CYGWIN

La ejecución de un archivo JAR de servidor Liberty en un shell CYGWIN tiene dos requisitos:

  1. Especifique la variable de entorno WLP_JAR_CYGWIN.

    Esta variable provoca que el ejecutador JAR del servidor Liberty realice un archivo de estilo UNIX y el manejo del proceso cuando se ejecuta en el entorno CYGWIN.

  2. Ejecute bajo el shell bash, no mintty.

    La supresión de archivos de extracción automática se produce sólo cuando se ejecuta bajo el shell bash. Puede ejecutar bajo mintty, pero debe suprimir los archivos de extracción manualmente. Mintty no reenvía la señal necesaria para activar los ganchos de conclusión Java.

Referencia de variables de entorno

Tabla 1. Nombres de variables de entorno y sus definiciones
Nombre de variable de entorno Descripción
WLP_JAR_EXTRACT_ROOT Extrae el archivo JAR en un directorio ${WLP_JAR_EXTRACT_ROOT}/<nombre archivo jar>_nnnnnnnnnnnnnnnnnnn
WLP_JAR_EXTRACT_DIR Extraiga el archivo JAR en el directorio ${WLP_JAR_EXTRACT_DIR}.
WLP_OUTPUT_DIR Escribe los archivos de salida del servidor Liberty en el directorio ${WLP_OUTPUT_DIR}.
WLP_JAR_DEBUG Ejecuta el servidor Liberty utilizando server debug <nombre servidor>, en lugar de server run <nombre servidor>.
WLP_JAR_ENABLE_2PC Establezca el valor true para habilitar 2PC cuando se ejecute el archivo JAR ejecutable.
WLP_JAR_CYGWIN Establézcalo en el valor true si está ejecutando el archivo JAR bajo CYGWIN.

Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_setup_jarserver.html