Java アプリケーションやその他のコンポーネントを移行するために、Migration Toolkit for Applications (MTA) を使用するエンジニア、コンサルタント、およびその他のユーザーを対象としています。ここでは、Web コンソールを使用して移行プロジェクトを管理し、アプリケーションを解析する方法を説明します。

Migration Toolkit for Applications とは

Migration Toolkit for Applications (MTA) は、Java アプリケーションの移行を簡素化する拡張可能でカスタマイズ可能なルールベースのツールです。

MTA は、プロジェクトソースディレクトリーやアプリケーションアーカイブを含むアプリケーションアーティファクトを検査し、変更を必要とするエリアを強調表示する HTML レポートを作成します。MTA は、以前のバージョンの Red Hat JBoss Enterprise Application Platform から、または Oracle WebLogic Server や IBM WebSphere Application Server などの他のアプリケーションサーバーから Java アプリケーションを移行できます。

Migration Toolkit for Applications で移行を単純化する方法

Migration Toolkit for Applications は一般的なリソースを探し、アプリケーションを移行する際のテクノロジーと既知の問題点を明らかにします。この目的は、アプリケーションが使用するテクノロジーの概要を提供し、組織がエンタープライズアプリケーションを Java EE および Red Hat JBoss Enterprise Application Platform に推定、文書化、移行するために使用できる詳細なレポートを提供することです。

詳細情報

Migration Toolkit for Applications の機能、サポートされる設定、システム要件、利用可能なツールの詳細は、Migration Toolkit for Applications の概要 を参照してください。

Migration Toolkit for Applications の Web コンソールを使用すると、多数のアプリケーションに対する移行およびモダライゼーションの作業を評価および優先順位付けできます。これにより、分析のためにアプリケーションをプロジェクトにグループ化し、結果を強調表示する多数のレポートを提供します。

Linux、Windows、または macOS のオペレーティングシステムに Web コンソールをインストールし、ブラウザーで Web コンソールにアクセスできます。

Web コンソールは Chrome および Firefox でテストされています。

Red Hat OpenShift Container Platform に MTA Web コンソールをインストールし、ブラウザーで Web コンソールにアクセスできます。

2.2.3. Web コンソールへのアクセス

Web コンソールが OpenShift Container Platform にデプロイされると、ブラウザーからこれにアクセスできます。deploy.sh スクリプトは、Web コンソールを開くために使用する <WEB_CONSOLE_URL> のようにリンクを出力します。

例: deploy.sh 出力

...
-> Deploy MTA Web Console ...
Upload, build and deployment successful!

Open <WEB_CONSOLE_URL> to start using the MTA Web Console on OpenShift (user='mta',password='<password>')

<OPENSHIFT_URL>/console/project/mta/overview の OpenShift コンソールから Web コンソールにアクセスするには、MTA WEB CONSOLE HTTP アプリケーションのリンクをクリックします。デプロイ時に OpenShift プロジェクトの名前を変更した場合は、この URL の mta をプロジェクトの名前に置き換えます。

注記

Web コンソールがすぐに読み込まれない場合は、OpenShift コンソールのプロジェクトのステータスを確認し、これが処理されているか、またはエラーがあったかどうかを確認します。

図2.4 Welcome ページ

Web コンソールのインストールにより、デフォルトのパスワード password を持つデフォルトの mta ユーザーが作成されます。Web コンソールにユーザーを追加できます。

13:44:03,501 SEVERE [org.jboss.windup.web.messaging.executor.ExecutorBootstrap] (main) Could not start messaging listener due to: Failed to connect to any server. Servers tried: [http-remoting://192.0.2.4:8080 (java.net.NoRouteToHostException: No route to host)]: javax.naming.CommunicationException: Failed to connect to any server. Servers tried: [http-remoting://192.0.2.4:8080 (java.net.NoRouteToHostException: No route to host)]
[...]

0/9 nodes are available: 4 Insufficient cpu, 4 MatchNodeSelector, 9 Insufficient memory.

error: update acceptor rejected mta-web-console-executor-1: Pods for rc 'mta/<POD_NAME>' took longer than 600 seconds to become available

Web コンソールに初めてアクセスすると、新規プロジェクトを設定するように求められます。

図3.1 ホーム

New Project ボタンをクリックしてウィザードを起動し、新しい移行プロジェクトを設定します。

図3.2 プロジェクトの追加

このプロジェクトの名前とオプションの説明を指定し、Next をクリックして続行します。

このプロジェクトに追加するアプリケーションを指定します。アプリケーションをアップロードしたり、アプリケーションが含まれるサーバーパスを登録することができます。

図3.3 アプリケーションの追加

このプロジェクトに 1 つ以上のアプリケーションを指定したら、Next をクリックして続行します。

変換パス、パッケージ、その他の高度なオプションなど、解析の設定を行います。

図3.4 解析の設定

Advanced Options ダイアログを使用して、利用可能なその他のターゲットを選択できます。

カスタムルールは、現在の MTA プロジェクト (プロジェクトスコープ) またはすべての MTA プロジェクト (グローバルスコープ) に対して維持できます。

プロジェクトカスタムルールは、以下のコントロールを使用して維持されます。

Add ボタンを使用すると、ユーザーはルールファイル (.windup.xml または .mta.xml) を選択できます。選択した (確認した) ルールは右側のパネルに表示され、解析中に実行されます。

図3.5 カスタムルール

カスタムラベルは、現在の MTA プロジェクト (プロジェクトスコープ) またはすべての MTA プロジェクト (グローバルスコープ) に対して維持できます。

プロジェクトカスタムラベルは、以下のコントロールを使用して維持されます。

Add ボタンを使用すると、ユーザーはラベルファイル (.windup.label.xml または .mta.label.xml) を選択できます。選択した (チェックした) ラベルが右側のパネルに表示され、解析中に実行されます。

図3.6 カスタムラベル

解析設定ページから、Save & Run ボタンをクリックして解析を実行します。

Analysis ページで、現在実行している解析の進捗が表示されます。完了した、キューに入れられた、および進行中の実行が表にリストされます。Run Analysis をクリックし、最新の設定で解析を再実行します。

プロジェクトで MTA 解析を実行すると、解析 ID、ステータス、および開始日が表に一覧表示されます。各行には、解析の詳細と生成されたレポートの表示、解析のキャンセルおよび削除など、その解析に使用できるアクションが含まれています。

図3.7 解析リスト

Analysis 列のリンクをクリックしてレポートを表示するか、Actions 列で情報アイコンをクリックして解析の詳細を表示します。

3.5.1. 解析の詳細表示

解析の詳細は、解析結果テーブルの Actions コラムの情報アイコンをクリックして表示できます。

図3.8 解析の詳細

このページでは、この解析に関する情報を以下のタブを提供します。

Details

このタブには、解析のステータス、開始日、および解析に使用された設定が表示されます。

Applications

このタブには、この解析に含まれるアプリケーションを一覧表示しています。

Rules

このタブには、この解析中に評価されたルールが一覧表示されます。

注記

ユーザードロップダウンメニューから Rules Configuration を選択すると、すべてのシステムおよびカスタムルールを表示できます。

Logs

このタブには、この MTA 解析エンジンの実行からの出力が表示されます。

アプリケーションの解析中に使用する独自のカスタムルールを追加できます。カスタム MTA ルールの作成に関する詳細は、MTA の ルール開発ガイド を参照してください。

タイトルバーの User メニューから Rules Configuration を選択し、既存のシステムおよびカスタムルールをすべて表示します。

図4.1 カスタムルールの追加

独自のカスタムルールを追加するには、Add をクリックします。ルールをアップロードしたり、ルールが含まれるサーバーパスを登録することができます。

カスタムルールセットは、プロジェクトの解析時に個別に選択できます。これらのルールセットを有効にするには、解析設定の Use local custom rules セクションでルールセットを選択します。

ユーザードロップダウンメニューから Labels Configuration を選択し、既存のシステムおよびカスタムラベルをすべて表示します。

図4.2 カスタムラベルの追加

独自のカスタムラベルを追加するには、Add をクリックします。ラベルをアップロードしたり、ラベルファイルが含まれるサーバーパスを登録することができます。

このように、ラベルがこの場所で更新されると、MTA サーバーは解析中に常に最新のラベルを使用します。Add をクリックしてラベルを登録します。

以下のスクリプトを実行して、ユーザーが Web コンソールにアクセスする前にログインする必要があります。このスクリプトは、ユーザーが Web コンソールへのアクセスを付与する前に認証を要求するように Red Hat Single Sign-On ログインページを設定します。

$ <MTA_HOME>/switch_to_authentication_required.sh

今回のリリースにより、Web コンソールを起動するたびに、Web コンソールにアクセスするためにユーザーが認証される必要があります。

Web コンソールの認証を有効にすると、ユーザー名 admin およびパスワードの password でデフォルトの管理ユーザーが提供されます。Web コンソールユーザーには、承認されたパスワードのみがさらに変更できるように、このパスワードを変更する必要があります。

デフォルトの管理ユーザーのパスワードを変更するには、以下の手順に従います。

このデフォルトの管理ユーザーを完全に削除し、独自の管理ユーザーを作成することもできます。ただし、デフォルトユーザーを削除する前に、新規ユーザーを追加してください。

デフォルトの Web コンソールユーザーは、ユーザー名 mta およびパスワード password とともに Web コンソールが提供されます。Web コンソールの認証を有効にすると、このユーザーを削除し、認証されたユーザーのみが Web コンソールにアクセスできるようにする必要があります。

以下の手順に従って、デフォルトの Web コンソールユーザーを削除します。

Web コンソールの認証が有効になっている場合は、管理者がユーザーを追加して、Web コンソールにアクセスできるようにする必要があります。

以下の手順に従って、新しい Web コンソールユーザーを追加します。

ユーザーはデフォルトで有効になっており、この一時パスワードを使用して Web コンソールにログインする際に新しいパスワードを設定する必要があります。

改訂日時: 2022-12-03 17:27:39 +1000