3.9. 系统属性
您可以使用 Java 系统属性配置许多 JBoss EAP 选项,并可设置任何名称值对供应用服务器内使用。
系统属性可用于覆盖 JBoss EAP 配置中的默认值。例如,公共接口绑定地址的以下 XML 配置显示它可以通过 jboss.bind.address
系统属性设置,但如果未提供 system 属性,则默认为 127.0.0.1
。
<inet-address value="${jboss.bind.address:127.0.0.1}"/>
您可以通过几种方式在 JBoss EAP 中设置系统属性,包括:
如果您使用 JBoss EAP 受管域,系统属性可以应用到整个域、特定服务器组、特定主机及其所有服务器实例,或者仅应用到一个特定的服务器实例。与大多数其他 JBoss EAP 域设置一样,在更具体的级别上设置的系统属性将覆盖更抽象化的级别。如需更多信息,请参阅域管理一章。
将系统属性传递给启动脚本
您可以使用 -D
参数将系统属性传递到 JBoss EAP 启动脚本。例如:
$ EAP_HOME/bin/standalone.sh -Djboss.bind.address=192.168.1.2
这种设置系统属性的方法对于 JBoss EAP 启动之前需要设置的 JBoss EAP 选项特别有用。
使用管理 CLI 设置系统属性
使用管理 CLI,您可以使用以下语法设置系统属性:
/system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)
例如:
/system-property=jboss.bind.address:add(value=192.168.1.2)
使用管理 CLI 设置系统属性时,某些 JBoss EAP 选项(包括上述 jboss.bind.address
示例)仅在下一次服务器重启后生效。
对于受管域,上例为整个域配置系统属性,但您也可以在更具体的域配置级别上设置或覆盖系统属性。
使用管理控制台设置系统属性
- 对于独立 JBoss EAP 服务器,您可以在管理控制台 Configuration 选项卡下配置系统属性。选择"系统属性" ,然后单击"查看 "按钮。
对于受管域:
- 域级系统属性可以在 Configuration 选项卡中设置。选择"系统属性" ,然后单击"查看 "按钮。
- 服务器组和服务器级系统属性可以在 Runtime 选项卡中设置。选择您要配置的服务器组或服务器,单击服务器组或服务器名称旁边的 View 按钮,然后选择系统属性选项卡。
- 主机级别系统属性可以在 Runtime 选项卡中设置。选择您要配置的主机,然后使用主机名旁边的下拉菜单选择属性。
使用 JAVA_OPTS 设置系统属性
系统属性也可以使用 JAVA_OPTS
环境变量进行配置。可以通过多种方式修改 JAVA_OPTS
,但 JBoss EAP 提供了用于设置 JBoss EAP 流程使用的 JAVA_OPTS
的配置文件。
对于单机服务器,此文件为 EAP_HOME/bin/standalone.conf
,或者对于受管域,它是 EAP_HOME/bin/domain.conf
。对于 Microsoft Windows 系统,这些文件具有 .bat
扩展名。
对于 RPM 安装,RPM 服务配置文件 是修改 JAVA_OPTS
以配置系统属性的首选位置。如需更多信息,请参阅配置 RPM 服务属性。
将您的系统属性定义添加到相关配置文件中的 JAVA_OPTS
中。以下示例演示了在 Red Hat Enterprise Linux 系统中设置绑定地址。
对于
standalone.conf
,请在文件的末尾添加JAVA_OPTS
系统属性定义。例如:... # Set the bind address JAVA_OPTS="$JAVA_OPTS -Djboss.bind.address=192.168.1.2"
对于
domain.conf
,必须在进程控制器JAVA_OPTS
设置之前设置JAVA_OPTS
。例如:... # Set the bind address JAVA_OPTS="$JAVA_OPTS -Djboss.bind.address=192.168.1.2" # The ProcessController process uses its own set of java options if [ "x$PROCESS_CONTROLLER_JAVA_OPTS" = "x" ]; then ...