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

7.2. JBoss EAP 7.x マネージドドメインの JBoss EAP 8.0 への移行

警告

JBoss Server Migration Tool を使用する場合は、ホストを移行する前にドメインコントローラーを移行して、ドメインコントローラーが使用する JBoss EAP のバージョンが、ホストが使用するバージョンよりも新しいことを確認してください。たとえば、JBoss EAP 7 で実行されているドメインコントローラーは、JBoss EAP 8.0 で実行されているホストを処理できません。

JBoss Server Migration Tool は、デフォルトで、マネージドドメイン設定を JBoss EAP 7 から JBoss EAP 8.0 に移行するときに次のタスクを実行します。

7.2.1. JBoss ドメインプロパティーの移行
リンクのコピー

ドメイン関連のプロパティー名の master と slave という単語は、'primary' と 'secondary' という単語に置き換えられました。この古いプロパティー名が使用されている場合、移行時に自動で修正されます。

コンソールには、移行によって名前が変更されたプロパティーが記録されます。 

  INFO JBoss domain property jboss.domain.master.address migrated to jboss.domain.primary.address
  INFO JBoss domain property jboss.domain.master.port migrated to jboss.domain.primary.port
  INFO JBoss domain property jboss.domain.master.protocol migrated to jboss.domain.primary.protocol

プロパティーの名前が正常に変更されると、次のメッセージが表示されます。 

  INFO JBoss domain properties migrated.

7.2.2. サポート対象外のサブシステムの削除
リンクのコピー

JBoss Server Migration Tool は、サポート対象外のすべてのサブシステム設定と拡張機能を、移行されたサーバー設定から削除します。このツールは各サブシステムとそれらの拡張をログファイルに記録し、削除時にコンソールに記録します。

注記

JBoss EAP 7.x でサポートされていないにもかかわらず、管理者がサーバーに追加したサブシステムは、JBoss EAP 8.0 でもサポートされず、削除されます。

サポート対象外のサブシステムの削除を省略するには、subsystems.remove-unsupported-subsystems.skip プロパティーを true に設定します。

JBoss Server Migration Tool のデフォルト動作を上書きし、以下の環境プロパティーを使用して移行中に含まれるサブシステムと拡張機能を指定することができます。

Expand
表7.2 サーバー移行の環境プロパティー
プロパティー名プロパティーの説明

extensions.excludes

決して移行すべきでない拡張機能のモジュール名のリスト (例: com.example.extension1、com.example.extension3)。

extensions.includes

常に移行する必要がある拡張機能のモジュール名のリスト (例: com.example.extension2、com.example.extension4)。

subsystems.excludes

決して移行すべきでないサブシステムの名前空間 (バージョンを除いたもの) のリスト (例: urn:jboss:domain:logging、urn:jboss:domain:ejb3)。

subsystems.includes

常に移行すべきサブシステムの名前空間 (バージョンを除いたもの) のリスト (例: urn:jboss:domain:security、urn:jboss:domain:ee)。

7.2.3. マネージドドメインの参照モジュールの移行
リンクのコピー

ソースサーバーからターゲットサーバーに移行される設定が、ターゲットサーバーにインストールされていないモジュールを参照したり、これに依存する可能性があります。JBoss Server Migration Tool はこれを検知し、参照されるモジュールと、その依存関係モジュールをソースサーバーからターゲットサーバーに自動的に移行します。

マネージドドメイン設定で参照されるモジュールは、以下のプロセスを使用して移行されます。

  • datasource サブシステム設定によって参照されるモジュールは、データソースドライバーモジュールとして移行されます。
  • ee サブシステム設定によって参照されるモジュールはグローバルモジュールとして移行されます。
  • naming サブシステム設定によって参照されるモジュールは、オブジェクトファクトリーモジュールとして移行されます。
  • messaging サブシステム設定によって参照されるモジュールは、Jakarta Messaging ブリッジモジュールとして移行されます。
  • ターゲット設定にインストールされていないエクステンションは、ターゲットサーバー設定に移行されます。

コンソールは、移行されるモジュールのモジュール ID を示すメッセージをログに記録します。modules.excludes 環境プロパティーにモジュール ID を指定して、特定モジュールの移行を除外できます。

7.2.4. マネージドドメインの参照パスの移行
リンクのコピー

ソースサーバーからターゲットサーバーへの移行される設定は、ターゲットサーバーにも移行する必要があるファイルパスとディレクトリーを参照したり、これらに依存する可能性があります。JBoss Server Migration Tool は、絶対パス参照を移行しません。ソース設定との関連として設定されるファイルやディレクトリーのみを移行します。コンソールは、移行される各パスを示すメッセージをログに記録します。

7.2.5. レガシーセキュリティーレルムの移行
リンクのコピー

JBoss EAP 8 はレガシーセキュリティーレルムフレームワークをサポートしません。JBoss Server Migration Tool は、デフォルトの JBoss EAP 8 Elytron を代わりに使用するように設定を移行します。

デフォルトのレガシーセキュリティードメインを使用していない場合は、Elytron を手動で設定する必要がある場合があります。

コンソールには、デフォルトの JBoss EAP 8 Elytron に移行した設定リソースが記録されます。 

 INFO  Legacy security XML configuration retrieved.
 WARN  Migrated Remoting subsystem's http connector resource /profile/full-ha/subsystem/remoting/http-connector/http-remoting-connector using a legacy security-realm, to Elytron's default application SASL Authentication Factory migration-defaultApplicationSaslAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem https-listener resource /profile/full-ha/subsystem/undertow/server/default-server/https-listener/https using a legacy security-realm, to Elytron's default TLS ServerSSLContext migration-defaultTLSServerSSLContext. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem http-invoker resource /profile/full-ha/subsystem/undertow/server/default-server/host/default-host/setting/http-invoker using a legacy security-realm, to Elytron's default Application HTTP AuthenticationFactory migration-defaultApplicationHttpAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 INFO  Legacy security realms migrated to Elytron.
 WARN  Migrated Remoting subsystem's http connector resource /profile/full/subsystem/remoting/http-connector/http-remoting-connector using a legacy security-realm, to Elytron's default application SASL Authentication Factory migration-defaultApplicationSaslAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem https-listener resource /profile/full/subsystem/undertow/server/default-server/https-listener/https using a legacy security-realm, to Elytron's default TLS ServerSSLContext migration-defaultTLSServerSSLContext. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem http-invoker resource /profile/full/subsystem/undertow/server/default-server/host/default-host/setting/http-invoker using a legacy security-realm, to Elytron's default Application HTTP AuthenticationFactory migration-defaultApplicationHttpAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 INFO  Legacy security realms migrated to Elytron.
 WARN  Migrated Remoting subsystem's http connector resource /profile/ha/subsystem/remoting/http-connector/http-remoting-connector using a legacy security-realm, to Elytron's default application SASL Authentication Factory migration-defaultApplicationSaslAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem https-listener resource /profile/ha/subsystem/undertow/server/default-server/https-listener/https using a legacy security-realm, to Elytron's default TLS ServerSSLContext migration-defaultTLSServerSSLContext. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem http-invoker resource /profile/ha/subsystem/undertow/server/default-server/host/default-host/setting/http-invoker using a legacy security-realm, to Elytron's default Application HTTP AuthenticationFactory migration-defaultApplicationHttpAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 INFO  Legacy security realms migrated to Elytron.
 WARN  Migrated Remoting subsystem's http connector resource /profile/default/subsystem/remoting/http-connector/http-remoting-connector using a legacy security-realm, to Elytron's default application SASL Authentication Factory migration-defaultApplicationSaslAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem https-listener resource /profile/default/subsystem/undertow/server/default-server/https-listener/https using a legacy security-realm, to Elytron's default TLS ServerSSLContext migration-defaultTLSServerSSLContext. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 WARN  Migrated Undertow subsystem http-invoker resource /profile/default/subsystem/undertow/server/default-server/host/default-host/setting/http-invoker using a legacy security-realm, to Elytron's default Application HTTP AuthenticationFactory migration-defaultApplicationHttpAuthenticationFactory. Please note that further manual Elytron configuration may be needed if the legacy security realm being used was not the source server's default Application Realm configuration!
 INFO  Legacy security realms migrated to Elytron.

7.2.6. レガシーセキュリティードメインの移行
リンクのコピー

JBoss EAP 8 はレガシーセキュリティードメインフレームワークをサポートしません。JBoss Server Migration Tool は、デフォルトの JBoss EAP 8 Elytron を代わりに使用するように設定を移行します。

デフォルトのレガシーセキュリティードメインを使用していなかった場合は、Elytron を手動で設定する必要がある場合があります。

コンソールには、デフォルトの JBoss EAP 8 Elytron に移行したすべての設定リソースが記録されます。 

 WARN  Migrated ejb3 subsystem resource /profile/default/subsystem/ejb3/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated undertow subsystem resource /profile/default/subsystem/undertow/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated ejb3 subsystem resource /profile/full/subsystem/ejb3/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated undertow subsystem resource /profile/full/subsystem/undertow/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated messaging-activemq subsystem server resource /profile/full/subsystem/messaging-activemq/server/default, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated iiop-openjdk subsystem resource using legacy security domain to Elytron defaults. Please note that further manual Elytron configuration should be needed!
 WARN  Migrated ejb3 subsystem resource /profile/ha/subsystem/ejb3/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated undertow subsystem resource /profile/ha/subsystem/undertow/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated ejb3 subsystem resource /profile/full-ha/subsystem/ejb3/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated undertow subsystem resource /profile/full-ha/subsystem/undertow/application-security-domain/other using legacy security domain other, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated messaging-activemq subsystem server resource /profile/full-ha/subsystem/messaging-activemq/server/default, to Elytron's default application Security Domain. Please note that further manual Elytron configuration may be needed if the legacy security domain being used was not the source server's default Application Domain configuration!
 WARN  Migrated iiop-openjdk subsystem resource using legacy security domain to Elytron defaults. Please note that further manual Elytron configuration should be needed!

7.2.7. keycloak サブシステムの移行
リンクのコピー

keycloak サブシステムは、JBoss EAP 8 ではサポートされず、elytron-oidc-client サブシステムに置き換えられます。

JBoss Server Migration Tool は、デフォルトでレガシーサブシステム設定を自動的に移行します。この移行タスクをスキップするには、subsystem.keycloak.migrate.skip 環境プロパティー値を true に設定します。

レガシーサブシステムの移行は、ユーザーの介入なしで実行されます。

レガシー keycloak サブシステムの移行が完了すると、移行コンソールに次のメッセージが表示されます。 

INFO  Subsystem keycloak migrated.

移行中に問題が発生した場合、その問題はログファイルに書き込まれ、移行コンソールに表示されます。

7.2.9. jgroups サブシステム設定の更新
リンクのコピー

JBoss Server Migration Tool は、jgroups サブシステム設定を自動的に移行しません。JBoss Server Migration Tool は、この設定をデフォルトの JBoss EAP 8 jgroups 設定に戻します。

デフォルトの JBoss EAP 8 jgroups サブシステム設定を使用していなかった場合は、jgroups サブシステム設定を手動で設定する必要がある場合があります。

jgroups サブシステム設定が更新されると、コンソールにメッセージが記録されます。 

 WARN  Configuration of JGroups protocols has been changed to match the default protocols of the target server. Please note that further manual configuration may be needed if the legacy configuration being used was not the source server's default configuration!

7.2.10. マネージドドメイン移行用のホスト除外設定の追加
リンクのコピー

JBoss EAP 8.0 ドメインコントローラーには、古いバージョンのサーバーで実行されているホストではサポートされていない機能が含まれている可能性があります。host-exclude 設定は、これらの旧バージョンから非表示にすべきリソースを指定します。

JBoss Server Migration Tool は、ドメインコントローラー設定を移行する際に、ソースサーバーの host-exclude 設定をターゲットの JBoss EAP 8.0 サーバーの設定に追加するか、その設定で置き換えます。

JBoss Server Migration Tool は host-exclude サブシステム設定を自動的に更新し、結果をログファイルとコンソールに記録します。 

  INFO  Host-excludes configuration added.

7.2.11. マネージドドメインのデプロイメントの移行
リンクのコピー

JBoss Server Migration Tool は、次に示すタイプのマネージドドメインのデプロイメント設定を移行できます。

  • サーバーが参照するデプロイメント。これは 永続的なデプロイメント とも呼ばれます。
  • サーバーが参照する デプロイメントオーバーレイ。

デプロイメントの移行は、ターゲットサーバーへの関連ファイルリソースのインストールと、移行した設定の更新から構成されます。

JBoss Server Migration Tool は、非対話モードで実行するとデフォルトでデプロイメントを省略するように事前設定されています。デプロイメントの移行を有効にするには、deployments.migrate-deployments.skip 環境プロパティーを false に設定します。

重要

JBoss Server Migration Tool を対話モードで実行し、無効な入力を入力した場合、その結果の動作は、deployments.migrate-deployments 環境プロパティーの値に依存することに注意してください。

  • deployments.migrate-deployments.skip を false に設定し、無効な入力を入力すると、このツールはデプロイメントの移行を試行します。
  • deployments.migrate-deployments.skip が true に設定され、無効な入力を入力すると、このツールはデプロイメントの移行を省略します。
警告

JBoss Server Migration Tool は、デプロイされたリソースがターゲットサーバーと互換性があるかどうかを判別しません。つまり、アプリケーションやリソースはデプロイされない可能性があり、期待通りに機能しないか、全く機能しない可能性があります。また、JBoss EAP 7.3 *-jms.xml 設定ファイルなどのアーティファクトは、変更なしでコピーされるため、JBoss EAP サーバーの起動時にエラーが発生する可能性があることにも注意してください。

Red Hat は、Migration Toolkit for Runtimes (MTR) を使用してデプロイメントを分析し、異なる JBoss EAP サーバー間の互換性を確認することを推奨します。詳細は、Migration Toolkit for Runtimes の製品ドキュメント を参照してください。

7.2.11.1. マネージドドメインの永続的なデプロイメントの移行
リンクのコピー

非対話モードでの実行時に永続的なデプロイメントを移行できるようにするには、deployments.migrate-persistent-deployments.skip 環境プロパティーを false に設定します。

JBoss Server Migration Tool は、すべての永続的なデプロイメント参照を検索し、それらをコンソールにリスト表示します。 

INFO  [ServerMigrationTask#67] Persistent deployments found: [cmtool-helloworld3.war, cmtool-helloworld4.war, cmtool-helloworld2.war, cmtool-helloworld1.war]

その後の処理ワークフローは、以下で説明するように、対話モード または 非対話モード でツールを実行しているかどうかによって異なります。

非対話モードでの永続的なデプロイメントの移行

非対話モードでツールを実行する場合、このツールは事前設定されたプロパティーを使用して、永続的なデプロイメントを移行するかどうかを決定します。永続的なデプロイメントは、deployments.migrate-deployments.skip および deployments.migrate-persistent-deployments.skip プロパティーが両方とも false に設定されている場合にのみ移行されます。

対話モードでの永続的なデプロイメントの移行

JBoss Server Migration Tool を対話モードで実行すると、次のワークフローに従ってデプロイメントごとにプロンプトが表示されます。

  1. 永続的なデプロイメントが検出されてコンソールに出力されると、次のプロンプトが表示されます。 

    This tool is not able to assert if persistent deployments found are compatible with the target server, skip persistent deployments migration?
yes/no?
    • 永続的なデプロイメントの移行を省略する場合は、yes で応答します。すべてのデプロイメント参照は移行された設定から削除され、移行プロセスが終了します。
    • 移行を続行するには、no と応答します。

  2. 続行する場合は、以下のプロンプトが表示されます。 

    Migrate all persistent deployments found?
yes/no?
    • 移行プロセスですべてのデプロイメントを自動的に移行し、終了させる場合は yes で応答します。
    • 移行を続行するには、no と応答します。

  3. 続行する場合には、参照される各デプロイメントの移行を確認するプロンプトが表示されます。 

    Migrate persistent deployment 'helloworld01.war'?
yes/no?
    • デプロイメントを移行するには yes で応答します。

    • 移行した設定からデプロイメントを削除するには、no で応答します。 

      INFO  [ServerMigrationTask#68] Removed persistent deployment from configuration /deployment=helloworld01.war

7.2.11.2. マネージドドメインのデプロイメントオーバーレイの移行
リンクのコピー

デプロイメントオーバーレイの移行は、完全に自動化されたプロセスです。deployments.migrate-deployments.skip 環境プロパティーを false に設定してデプロイメントの移行を有効にしている場合、JBoss Server Migration Tool は移行されたデプロイメントにリンクされているスタンドアロンサーバー設定で参照されるデプロイメントオーバーレイを検索します。見つかったものを自動的に移行し、参照されていないものを削除して、結果をそのログファイルおよびコンソールに記録します。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hatトップに戻る