WAS v8.5 > Administer applications and their environment > Administer the Liberty profile > Administer the Liberty profile manuallyLiberty profile environment variables
Environment variables
We can customize the Liberty profile environment using certain specific variables to support the placement of product binary files and shared resources in read-only file systems.
The following Liberty profile specific variables can be used to customize the Liberty profile environment:
${wlp.install.dir} Inferred location of installation directory. Always set to either...
- Parent of the directory containing the launch script
- Parent of the /lib directory containing the target JAR files.
For example...
E:/IBM/Worklight/server/wlp
WLP_USER_DIR If specified, the runtime environment looks in location for...
- shared resources
- server definition
Alternate location for ${wlp.user.dir}. Can only be an absolute path.
${server.config.dir} is equivalent to...
${wlp.user.dir}/servers/serverName
For example...
C:/ProgramData/IBM/Worklight/WAS85liberty-server/wlp/usr/servers/worklightServer
WLP_OUTPUT_DIR Alternate location for server generated output such as...
- logs
- workarea directory
- generated files
Can only be an absolute path. If specified, ${server.output.dir} is set to the equivalent of...
WLP_OUTPUT_DIR/serverName
If not, ${server.output.dir} is the same as...
${server.config.dir}
We can specify WLP_OUTPUT_DIR and WLP_USER_DIR environment variables in server.env files. We can also specify JVM options in jvm.options files.
server.env
Specify WLP_OUTPUT_DIR in either of the following files.
- ${wlp.install.dir}/etc/server.env
- ${server.config.dir}/server.env
If both files are present, contents are merged with values in the server-level file taking precedence over values in the runtime-level.
WLP_USER_DIR should only be specified in...
${wlp.install.dir}/etc/server.env
Shell and variable expansion are not supported.
We can also specify WLP_OUTPUT_DIR and WLP_USER_DIR in the shell environment. server.env files take precedence over those variables.
jvm.options
Specify JVM options in jvm.options files at the runtime and server levels...
- ${wlp.install.dir}/etc/jvm.options
- ${server.config.dir}/jvm.options
If both files are present, options in ${server.config.dir} are used.
To set JAVA_HOME...
JAVA_HOME=/opt/ibm/java-i386-60/jre
We can also specify server startup options, for example, -X arguments. Specify only one option per line. For example:
-Xmx1024m
-Dcom.ibm.example.system.property=ExampleValue
-verbose:class
The server management script searches for jvm.options in two locations:
${wlp.install.dir}/etc/jvm.options
${server.config.dir}/jvm.options
Parent topic: Administer the Liberty profile manually
Related
Provide global libraries for all Java EE applications
Reference:
Liberty profile: Directory locations and properties
|