定制 Liberty 环境
可以通过使用某些特定变量来定制 Liberty 环境,以支持在只读文件系统中放置产品二进制文件和共享资源。
关于此任务
可在 server.env 文件中配置以下列表中特定于 Liberty 的环境变量,以定制 Liberty 环境。${wlp.install.dir} 配置变量具有推断位置,它始终设置为其中包含启动脚本的目录的父目录。
- WLP_USER_DIR
可以使用此环境变量来指定 ${wlp.user.dir} 的替代位置。此变量必须是一个绝对路径。如果指定了此变量,那么运行时环境会在所指定的目录中查找共享资源和服务器定义。${server.config.dir} 等价于 ${wlp.user.dir}/servers/serverName。如果未指定此环境变量,那么 ${wlp.user.dir} 设置为 ${wlp.install.dir}/usr。
- WLP_OUTPUT_DIR
可以使用此环境变量来指定服务器生成输出(例如日志、workarea 目录和生成文件)的替代位置。logs 目录中的文件可能包括 console.log、messages.log 和所生成的任何 FFDC 文件。所生成的文件可以包括使用 server dump 或 server javadump 命令创建的服务器转储。此变量必须是一个绝对路径。如果指定此环境变量,那么会将 ${server.output.dir} 设置为 WLP_OUTPUT_DIR/serverName 的等价项。如果未指定此环境变量,那么 ${server.output.dir} 与 ${server.config.dir} 相同。
当使用此服务器命令时,服务器进程将使用输出目录作为其当前工作目录。
- WLP_ZOS_PROCEDURE
此环境变量可用于指定 STC 过程的名称,该过程用于将服务器作为 z/OS 已启动任务而非 UNIX 系统服务后台进程启动。缺省情况下,命令端口保持已启用状态,以允许通过服务器脚本对服务器进行持续管理。(可选)可以手动禁用命令端口,以将服务器管理限制为仅通过 z/OS 操作员控制台进行;请参阅指定 Liberty 引导程序属性。
- WLP_DEBUG_ADDRESS
以调试方式运行服务器时,可以使用此环境变量来指定替代端口。缺省值为 7777。在服务器命令中以调试方式运行 Liberty 时,设置了以下值: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}"。但是,如果从 ws-server.jar 可执行 JAR 文件或嵌入式 Liberty 服务器 SPI 运行 Liberty,那么必须使用相同设置以对 Liberty 启用调试方式。
可在 server.env 文件中指定 WLP_OUTPUT_DIR、WLP_USER_DIR 和 WLP_DEBUG_ADDRESS 环境变量。还可以在 jvm.options 文件中指定 JVM 选项。仅当使用服务器管理脚本时,server.env 和 jvm.options 文件才起作用。如果使用 ws-server.jar 可执行 JAR 文件来启动服务器,那么不支持这些文件。
过程
- 使用 server.env 文件来指定环境变量。 可以使用安装级和服务器级 server.env 文件来指定环境变量,例如 JAVA_HOME、WLP_USER_DIR 和 WLP_OUTPUT_DIR。例如:
# Use a specific Java binary JAVA_HOME=/opt/ibm/java-i386-60/jre # JAVA_HOME=c:\Java注:- server.env 文件仅支持 key=value 对。
- 将忽略空行及 # 字符开头的行。
- 没有转义字符;所有字符都是文字,包括反斜杠、前导空格和拖尾空格。
- 等号“=”周围不应有空格。
- 不支持 shell 和变量扩展。
- 只能在 ${wlp.install.dir}/etc/server.env 文件中指定 WLP_USER_DIR,因为此变量的用途是指定其余配置所在的位置。找到以及合并其余配置之后,其他位置中的任何进一步配置都不符合预期,也不受支持。
服务器管理脚本会在下列两个位置搜索 server.env 文件:${wlp.install.dir}/etc/server.env 和 ${server.config.dir}/server.env。如果两个文件都存在,那么会合并这两个文件的内容;服务器级别文件中的值优先于运行时级别文件中的值。
还可以在 shell 环境中指定这些环境变量,但 server.env 文件优先于这些变量。
- 使用 jvm.options 文件来定制 JVM 选项。 可通过运行时级别和服务器级别来使用 jvm.options 文件,以指定更多服务器启动选项,例如 -X 参数。通过服务器管理脚本来执行启动、运行和调试操作时应用这些选项。确保每行只指定一个选项。例如:
# 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
可以在以下位置创建多个 jvm.options 文件:- ${wlp.install.dir}/usr/shared/jvm.options
- ${server.config.dir}/configDropins/defaults/jvm.options
- ${server.config.dir}/jvm.options
- ${server.config.dir}/configDropins/overrides/jvm.options
注:- 请勿将属性值括在引号内。
- 将忽略空行及 # 字符开头的行。
- 没有转义字符;所有字符都是文字,包括反斜杠、前导空格和拖尾空格。
- 等号“=”周围不应有空格。
- 不支持 shell 和变量扩展。
下一步做什么
如果使用服务器脚本启动 Liberty 服务器,那么当前会话中的所有操作系统环境变量都可用。如果通过使用 MBean 或管理中心启动服务器,那么只有对该系统上正在运行的远程命令可用的环境变量是可用的变量。
任务主题
最近一次更新时间: Tuesday, 6 December 2016http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=twlp_admin_customvars
文件名:twlp_admin_customvars.html