2.3. 管理 CLI
command CLI 命令的增强
CLI 命令 command 具有一个新的 --node-child 参数,您可以使用该参数编辑属性或管理特定子节点的操作。
在使用 --node-child 参数之前,请检查管理模式中是否存在子节点。
使用 command add --node-child --help CLI 命令查看 --node-child 参数的描述。
新角色解码器添加到 elytron 子系统
在 JBoss EAP 7.4 中,您可以使用管理 CLI 将 source-address-role-decoder 角色解码器添加到 elytron 子系统。通过在 mappers 元素中配置此角色解码器,您可以在做出授权决策时从远程客户端获取更多信息。
您可以为 source-address-role-decoder 配置以下属性:
| 属性 | 描述 |
|---|---|
|
| 指定远程客户端的 IP 地址或要匹配的远程客户端 IP 地址的正则表达式。 |
|
| 指定远程客户端的 IP 地址。 |
|
|
如果远程客户端的 IP 地址与 |
为受管执行器服务公开运行时统计信息
在之前的 JBoss EAP 发行版中,在 ee 子系统中不提供运行时统计数据,无法用于受管执行器服务。
现在,您可以通过查看使用新的管理 CLI 属性生成的运行时统计信息来监控受管 executor 服务的性能。添加了以下管理 CLI 属性:
-
active-thread-count:主动执行任务的近似线程数 -
completed-task-count:已完成执行的任务大约总数 -
hung-thread-count: 挂起的 executor 线程数 -
max-thread-count: executor 线程的最大数量 -
current-queue-size:executor 任务队列的当前大小 -
task-count:已提交过的任务总数 -
thread-count:当前执行器线程数
终止挂起的任务
您现在可以手动尝试终止 EE 子系统中的挂起任务。要做到这一点,请运行以下命令:
/subsystem=ee/managed-executor-service=default:terminate-hung-tasks()
/subsystem=ee/managed-executor-service=default:terminate-hung-tasks()
一个新的属性 hung-task-termination-period 添加到 managed-executor-service
您现在可以自动尝试终止 EE 子系统中的挂起任务。为实现这一目标,新属性 hung-task-termination-period 添加到 managed-scheduled-executor-service 资源中。
-
hung-task-termination-period:以毫秒为单位尝试挂起的任务、通过取消此类任务并中断其执行的线程而自动终止的时间。如果值为 0(默认值),则不会取消挂起的任务。
对权限文件使用属性替换
从 JBoss EAP 6 升级到 JBoss EAP 7 的用户无法将 Java 策略文件中的文件权限迁移到 permissions.xml 或 jboss-permissions.xml 文件。无法使用属性替换在 permissions.xml 和 jboss-permissions.xml 文件中迁移文件权限。
现在,您可以对 permissions.xml 和 jboss-permissions.xml 文件使用属性替换。
使用 ee 子系统中的 jboss-descriptor-property-replacement 和 spec-descriptor-property-replacement 属性可以启用或禁用 jboss-permissions.xml 和 permissions.xml 文件的属性替代。
配置 RESTEasy 参数
您现在可以使用 JBoss EAP 管理 CLI 更改 RESTEasy 参数的设置。全局更改会将更新的设置作为 web.xml 上下文参数应用到新部署。
您可以使用管理 CLI 中的 /subsystem=jaxrs 资源使用 :write-attribute 操作来修改参数的设置。例如:
/subsystem=jaxrs:write-attribute(name=resteasy-add-charset, value=false)
/subsystem=jaxrs:write-attribute(name=resteasy-add-charset, value=false)
当您更改参数的设置时,更新的设置仅适用于新部署。重新启动服务器,以将新设置应用到当前部署。
有关 RESTEasy 元素的详情,请参阅 RESTEasy 配置参数表。
配置 RESTEasy 供应商
在 RESTEasy 中,某些内置提供程序默认为启用。您现在可以在 JBoss EAP 管理 CLI 中使用新的 RESTEasy 参数 resteasy.disable.providers 来禁用特定的内置提供程序。
以下示例演示了如何禁用内置供应商 FileProvider :
/subsystem=jaxrs:write-attribute(name=resteasy-disable-providers, value=[org.jboss.resteasy.plugins.providers.FileProvider])
/subsystem=jaxrs:write-attribute(name=resteasy-disable-providers, value=[org.jboss.resteasy.plugins.providers.FileProvider])
您可以将 resteasy.disable.providers 参数与预先存在的参数 resteasy.use.builtin.providers 搭配使用,以自定义应用到所有新部署的特定供应商配置。
当您更改 resteasy.disable.providers 参数的设置时,更新的设置只适用于新部署。重新启动服务器,以将新设置应用到当前部署。