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
java -jar <jar file name>.jar
Operación
- 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:
- 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.
- 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
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. |