Puede personalizar el entorno del perfil Liberty utilizando determinadas variables específicas
para dar soporte a la ubicación de los archivos binarios del producto y los recursos compartidos en
sistemas de archivos de sólo lectura.
Acerca de esta tarea
Las variables de entorno específicas del perfil Liberty de la lista siguiente
se pueden configurar en el archivo server.env para personalizar el
entorno del perfil Liberty. La variable de configuración
${wlp.install.dir} tiene una ubicación derivada que siempre se establece
en el padre del directorio que contiene el script de inicio.
- WLP_USER_DIR
Esta variable de entorno se puede utilizar para especificar una ubicación alternativa para ${wlp.user.dir}. Esta variable debe ser una vía de acceso absoluta. Si se especifica esta variable, el entorno de ejecución
busca los recursos compartidos y las definiciones de servidor en el directorio especificado. ${server.config.dir} es
equivalente a ${wlp.user.dir}/servers/serverName. Si no se especifica esta variable de entorno, ${wlp.user.dir} se establece
en ${wlp.install.dir}/usr.
- WLP_OUTPUT_DIR
Esta variable de entorno se puede utilizar para especificar una ubicación de servidor alternativa para la salida generada como registros, el directorio Workarea
y los archivos generados. Los archivos del directorio de registros pueden incluir los archivos console.log,
messages.log y los archivos FFDC generados.
Los archivos generados pueden incluir vuelcos de servidor que se han creado con el mandato server dump o server javadump.
Esta variable debe ser una vía de acceso absoluta. Si se especifica esta variable de entorno, se establece ${server.output.dir}
en el equivalente de WLP_OUTPUT_DIR/serverName.
Si no se especifica esta variable de entorno, ${server.output.dir} es el mismo que {server.config.dir}.
Cuando se utiliza el mandato server, el proceso de servidor
utiliza el directorio de trabajo actual como su directorio de trabajo actual.
- WLP_DEBUG_ADDRESS
Esta variable de entorno se puede utilizar para especificar un puerto alternativo cuando ejecute el servidor en modalidad de depuración. El valor predeterminado es 7777.
Cuando Liberty se ejecuta en modalidad de depuración desde el mandato server, se establecen los valores siguientes: JAVA_DEBUG="-Dwas.debug.mode=true -Dcom.ibm.websphere.ras.inject.at.transform=true -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=${WLP_DEBUG_ADDRESS}".
Sin embargo, si se ejecuta Liberty desde el archivo JAR ejecutable ws-server.jar o la SPI de servidor Liberty incorporado, debe
utilizar los mismos valores para habilitar la modalidad de depuración de Liberty.
Puede especificar las variables de entorno
WLP_OUTPUT_DIR, WLP_USER_DIR y WLP_DEBUG_ADDRESS en los archivos server.env. Puede también especificar opciones de la JVM en los archivos jvm.options. Los archivos server.env y jvm.options solamente funcionan cuando se utiliza el script de gestión de servidor. Si utiliza el archivo JAR ejecutable ws-server.jar
para iniciar el servidor, no se admiten estos archivos.
Procedimiento
- Especifique las variables de entorno utilizando los archivos server.env.
Puede utilizar los archivos
server.env en la instalación y
los niveles de servidor para especificar variables de entorno tales como
JAVA_HOME,
WLP_USER_DIR y
WLP_OUTPUT_DIR. Por ejemplo:
# Use a specific Java binary
JAVA_HOME=/opt/ibm/java-i386-60/jre
# JAVA_HOME=c:\Java
Nota:
- Los archivos server.env solo admiten pares de clave=valor.
- Las líneas vacías y las líneas que empiezan por el carácter # se ignoran.
- No hay caracteres de escape; todos los caracteres son literales, incluidas las barras inclinadas invertidas y los espacios en blanco iniciales y
finales.
- No se admite la expansión de variables y shell.
- WLP_USER_DIR sólo puede especificarse en el archivo ${wlp.install.dir}/etc/server.env porque
el objetivo de esta variable es especificar dónde se encuentra la configuración restante. Después de que se encuentra y se fusiona la configuración restante,
no se espera ni se da soporte a ninguna configuración adicional en otra ubicación.
El script de gestión de servidores busca los archivos
server.env en dos ubicaciones: ${wlp.install.dir}/etc/server.env y ${server.config.dir}/server.env.
Si están presentes los dos archivos, el contenido de los dos archivos se fusiona;
los valores del archivo de nivel de servidor toman preferencia sobre los valores
del archivo de nivel de tiempo de ejecución.
Puede también especificar estas variables de entorno en el entorno de shell, pero los archivos server.env tienen prioridad sobre las variables.
- Personalice las opciones de JVM utilizando los archivos jvm.options.
Puede utilizar archivos
jvm.options en los niveles de
tiempo de ejecución y de servidor para especificar más opciones de inicio del servidor,
por ejemplo, los argumentos
-X. Las opciones se aplican cuando se inician las acciones de iniciar, ejecutar y depurar mediante el script de gestión de servidores. Asegúrese de especificar solo una opción por línea. Por ejemplo:
# Set the maximum heap size to 1024m.
-Xmx1024m
# Set a system property.
-Dcom.ibm.example.system.property=ExampleValue
# Enable verbose output for class loading.
-verbose:class
# Enable verbose garbage collection.
-verbose:gc
# Specify an alternate verbose garbage collection log on IBM Java Virtual Machines only.
-Xverbosegclog:verbosegc.log
# Specify additional verbose garbage collection options on HotSpot Java Virtual Machines only.
-Xloggc:verbosegc.log
-XX:+PrintGCDetails
-XX:+PrintGCTimeStamps
-XX:+PrintHeapAtGC
El script de gestión de servidores busca
jvm.options en dos ubicaciones: ${wlp.install.dir}/etc/jvm.options
y ${server.config.dir}/jvm.options.
Si están presentes los dos archivos, se utilizan las opciones del archivo ${server.config.dir}/jvm.options.
Nota:
- Las líneas vacías y las líneas que empiezan por el carácter # se ignoran.
- No hay caracteres de escape; todos los caracteres son literales, incluidas las barras inclinadas invertidas y los espacios en blanco iniciales y
finales.
- No se admite la expansión de variables y shell.
Qué hacer a continuación
Si inicia el servidor de
Liberty utilizando el script de servidor, estarán disponibles todas las variables del entorno del sistema operativo desde la sesión actual. Si inicia el servidor utilizando MBean o el Centro de administración, las únicas variables de entorno disponibles son las que están disponibles para un mandato remoto que se ejecuta en ese sistema.