Web コンソールガイド

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

MTC(Migration Toolkit for Applications)

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

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

Migration Toolkit for Applications で移行を簡素化するにはどうすればよいですか？

アプリケーション向けの MTC(Migration Toolkit for Applications)は一般的なリソースを見つけ、アプリケーションの移行時に技術と既知の問題のある場所を強調表示します。この目的は、アプリケーションが使用するテクノロジーの概要を提供し、組織がエンタープライズアプリケーションを Java EE および Red Hat JBoss Enterprise Application Platform に推定、文書化、移行するために使用できる詳細なレポートを提供することです。

詳細を確認する方法

MTC(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

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 にデプロイさ れたら、ブラウザーから Web コンソールにアクセスできます。deploy.sh スクリプトは、以下の例に示されるリンクを出力し WEB_CONSOLE_URL、Web コンソールを開きます。

例： deploy.sh 出力

...
-> 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')

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

注記

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)]
[...]

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

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 分析リスト

分析 コラムのリンクをクリックして レポートを表示 するか、または アクション 列の情報アイコンをクリックして 分析の詳細を表示 します。

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

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

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

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

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

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

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

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

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

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

改訂日時： 2020-10-18 19:17:40 AEST