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}"/>

<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

$ 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=PROPERTY_NAME:add(value=PROPERTY_VALUE)

例如：

/system-property=jboss.bind.address:add(value=192.168.1.2)

/system-property=jboss.bind.address:add(value=192.168.1.2)

使用管理 CLI 设置系统属性时，某些 JBoss EAP 选项（包括上述 jboss.bind.address 示例）仅在下一次服务器重启后生效。

对于受管域，上例为整个域配置系统属性，但您也可以在更具体的域配置级别上设置或覆盖系统属性。

使用管理控制台设置系统属性

使用 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 扩展名。

将您的系统属性定义添加到相关配置文件中的 JAVA_OPTS 中。以下示例演示了在 Red Hat Enterprise Linux 系统中设置绑定地址。

使用 MODULE_OPTS 环境变量添加 Java 代理

您可以使用 MODULE_OPTS=-javaagent:my-agent.jar 环境变量直接将 Java 代理添加到 JBoss 模块，而无需编辑启动脚本。这会在配置日志记录后初始化代理。在以前的版本中，引导类路径需要日志管理器。

在单机服务器中，您可以在以下文件中设置 MODULE_OPTS 环境变量：

对于域中的服务器，您可以将 module-options 属性添加到主机 JVM 配置或服务器 JVM 配置中。