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

1.4. JBoss EAP XP Manager 3.0 命令

JBoss EAP XP 管理器 3.0 提供了不同的命令来管理 JBoss EAP XP 补丁流并应用 JBoss EAP 7.4.x 基本补丁。

使用以下命令：

patch-apply

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

patch-apply 命令类似于 patch 应用 管理 CLI 命令。patch-apply 命令仅接受使用 工具应用补丁所需的参数。它为其他 patch 应用 管理 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 Manager 3.0 会执行验证以防止补丁和补丁流不匹配。以下示例演示了不正确的组合：

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

    java.lang.IllegalStateException: The JBoss EAP XP patch stream in the patch 'jboss-eap-xp-2.0' does not match the currently enabled JBoss EAP XP patch stream [jboss-eap-xp-3.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 3.0 补丁流设置的服务器上安装 JBoss EAP XP 3.0 补丁会导致以下错误： 

    java.lang.IllegalStateException: You are attempting to install a patch for the 'jboss-eap-xp-3.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

设置

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

当您使用 setup 命令时，JBoss EAP XP 管理器将执行以下操作：

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

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

    如果已安装旧配置文件，新文件将保存为目标配置目录中的时间戳副本，如 standalone-microprofile-yyyMMdd-HHmms.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 管理器命令.

使用 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 管理器执行以下操作：

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

  • 如果出现问题，JBoss EAP XP 管理器会尝试从它创建的备份中恢复之前的补丁流。

    您可以使用 --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返回顶部