Ejecución de un servidor de Liberty desde un archivo JAR
Puede iniciar un servidor de Liberty desde un archivo Java (JAR). Este método proporciona una forma portable compacta de iniciar un servidor de Liberty. Puede crear el archivo JAR utilizando el mandato de servidor de Liberty y luego ejecutarlo como un archivo JAR ejecutable utilizando 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 <nombre archivo jar>.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 de Liberty, pulse Ctlr-C. Cuando el servidor de 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 de Liberty en 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 en dos fases están inhabilitadas porque los registros de transacción están en el directorio de expansión y se suprimen cuando se detiene el servidor de 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 de Liberty en un shell CYGWIN tiene dos requisitos:
- Especifique la variable de entorno WLP_JAR_CYGWIN.
Esta variable hace que el ejecutor JAR del servidor de Liberty realice el manejo de procesos y archivo de estilo UNIX 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 | Extraiga el archivo JAR en el 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 | Graba archivos de salida de servidor de Liberty en el directorio ${WLP_OUTPUT_DIR}. |
WLP_JAR_DEBUG | Ejecuta el servidor de Liberty utilizando server debug <nombre de servidor> en lugar de server run <nombre de 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. |