定制 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.logmessages.log 和所生成的任何 FFDC 文件。所生成的文件可以包括使用 server dumpserver 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_ZOS_JOBNAME

    除使用 WLP_ZOS_PROCEDURE 变量之外,还可以使用此环境变量,以便为以 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_DIRWLP_USER_DIRWLP_DEBUG_ADDRESS 环境变量。还可以在 jvm.options 文件中指定 JVM 选项。仅当使用服务器管理脚本时,server.envjvm.options 文件才起作用。如果使用 ws-server.jar 可执行 JAR 文件来启动服务器,那么不支持这些文件。

过程

下一步做什么

如果使用服务器脚本启动 Liberty 服务器,那么当前会话中的所有操作系统环境变量都可用。如果通过使用 MBean 或管理中心启动服务器,那么只有对该系统上正在运行的远程命令可用的环境变量是可用的变量。


用于指示主题类型的图标 任务主题

文件名:twlp_admin_customvars.html