第6章 JBoss EAP 6.4 設定の JBoss EAP 7.3 への移行

6.1. JBoss EAP 6.4 スタンドアロンサーバーの JBoss EAP 7.3 への移行

JBoss Server Migration Tool はデフォルトで、スタンドアロンサーバー設定を JBoss EAP 6.4 から JBoss EAP 7.3 に移行するときに以下のタスクを実行します。

6.1.1. 非対応のサブシステムの削除

以下の JBoss EAP 6.4 サブシステムは JBoss EAP 7 ではサポートされません。

サブシステム名設定名前空間拡張モジュール

cmp

urn:jboss:domain:cmp:*

org.jboss.as.cmp

configadmin

urn:jboss:domain:configadmin:*

org.jboss.as.configadmin

jaxr

urn:jboss:domain:jaxr:*

org.jboss.as.jaxr

osgi

urn:jboss:domain:osgi:*

org.jboss.as.osgi

threads

urn:jboss:domain:threads:*

org.jboss.as.threads

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

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

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

プロパティー名プロパティーの説明

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)

6.1.2. 参照済みモジュールの移行

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

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

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

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

6.1.3. 参照パスの移行

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

JBoss Server Migration Tool は以下のパス参照を自動的に移行します。

  • vault キーストアおよび暗号化されたファイルのディレクトリー。

参照パスの移行を省略するには、paths.migrate-paths-requested-by-configuration.vault.skip 環境プロパティーを true に設定します。

6.1.4. Jacorb サブシステムの移行

jacorb サブシステムは JBoss EAP 7 で非推奨となり、iiop-openjdk サブシステムに置き換えられました。デフォルトでは、JBoss Server Migration Tool は自動的に jacorb サブシステム設定を置換の iiop-openjdk サブシステム設定に移行し、結果をログファイルとコンソールに記録します。

iiop-openjdk サブシステム設定への自動移行を省略するには、subsystem.jacorb.migrate.skip 環境プロパティーの値を true に設定します。

6.1.5. Web サブシステムの移行

web サブシステムは JBoss EAP 7 で非推奨となり、undertow サブシステムに置き換えられました。デフォルトでは、JBoss Server Migration Tool は web サブシステム設定を代替の undertow サブシステム設定に自動的に移行し、結果をログファイルとコンソールに記録します。

web サブシステムの自動移行を省略するには、subsystem.web.migrate.skip 環境変数の値を true に設定します。

6.1.6. messaging サブシステムの移行

messaging サブシステムは JBoss EAP 7 で非推奨となり、messaging-activemq サブシステムに置き換えられました。JBoss Server Migration Tool は自動的に messaging サブシステム設定を代替の messaging-activemq サブシステム設定に移行し、結果をログファイルとコンソールに記録します。

messaging サブシステムの自動移行を省略するには、subsystem.messaging.migrate.skip 環境プロパティーの値を true に設定します。

6.1.7. Infinispan サブシステムの更新

JBoss Server Migration Tool は、デフォルトの JBoss EAP 7.3 設定に合わせて infinispan サブシステム設定を更新します。

  • JBoss EAP 7.3 のデフォルト設定にある EJB キャッシュコンテナーが、まだ含まれていない設定に追加されます。
  • JBoss EAP 7.3 のデフォルト設定にあるサーバーキャッシュコンテナーを追加します。
  • Hibernate キャッシュコンテナー設定でモジュール名を更新します。
  • JBoss EAP 7.3 のデフォルト設定にある web キャッシュコンテナーに同時キャッシュを追加します。

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

以下の環境プロパティーを設定して、infinispan システムの更新をカスタマイズできます。

プロパティー名プロパティーの説明

subsystem.infinispan.update.skip

true に設定した場合は、infinispan サブシステムの更新を省略します。

subsystem.infinispan.update.add-infinispan-ejb-cache.skip

true に設定した場合は、EJB キャッシュコンテナーを追加しません。

subsystem.infinispan.update.add-infinispan-server-cache.skip

true に設定した場合は、サーバーのキャッシュコンテナーを追加しません。

subsystem.infinispan.update.fix-hibernate-cache-module-name.skip

true に設定した場合は、Hibernate キャッシュコンテナー設定のモジュール名を更新しません。

subsystem.infinispan.update-infinispan-web-cache

true に設定した場合は、同時キャッシュを web キャッシュコンテナー設定に追加しません。

6.1.8. EE サブシステムの更新

JBoss Server Migration Tool は ee サブシステムを更新し、JBoss EAP 7.3 でサポートされる Jakarta EE 機能を設定します。

  • JBoss EAP 7.3 のデフォルト設定にある container-managed executors などの Jakarta EE コンカレンシーユーティリティーのインスタンスを設定し、結果をログファイルおよびコンソールに記録します。

  • これは、デフォルトの JBoss EAP 6.4 設定にあるデフォルトのデータソースなどのデフォルトのリソースを定義します。リソースが見つからなかった場合、ツールは設定の利用可能な全リソースを一覧表示し、一覧からリソースを選択するか、デフォルトとして設定する必要のあるリソースの Java Naming and Directory Interface アドレスを示すプロンプトを提供します。

    注記

    指定した Java Naming and Directory Interface 名が有効であると想定されます。Java Naming and Directory Interface 名はツールによって検証されません。

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

以下の環境プロパティーを設定して、ee システムの更新をカスタマイズできます。

プロパティー名プロパティーの説明

subsystem.ee.update.skip

true に設定すると、ee サブシステムの更新を省略します。

subsystem.ee.update.setup-ee-concurrency-utilities.skip

true に設定すると、コンカレンシーユーティリティーのデフォルトインスタンスを追加しません。

subsystem.ee.update.setup-javaee7-default-bindings.skip

true に設定すると、Java EE のデフォルトリソースをセットアップしません。

subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceName

ソース設定で検索するデフォルトデータソースの名前を指定します。

subsystem.ee.update.setup-javaee7-default-bindings.defaultDataSourceJndiName

デフォルトデータソースの Java Naming and Directory Interface 名を指定します。

subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryName

デフォルトの Java Messaging Service 接続ファクトリーの名前を指定します。

subsystem.ee.update.setup-javaee7-default-bindings.defaultJmsConnectionFactoryJndiName

デフォルトの Java Messaging Service 接続ファクトリーの Java Naming and Directory Interface 名を指定します。

EE サブシステムでのコンカレンシーユーティリティーの設定

Jakarta EE コンカレンシーユーティリティーの設定を選択すると、このツールはデフォルトの JBoss EAP 7.3 設定にあるインスタンスを自動的に設定し、結果をログファイルおよびコンソールに記録します。 

INFO  [ServerMigrationTask#49] Default ContextService added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedThreadFactory added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedExecutorService added to EE subsystem configuration.
INFO  [ServerMigrationTask#49] Default ManagedScheduledExecutorService added to EE subsystem configuration.

EE サブシステムでのデフォルトリソースの設定

Java EE のデフォルトリソースを定義するとき、このツールはデフォルトの JBoss EAP 7.3 設定にあるリソースを自動的に選択します。 

INFO  [ServerMigrationTask#50] Java EE Default Datasource configured with Java Naming and Directory Interface and name java:jboss/datasources/ExampleDS.

デフォルトリソースが見つからない場合、ツールは設定で利用可能なすべてのリソースを一覧表示し、デフォルトのリソースを選択するか、デフォルトとして設定する必要のあるリソースの Java Naming and Directory アドレスを示すプロンプトを提供します。

以下は、ExampleDS データソースの設定ファイルを移行する際に発生する対話例です。 

INFO  [ServerMigrationTask#22] Default datasource not found.
0. ExampleDS
1. Unconfigured data source, I want to enter the Java Naming and Directory Interface name...
Please select Java EE's Default Datasource: (0): 0
INFO  [ServerMigrationTask#22] Java EE Default Datasource configured with Java Naming and Directory Interface name java:jboss/datasources/ExampleDS.

Save this Java EE Default Datasource Java Naming and Directory Interface name and use it when migrating other config files?
yes/no? y
注記

非対話モードで JBoss Server Migration Tool を実行し、デフォルトの Java Messaging Service 接続ファクトリーなどの JBoss EAP 6.4 のデフォルトリソースが利用できない場合、このツールはこれらのリソースを設定しません。

6.1.9. EJB 3 サブシステムの更新

JBoss Server Migration Tool は、デフォルトの JBoss EAP 7.3 設定と整合するために ejb3 サブシステムに以下の更新を行います。

  • HTTP コネクターを参照するリモートサービス設定を更新します。
  • default-sfsb-cache を使用するように default-sfsb-passivation-disabled-cache 属性を設定します。
  • これは、レガシーパッシベーションストアおよびキャッシュ設定を JBoss EAP 7.3 のデフォルト値に置き換えます。

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

ejb3 サブシステム設定の更新に成功すると、JBoss Server Migration Tool は結果をログファイルとコンソールに記録します。 

 INFO  Subsystem ejb3 updated.

以下の環境プロパティーを設定して、ejb3 システムの更新をカスタマイズできます。

プロパティー名プロパティーの説明

subsystem.ejb3.update.skip

true に設定した場合は、ejb3 サブシステムの更新を省略します。

subsystem.ejb3.update.add-infinispan-passivation-store-and-distributable-cache.skip

true に設定した場合は、passivation-store および cache 設定を置き換えないでください。

subsystem.ejb3.update.setup-default-sfsb-passivation-disabled-cache.skip

true に設定した場合は、default-sfsb-passivation-disabled-cache 設定を更新しないでください。

subsystem.ejb3.update.activate-ejb3-remoting-http-connector.skip

true に設定した場合は、EJB リモーティング設定を更新しないでください。

6.1.10. JGroups サブシステムの更新

JBoss Server Migration Tool は jgroups サブシステムを更新し、JBoss EAP 7.3 の設定と一致させます。

  • これは MERGE2 プロトコルを MERGE3 に置き換えます。
  • これは FD プロトコルを FD_ALL に置き換えます。
  • これは pbcast.NAKACK プロトコルを pbcast.NAKACK2 に置き換えます。
  • これは、UNICAST2 プロトコルを UNICAST3 に置き換えます。
  • RSVP プロトコルを削除します。
  • これは、FRAG2 プロトコルを FRAG3 プロトコルに置き換えます。

jgroups サブシステム設定の移行に成功すると、JBoss Server Migration Tool は結果をログファイルとコンソールに記録します。 

 INFO  Subsystem jgroups updated.

jgroups サブシステムの自動移行を省略するには、subsystem.jgroups.update.skip プロパティーを true に設定します。

6.1.11. Remoting サブシステムの更新

JBoss EAP 7 には、単一のポートを使用してすべてのレガシーリモーティングプロトコルおよびポートを置き換える HTTP コネクターが含まれています。JBoss Server Migration Tool は、HTTP コネクターを使用するように remoting サブシステムを自動的に更新します。

remoting サブシステムの設定の自動更新を省略するには、subsystem.remoting.update.skip 環境プロパティーを true に設定します。

6.1.12. transaction サブシステムの更新

JBoss Server Migration Tool は、JBoss EAP 7.3 サーバーに必要な設定変更で transactions サブシステムを更新します。

JBoss Server Migration Tool は、transactions サブシステムから path および relative-to 属性を削除し、それらを同等の object-store-path および object-store-relative-to 属性に置き換えます。

transactions の自動更新をスキップするには、subsystem.transactions.update-xml-object-store-paths.skip 環境プロパティーを true に設定します。

6.1.13. Undertow サブシステムの調整

JBoss EAP 7.3 の web サブシステムを移行する他に、JBoss Server Migration Tool は代替の undertow サブシステムを更新し、サポートする機能を追加します。

  • これは、デフォルトの HTTP リスナーのリダイレクトソケットを設定します。
  • Jakarta WebSocket のサポートが追加されました。
  • デフォルトの HTTPS リスナーを設定します。
  • HTTP2 のサポートを追加します。
  • Server 応答ヘッダーを削除します。
  • X-Powered-By 応答ヘッダーを削除します。
  • これは、デフォルトの HTTP Invoker を設定します。

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

undertow サブシステム設定の移行に成功すると、JBoss Server Migration Tool は結果をログファイルとコンソールに記録します。 

 INFO  Subsystem undertow updated.

以下の環境プロパティーを設定して、undertow システムの更新をカスタマイズできます。

プロパティー名プロパティーの説明

subsystem.undertow.update.skip

true に設定した場合は、undertow サブシステムの更新を省略します。

subsystem.undertow.update.set-default-http-listener-redirect-socket.skip

true に設定する場合は、デフォルトの HTTP リスナーのリダイレクトソケットを設定しません。

subsystem.undertow.update.add-undertow-websockets.skip

true に設定する場合は、WebSocket のサポートを追加しないでください。

subsystem.undertow.update.add-undertow-https-listener.skip

true に設定する場合は、デフォルトの HTTPS リスナーを設定しません。

subsystem.undertow.update.enable-http2.skip

true に設定する場合は、HTTP2 のサポートを追加しません。

subsystem.undertow.update.add-response-header.server-header.skip

true に設定する場合は、デフォルトのサーバー 応答 ヘッダーを設定しません。

subsystem.undertow.update.add-response-header.x-powered-by-header.skip

true に設定する場合は、デフォルトの X-Powered-By 応答ヘッダーを設定しません。

subsystem.undertow.update.add-http-invoker.skip

true に設定する場合は、デフォルトの HTTP Invoker を設定しません。

6.1.14. messaging-activemq サブシステムの更新

JBoss EAP 7.3 の messaging サブシステムを移行する他に、JBoss Server Migration Tool は代替の messaging-activemq サブシステムを更新し、サポートする新機能を追加します。

  • HTTP ベースのリモートメッセージングクライアントを有効にするために、デフォルトの HTTP コネクターおよびアクセプターを追加します。

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

messaging-activemq サブシステムの自動更新を省略するには、subsystem.messaging-activemq.update.skip 環境プロパティーを true に設定します。

6.1.15. Batch JBeret サブシステムの追加

JBoss EAP 7.3 の batch-jberet サブシステムは、Java Platform の JSR 352: Batch Applications のサポートを提供します。JBoss Server Migration Tool は、デフォルトの batch-jberet サブシステム設定を移行された設定に自動的に追加します。バッチアプリケーションの Jakarta に相当するものは、Jakarta Batch 1.0 仕様 で定義されています。

batch-jberet サブシステム設定の追加を省略するには、subsystem.batch-jberet.add.skip プロパティーを true に設定します。

6.1.16. コア管理サブシステムの追加

JBoss EAP 7.3 の core-management サブシステムは、管理コアサービスで以前に設定された管理関連リソースを提供します。これらのリソースの例には、サーバーに追加された設定変更の履歴やサーバーライフサイクルイベントの監視機能などが含まれます。JBoss Server Migration Tool は、デフォルトの core-management サブシステム設定を移行された設定ファイルに自動的に追加します。

core-management サブシステム設定の追加を省略するには、subsystem.core-management.add.skip 環境プロパティーを true に設定します。

6.1.17. discovery サブシステムの追加

JBoss Server Migration Tool は、デフォルトの discovery サブシステム設定を移行された設定ファイルに自動的に追加します。

discovery サブシステム設定の追加を省略するには、subsystem.discovery.add.skip 環境プロパティーを true に設定します。

6.1.18. EE Security サブシステムの追加

JBoss EAP 7.3 の ee-security サブシステムは、Jakarta Security のサポートおよびコンプライアンスを提供します。JBoss Server Migration Tool は、デフォルトの ee-security サブシステム設定を移行された設定ファイルに自動的に追加します。

ee-security サブシステム設定の追加を省略するには subsystem.ee-security.add.skip を true に設定します。

6.1.19. elytron サブシステムの追加

JBoss EAP 7.3 elytron サブシステムでは、スタンドアロンサーバーと管理対象ドメインの両方のアクセスを管理および設定できる単一の統合フレームワークを利用できます。JBoss EAP サーバーにデプロイされたアプリケーションのセキュリティーアクセスを設定するために使用することもできます。JBoss Server Migration Tool は、デフォルトの elytron サブシステム設定を移行された設定ファイルに自動的に追加します。

elytron サブシステム設定の追加を省略するには、subsystem.elytron.add.skip プロパティーを true に設定します。

6.1.20. MicroProfile Config SmallRye サブシステムの追加

JBoss EAP 7.3 の microprofile-config-smallrye サブシステムでは、Eclipse MicroProfile 設定を利用できます。JBoss Server Migration Tool は、デフォルトの microprofile-config-smallrye サブシステム設定を移行された設定ファイルに自動的に追加します。

microprofile-config-smallrye サブシステム設定の追加を省略するには、subsystem.microprofile-config-smallrye.add.skip 環境プロパティーを true に設定します。

6.1.21. MicroProfile Health SmallRye サブシステムの追加

JBoss EAP 7.3 の microprofile-health-smallrye サブシステムでは Eclipse MicroProfile Health を利用できます。JBoss Server Migration Tool は、デフォルトの health-smallrye サブシステム設定を移行された設定ファイルに自動的に追加します。

microprofile-health-smallrye サブシステム設定の追加を省略するには、subsystem.microprofile-health-smallrye.add.skip 環境プロパティーを true に設定します。

6.1.22. MicroProfile Metrics SmallRye サブシステムの追加

JBoss EAP 7.3 の microprofile-metrics-smallrye サブシステムでは Eclipse MicroProfile Metrics を利用できます。JBoss Server Migration Tool は、デフォルトの microprofile-metrics-smallrye サブシステム設定を移行された設定ファイルに自動的に追加します。

microprofile-metrics-smallrye サブシステム設定の追加を省略するには、subsystem.microprofile-metrics-smallrye.add.skip 環境プロパティーを true に設定します。

6.1.23. MicroProfile OpenTracing SmallRye サブシステムの追加

JBoss EAP 7.3 の microprofile-opentracing-smallrye サブシステムでは Eclipse MicroProfile OpenTracing を利用できます。JBoss Server Migration Tool は、デフォルトの microprofile-smallrye サブシステム設定を移行された設定ファイルに自動的に追加します。

microprofile-opentracing-smallrye サブシステム設定の追加を省略するには、subsystem.microprofile-opentracing-smallrye.add.skip 環境プロパティーを true に設定します。

6.1.24. Request Controller サブシステムの追加

JBoss EAP 7.3 の request-controller サブシステムでは、輻輳制御と正常なシャットダウン機能を利用できます。JBoss Server Migration Tool は、デフォルトの request-controller サブシステム設定を移行された設定ファイルに自動的に追加します。

request-controller サブシステム設定の追加を省略するには、subsystem.request-controller.add.skip プロパティーを true に設定します。

6.1.25. Security Manager サブシステムの追加

JBoss EAP 7.3 の security-manager サブシステムでは、Jakarta Security パーミッションを利用できます。JBoss Server Migration Tool は、デフォルトの security-manager サブシステム設定を移行された設定ファイルに自動的に追加します。

security-manager サブシステム設定の追加を省略するには subsystem.security-manager.add.skip 環境を true に設定します。

6.1.26. singleton サブシステムの追加

JBoss EAP 7.3 の singleton サブシステムでは、singleton 機能を利用できます。JBoss Server Migration Tool は、デフォルトの singleton サブシステム設定を移行された設定ファイルに自動的に追加します。

singleton サブシステム設定の追加を省略するには、subsystem.singleton.add.skip 環境プロパティーを true に設定します。

6.1.27. HTTP アップグレード管理の設定

JBoss EAP 7 で undertow を追加することで、HTTP アップグレードが追加され、複数のプロトコルを単一ポートで多重化できるようになります。これは、管理クライアントが HTTP 上で最初の接続を確立できることを意味します。しかし、次に別のプロトコルにその接続をアップグレードする要求を送信します。JBoss Server Migration Tool は、HTTP Upgrade 管理に対応するように設定を自動的に更新します。

HTTP アップグレード管理の設定を省略するには、management.setup-http-upgrade.skip 環境プロパティーを true に設定します。

6.1.28. プライベートインターフェイスのセットアップ

JBoss EAP 7 のデフォルト設定は、すべての jgroups ソケットバインディングでプライベートインターフェイスを使用します。JBoss Server Migration Tool は、同じ設定を使用するように、移行された jgroups ソケットバインディングを自動的に更新します。

プライベートインターフェイスの設定を省略するには、interface.private.setup.skip 環境プロパティーを true に設定します。

6.1.29. ソケットバインディングポート式の追加

JBoss EAP 7.3 のデフォルト設定では、以下のソケットバインディングの port 属性に値式が使用されます。

  • ajp
  • http
  • https

JBoss Server Migration Tool は、これらの値式を移行されたサーバー設定に自動的に追加します。

ソケットバインディングポート式の更新を省略するには、socket-bindings.add-port-expressions.skip 環境プロパティーを true に設定します。

6.1.30. ソケットバインディングマルチキャストアドレス式の追加

JBoss EAP 7.3 のデフォルト設定では、mod_cluster ソケットバインディングの multicast-address 属性の値式が使用されます。JBoss Server Migration Tool は、これらの値式を移行された設定ファイルに自動的に追加します。

これらの式の追加を省略するには、socket-bindings.multicast-address.add-expressions.skip 環境プロパティーを true に設定します。

6.1.31. 互換性のあるセキュリティーレルムの移行

JBoss EAP 7.3 のセキュリティーレルム設定は JBoss EAP 6.4 セキュリティーレルム設定と完全に互換性があります。そのため、JBoss Server Migration Tool では更新は必要ありません。ただし、application-users.properties、application-roles.properties、mgmt-users.properties、mgmt-groups.properties ファイルが絶対パスで参照されていない場合、このツールは移行された設定ファイルによって想定されるパスにコピーします。

セキュリティーレルムの移行を省略するには、security-realms.migrate-properties.skip environment 環境プロパティーを true に設定します。

6.1.32. デフォルトの SSL サーバーアイデンティティーを ApplicationRealm に追加します。

JBoss EAP 7.3 のデフォルト設定には、デフォルトの ApplicationRealm セキュリティーレルムの SSL サーバーアイデンティティーが含まれます。JBoss Server Migration Tool は、このアイデンティティーを移行された設定ファイルに自動的に追加します。

このアイデンティティーの追加を省略するには、security-realm.ApplicationRealm.add-ssl-server-identity.skip 環境プロパティーを true に設定します。

6.1.33. デプロイメントの移行

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 6.4 *-jms.xml 設定ファイルなどのアーティファクトは変更なしでコピーされ、JBoss EAP サーバーがエラーで起動する可能性があることに注意してください。

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

6.1.33.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

6.1.33.2. デプロイメントスキャナーデプロイメントの移行

スタンドアロンサーバー設定のみで使用されるデプロイメントスキャナーは、新規ファイルのディレクトリーを監視します。また、デプロイメントを自動的に管理したり、特別なデプロイメントマーカーファイルを介して管理します。

非対話モードで実行時にデプロイメントスキャナーによって監視されるディレクトリーにあるデプロイメントの移行を有効にするには、deployments.migrate-deployment-scanner-deployments.skip 環境プロパティーを false に設定します。

スタンドアロンサーバー設定を移行する場合、JBoss Server Migration Tool は最初に設定済みのデプロイメントスキャナーを検索します。見つかった各スキャナーに対して、監視されるディレクトリーで、デプロイ済みとマークされているデプロイメントを検索し、結果をコンソールに出力します。

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

非対話モードでのデプロイメントスキャナーディプロイメントの移行

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

対話モードでのデプロイメントスキャナーディプロイメントの移行

対話モードでツールを実行する場合は、JBoss Server Migration Tool が以下のワークフローを使用してディプロイメントごとにプロンプトを表示します。

  1. 検出したデプロイメントスキャナーディプロイメントをコンソールに出力すると、次のプロンプトが表示されます。 

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

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

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

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

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

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

      INFO  [ServerMigrationTask#69] Resource with path EAP_HOME/standalone/deployments/helloworld02.war migrated.

6.1.33.3. デプロイメントオーバーレイの移行

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