Web コンソールガイド

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 の Web コンソールは、ユーザーのチームが多数のアプリケーションに対する移行およびモダナイゼーションの作業を評価および優先順位付けできる Web ベースのシステムです。これにより、分析のためにアプリケーションをプロジェクトにグループ化し、結果を強調表示する多数のレポートを提供します。

ZIP ディストリビューションを使用してインストールすると、MTA Web コンソールは Red Hat JBoss Enterprise Application Platform にデプロイされ、認証に Red Hat Single Sign-On を使用し、ストレージ用に H2 データベースでサポートされます。

RHAMT_HOME/run_rhamt.sh

$ RHAMT_HOME/run_rhamt.sh

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

起動 すると、Web コンソールはデフォルトでローカルホスト (http://localhost:8080/rhamt-web) のブラウザーからアクセスできます。

図2.1 Welcome ページ

Web コンソールは、デフォルトのユーザーを使用して自動的に認証を行います。デフォルトのユーザーの認証情報は rhamt および password です。Web コンソールにアクセスするために個々のユーザーに認証を要求するには、Web コンソールの認証の設定 を参照してください。

OpenShift にインストールすると、MTA Web コンソールは Red Hat JBoss Enterprise Application Platform にデプロイされ、認証に Red Hat Single Sign-On を使用し、ストレージ用に PostgreSQL データベースでサポートされます。

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

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

例: deploy.sh 出力

Copy to Clipboard Toggle word wrap

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

Open WEB_CONSOLE_URL to start using the RHAMT Web Console on OpenShift (user='rhamt',password='password')

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

注記

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

図2.4 Welcome ページ

Web コンソールにアクセスするには、認証が必要です。デフォルトのユーザーの認証情報は rhamt および password です。Web コンソールの認証の設定の詳細については、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)]
[...]

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.

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

error: update acceptor rejected rhamt-web-console-executor-1: pods for rc 'rhamt/POD_NAME' took longer than 600 seconds to become available

error: update acceptor rejected rhamt-web-console-executor-1: pods for rc 'rhamt/POD_NAME' took longer than 600 seconds to become available

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

図3.1 ホーム

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

図3.2 プロジェクトの追加

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

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

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

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

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

図3.4 分析の設定

Save をクリックして解析設定を保存するか、これらの設定を使用して、Save & Run をクリックして 解析を保存および実行 します。

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

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

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

図3.5 解析リスト

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

3.5.1. 解析の詳細を調べる

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

図3.6 解析の詳細

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

Details

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

Applications

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

Rules

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

注記

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

Logs

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

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

RHAMT_HOME/switch_to_authentication_required.sh

$ RHAMT_HOME/switch_to_authentication_required.sh

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

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

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

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

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

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

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

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

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

改訂日時: 2023-01-23 07:41:55 +1000