Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

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 にアップグレードし、必要なアプリケーションの移行に関する情報を提供します。

多様性を受け入れるオープンソースの強化
リンクのコピー

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

JBoss EAP ドキュメントへのフィードバック (英語のみ)
リンクのコピー

エラーを報告したり、ドキュメントを改善したりするには、Red Hat Jira アカウントにログインし、課題を送信してください。Red Hat Jira アカウントをお持ちでない場合は、アカウントを作成するように求められます。

手順

  1. このリンクをクリック してチケットを作成します。
  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 Server Migration Tool

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 5.0 リリースに追加された JBoss EAP XP 機能。
  • 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 のサポートが削除されました。

サポートされていない機能や非推奨の機能は、Red Hat JBoss EAP XP 5.0 リリースノート と Red Hat JBoss Enterprise Application Platform 8.0 のリリースノート を必ず確認してください。

第2章 JBoss EAP XP 3.0 または 4.0 サーバーから JBoss EAP XP 5.0 サーバーに移行するツール
リンクのコピー

以下のツールのいずれかを選択して、JBoss EAP XP 3.0 または 4.0 製品を JBoss EAP XP 5.0 製品にアップグレードおよび移行できます。

  • Migration Toolkit for Applications (MTA)
  • JBoss Server Migration Tool

2.1. JBoss Server Migration Tool を使用したサーバー設定の移行
リンクのコピー

サーバー設定を更新して JBoss EAP XP 5.0 の新機能および設定を追加する場合は、JBoss Server Migration Tool を使用します。JBoss EAP XP 3.0 または 4.0 が設定に対応していると、既存の JBoss EAP XP 5.0 サーバー設定を保持することができます。

JBoss Server Migration Tool は既存の JBoss EAP XP 3.0 または 4.0 サーバー設定ファイルを読み取り、必要な新しいサブシステムをこれらのファイルに追加します。このツールは、既存のサブシステム設定を新機能で更新し、廃止されているサブシステム設定を削除します。

JBoss Server Migration Tool を使用して、JBoss EAP XP 5.0 設定のスタンドアロンサーバーを移行できます。

JBoss EAP XP 5.0 には JBoss Server Migration Tool が含まれていないため、JBoss EAP XP ダウンロードページ からツールをダウンロードする必要があります。

2.2. Migration Toolkit for Applications を使用して移行用にアプリケーションを分析
リンクのコピー

Migration Toolkit for Applications (MTA) には、Jakarta アプリケーションの移行を簡素化する拡張可能かつカスタマイズ可能なルールベースのツールが含まれています。ツールキットを使用して、アプリケーションの API、テクノロジー、およびアーキテクチャーを分析します。ツールキットは、JBoss EAP XP 3.0 または 4.0 から JBoss EAP XP 5.0 に移行する予定のアプリケーションのレポートを提供します。

MTA は、以下の情報を出力します。

  • 必要なすべての移行変更の詳細な説明。
  • 変更が必須または任意であるかどうか。
  • 変更が複雑または単純であるかどうか。
  • 移行更新を必要とするコードへのリンク。
  • 必要な移行変更を完了するのに役立つヒントおよび情報へのリンク。
  • 見つかった個々の移行問題の推定作業量レベルおよびアプリケーションを移行するための推定合計作業量。

MTA を使用して、JBoss EAP XP 3.0 または 4.0 アプリケーションのコードおよびアーキテクチャーを分析してから JBoss EAP XP 5.0 に移行することもできます。アプリケーションを JBoss EAP XP 3.0 または 4.0 から JBoss EAP XP 5.0 へ移行する MTA ルールセットは、JBoss EAP XP 5.0 に移行する際に別の設定に置き換える必要がある XML 記述子、特定のアプリケーションコード、およびパラメーターで報告します。

第3章 アプリケーションの移行
リンクのコピー

以前のリリースの JBoss EAP XP 用に作成されたアプリケーションを JBoss EAP XP 5.0 に移行できます。

3.1. MicroProfile アプリケーションの移行
リンクのコピー

MicroProfile 6.1 は、Jakarta EE 10 Core Profile に準拠し、MicroProfile OpenTracing に代わる MicroProfile Telemetry を導入しています。

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 依存関係管理にインポートします。

3.2. MicroProfile OpenTracing から OpenTelemetry Tracing への移行
リンクのコピー

MicroProfile OpenTracing は JBoss EAP XP 5.0 ではサポートされておらず、OpenTelemetry トレースに置き換えられています。

MicroProfile OpenTracing を OpenTelemetry Tracing に置き換えるには、次の手順に従います。

  • 依存関係 org.eclipse.microprofile.opentracing:microprofile-opentracing-api を io.opentelemetry:opentelemetry-api および io.opentelemetry:opentelemetry-context に置き換えます。
  • Java パッケージ org.eclipse.microprofile.opentracing の使用を Java パッケージ io.opentelemetry に置き換えます。このような置き換えには、クラスやメソッドへの追加の変更が必要になる場合があります。

3.3. MicroProfile メトリクスから Micrometer への移行
リンクのコピー

MicroProfile メトリクスは JBoss EAP XP 5.0 ではサポートされておらず、Micrometer に置き換えられています。

MicroProfile メトリクスを Micrometer に置き換えるには、次の手順に従います。

  • 依存関係 org.eclipse.microprofile.metrics:microprofile-metrics-api を io.micrometer:micrometer-core に置き換えます。
  • Java パッケージ org.eclipse.microprofile.metric の使用を Java パッケージ io.micrometer に置き換えます。このような置き換えには、クラスやメソッドへの追加の変更が必要になる場合があります。

法律上の通知
リンクのコピー

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

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る