Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

1.4. JBoss EAP XP manager 4.0 命令

JBoss EAP XP 管理器 4.0 提供了不同的命令来管理 JBoss EAP XP 补丁流。

提供以下命令：

patch-apply

使用此命令将补丁应用到您的 JBoss EAP 安装。

patch-apply 命令与 patch apply 管理 CLI 命令类似。patch-apply 命令只接受使用工具应用补丁所需的参数。它将默认值用于其他 补丁应用 管理 CLI 命令参数。

您可以使用 patch-apply 命令将补丁应用到服务器上启用的任何补丁流。您还可以使用 命令应用基本服务器补丁和 XP 补丁。

使用 patch-apply 命令的示例：

$ java -jar jboss-eap-xp-manager.jar patch-apply --jboss-home=/PATH/TO/EAP --patch=/PATH/TO/PATCH/jboss-eap-7.3.4-patch.zip
Copy to Clipboard Toggle word wrap

应用 XP 补丁时，JBoss EAP XP 管理器 4.0 会执行验证，以防止补丁和补丁流不匹配。以下示例演示了不正确的组合：

  • 在设置了 XP 4.0 补丁流的服务器上安装 JBoss EAP XP 3.0 补丁会导致以下错误： 

    java.lang.IllegalStateException: The JBoss EAP XP patch stream in the patch 'jboss-eap-xp-3.0' does not match the currently enabled JBoss EAP XP patch stream [jboss-eap-xp-4.0]
	at org.jboss.eap.util.xp.patch.stream.manager.ManagerPatchApplyAction.doExecute(ManagerPatchApplyAction.java:33)
	at org.jboss.eap.util.xp.patch.stream.manager.ManagerAction.execute(ManagerAction.java:40)
	at org.jboss.eap.util.xp.patch.stream.manager.ManagerMain.main(ManagerMain.java:50)
    Copy to Clipboard Toggle word wrap

  • 尝试在未为 JBoss EAP XP 4.0.0 补丁流设置的服务器上安装 JBoss EAP XP 4.0.0 补丁程序会导致以下错误： 

    java.lang.IllegalStateException: You are attempting to install a patch for the 'jboss-eap-xp-4.0' JBoss EAP XP Patch Stream. However this patch stream is not yet set up in the JBoss EAP server. Run the 'setup' command to enable the patch stream.
	at org.jboss.eap.util.xp.patch.stream.manager.ManagerPatchApplyAction.doExecute(ManagerPatchApplyAction.java:29)
	at org.jboss.eap.util.xp.patch.stream.manager.ManagerAction.execute(ManagerAction.java:40)
	at org.jboss.eap.util.xp.patch.stream.manager.ManagerMain.main(ManagerMain.java:50)
    Copy to Clipboard Toggle word wrap

    在这两种情况下，不会对服务器进行任何更改。

remove

使用此命令从 JBoss EAP 服务器中删除 JBoss EAP XP 补丁流设置。

使用 remove 命令的示例

$ java -jar jboss-eap-xp-manager.jar remove --jboss-home=/PATH/TO/EAP
Copy to Clipboard Toggle word wrap

setup

使用此命令为 JBoss EAP XP 补丁流设置干净的 JBoss EAP 服务器。

使用 setup 命令时，JBoss EAP XP manager 执行以下操作：

  • 启用 JBoss EAP XP 4.0.0 补丁流。
  • 应用使用 --base-patch 和 --xp-patch 属性指定的补丁。

  • 将 standalone-microprofile.xml 和 standalone-microprofile-ha.xml 配置文件复制到服务器配置目录中。

    如果已安装较旧的配置文件，新文件将保存为目标配置目录中的时间戳副本，如 standalone-microprofile-yyyyMMdd-HHmmss.xml。

    您可以使用 --jboss-config-directory 参数设置目标目录。

使用 setup 命令的示例

$ java -jar jboss-eap-xp-manager.jar setup --jboss-home=/PATH/TO/EAP
Copy to Clipboard Toggle word wrap

status

使用此命令查找 JBoss EAP XP 服务器的当前状态。status 命令返回以下信息：

  • JBoss EAP XP 流的状态。
  • 由于当前状态处于当前状态，任何支持策略都会改变。
  • JBoss EAP XP 的主版本。
  • 启用补丁流及其累积补丁 ID。
  • 可用的 JBoss EAP XP manager 命令更改状态。

使用 status 命令的示例

$ java -jar jboss-eap-xp-manager.jar status --jboss-home=/PATH/TO/EAP
Copy to Clipboard Toggle word wrap

Upgrade （升级）

使用此命令将旧的 JBoss EAP XP 补丁流升级到 JBoss EAP 服务器的最新补丁流。

使用 upgrade 命令时，JBoss EAP XP manager 会执行以下操作：

  • 创建文件的备份，启用服务器中的旧补丁流。
  • 启用 JBoss EAP XP 4.0 补丁流。
  • 应用使用 --base-patch 和 --xp-patch 属性指定的补丁。
  • 将 standalone-microprofile.xml 和 standalone-microprofile-ha.xml 配置文件复制到服务器配置目录中。如果已安装较旧的配置文件，新文件将保存为目标配置目录中的时间戳副本，如 standalone-microprofile-yyyyMMdd-HHmmss.xml。

  • 如果出现错误，JBoss EAP XP Manager 会尝试从创建的备份中恢复以前的补丁流。

    您可以使用 --jboss-config-directory 参数设置目标目录

使用 upgrade 命令的示例：

$ java -jar jboss-eap-xp-manager.jar upgrade --jboss-home=/PATH/TO/EAP
Copy to Clipboard Toggle word wrap

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部