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

JBoss EAP XP 5.0 升级和迁移指南

Red Hat JBoss Enterprise Application Platform 8.0

从 JBoss EAP XP 4.0.x 升级和迁移到 JBoss EAP XP 5.0 的指南

Red Hat Customer Content Services

摘要

本文档提供有关将 JBoss EAP XP 4.0.x 升级到 JBoss EAP XP 5.0 以及任何必要的应用程序迁移的信息。

使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息。

提供有关 JBoss EAP 文档的反馈
复制链接

要报告错误或改进文档，请登录到 Red Hat JIRA 帐户并提交问题。如果您没有 Red Hat Jira 帐户，则会提示您创建一个帐户。

流程

  1. 单击以下链接 以创建 ticket。
  2. 在 Summary 中输入问题的简短描述。
  3. 在 Description 中提供问题或功能增强的详细描述。包括一个指向文档中问题的 URL。
  4. 点 Submit 创建问题，并将问题路由到适当的文档团队。

第 1 章 JBoss EAP XP 升级
复制链接

1.1. 升级和迁移
复制链接

使用 JBoss EAP XP 5.0 升级和迁移指南中所述的步骤准备、升级和将您的 JBoss EAP XP 3.0 或 4.0 产品迁移到 JBoss EAP XP 5.0 产品。JBoss EAP XP 5.0 仅与 JBoss EAP 8.0 兼容。如果您在 JBoss EAP 7.4 上运行服务器，并且希望在其上安装 JBoss EAP XP 5.0，您必须首先将 JBoss EAP 7.4 实例升级到 JBoss EAP 8.0。

本指南参考可用于升级和迁移过程的工具。这些工具如下：

  • Migration Toolkit for Applications (MTA)
  • JBoss 服务器迁移工具

成功将 JBoss EAP XP 3.0 或 4.0 版本升级到 JBoss EAP XP 5.0 后，您可以开始为 JBoss EAP 8.0 实例实施任何应用程序迁移。

1.2. 准备升级和迁移
复制链接

升级 JBoss EAP 扩展包后，您可能必须更新应用程序代码。

对于 JBoss EAP XP 5.0，JBoss EAP XP 3.0 或 4.0 应用程序可能存在一些向后兼容性。但是，如果您的应用程序使用从 JBoss EAP XP 5.0 中删除的功能或功能，您可能需要更改应用程序代码。

在开始迁移过程前，请查看以下新项目：

  • JBoss EAP XP 功能添加到 JBoss EAP XP 5.0 版本中。
  • JBoss EAP XP 5.0 发行版本中添加的 MicroProfile 功能。
  • 对现有 MicroProfile 功能的增强。
  • JBoss EAP XP 5.0 中已弃用的功能和功能。
  • 从 JBoss EAP XP 5.0 中删除的功能和功能。
  • 您可以使用的工具从一个 EAP XP 版本迁移到另一个发行版本。

查看列出的项目后，分析您的环境并计划升级过程和迁移过程。确保您备份您计划迁移到 JBoss EAP XP 5.0 的任何应用程序。

现在，您可以将当前的 JBoss EAP XP 3.0 或 4.0 版本升级到 JBoss EAP XP 5.0。您可以在升级过程后实施任何应用程序迁移。

1.3. MicroProfile 功能的增强
复制链接

JBoss EAP XP 5.0 发行版本包括对以下 MicroProfile 6.1 组件的支持：

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile OpenAPI
  • MicroProfile Telemetry
  • MicroProfile REST 客户端

1.4. 弃用和不支持的 MicroProfile 功能
复制链接

在将应用程序迁移到 JBoss EAP XP 5.0 之前，请注意 JBoss EAP XP 4.0.x 中提供的一些功能可能已被弃用或不再被支持。

由于维护成本高、社区兴趣低和更好的替代解决方案，红帽消除了对某些技术的支持。

确保您查看 Red Hat JBoss EAP XP 5.0 发行注记，以及 Red Hat JBoss Enterprise Application Platform 8.0 的发行注记，以了解不支持和已弃用的功能。

您可以选择以下工具之一来升级 JBoss EAP XP 3.0 或 4.0 产品，并将其迁移到 JBoss EAP XP 5.0 产品：

  • Migration Toolkit for Applications (MTA)
  • JBoss 服务器迁移工具

在更新服务器配置时使用 JBoss 服务器迁移工具，使其包含 JBoss EAP XP 5.0 的新功能和设置。您可以保留现有的 JBoss EAP XP 3.0 或 4.0 服务器配置，只要 JBoss EAP XP 5.0 支持配置。

JBoss 服务器迁移工具读取您现有的 JBoss EAP XP 3.0 或 4.0 服务器配置文件，并将任何新的必要子系统添加到这些文件。该工具还使用新功能更新现有的子系统配置，并删除任何过时的子系统配置。

您可以使用 JBoss 服务器迁移工具为 JBoss EAP XP 5.0 配置迁移单机服务器。

JBoss EAP XP 5.0 不包含 JBoss 服务器迁移工具，因此您需要从 JBoss EAP XP 下载页面 下载 工具。

Migration Toolkit for Applications (MTA)包括可扩展且可自定义的基于规则的工具，简化了 Jakarta 应用程序的迁移。您可以使用工具包来分析应用程序的 API、技术和架构。工具包为计划从 JBoss EAP XP 3.0 或 4.0 迁移到 JBoss EAP XP 5.0 的应用程序提供报告。

MTA 报告输出以下信息：

  • 所有必需的迁移更改的详细解释。
  • 更改是强制的还是可选。
  • 改变是复杂还是简单。
  • 到需要迁移更新的代码链接。
  • 用于帮助您完成所需迁移更改的信息提示和链接。
  • 估算发现的每个迁移问题的工作量程度以及迁移应用程序的总预计工作量。

在将 JBoss EAP XP 3.0 或 4.0 应用程序的代码和架构迁移到 JBoss EAP XP 5.0 之前，您还可以使用 MTA 来分析它们。在迁移到 JBoss EAP XP 5.0 时，用于将应用程序从 JBoss EAP XP 3.0 或 4.0 迁移到 JBoss EAP XP 5.0 的 MTA 规则集，报告了 XML 描述符、特定应用程序代码和参数，您需要替换为替代配置。

第 3 章 应用程序迁移
复制链接

您可以将为较旧版本的 JBoss EAP XP 创建的应用程序迁移到 JBoss EAP XP 5.0。

3.1. MicroProfile 应用程序迁移
复制链接

MicroProfile 6.1 与 Jakarta EE 10 核心配置文件一致，并引入 MicroProfile 遥测，取代 MicroProfile OpenTracing。

MicroProfile 6.1 包含所有主要 MicroProfile 规范的更新。

以下规格可能包含 MicroProfile 6.1 的 API 不兼容的更改：

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile OpenAPI

您必须将使用这些规格的应用程序更新至最新的 Jakarta EE 10 规范。

您可以通过选择以下任一方法将应用更新至 MicroProfile 6.1：

  • 将 MicroProfile 6.1 依赖项添加到项目的 pom.xml 文件中。
  • 使用 JBoss EAP XP BOM 将支持的工件导入到项目的 pom.xml 文件的 JBoss EAP XP 依赖项管理。

JBoss EAP XP 5.0 不支持 MicroProfile OpenTracing，并由 OpenTelemetry tracing 替代。

要将 MicroProfile OpenTracing 替换为 OpenTelemetry Tracing，请按照以下步骤执行：

  • 将依赖项 org.eclipse.microprofile.opentracing:microprofile-opentracing-api 替换为 io.opentelemetry:opentelemetry-api 和 io.opentelemetry:opentelemetry-context。
  • 将 org.eclipse.microprofile.opentracing Java 软件包的使用替换为 io.opentelemetry Java 软件包。这种替换可能涉及对类和方法进行其他更改。

3.3. 从 MicroProfile 指标迁移到 Micrometer
复制链接

JBoss EAP XP 5.0 不支持 MicroProfile 指标，并被 Micrometer 替代。

要将 MicroProfile 指标替换为 Micrometer，请按照以下步骤执行：

  • 将依赖项 org.eclipse.microprofile.metrics:microprofile-metrics-api 替换为 io.micrometer:micrometer-core。
  • 将 org.eclipse.microprofile.metric Java 软件包的使用替换为 io.micrometer Java 软件包。这种替换可能涉及对类和方法进行其他更改。

法律通告
复制链接

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat返回顶部