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

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

Operación

Cuando el archivo JAR se ejecuta, se extrae en una ubicación temporal y, a continuación, el servidor se ejecuta en primer plano, iniciado por el mandato de ejecución de servidor de 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 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:

  1. 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.

  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 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.

Icono que indica el tipo de tema Tema de referencia



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=rwlp_setup_jarserver
Nombre de archivo:rwlp_setup_jarserver.html