Eclipse および Red Hat CodeReady Studio ガイド

手順

1. Eclipse または CodeReady Studio を起動します。
2. メニューバーから Help → Install New Software を選択します。
3. Work with フィールドの横にある Add をクリックします。
4. Name フィールドに MTR を入力します。
5. Location フィールドに http://download.jboss.org/jbosstools/photon/stable/updates/mtr/ を入力し、OK をクリックします。
6. すべての JBoss Tools - MTR チェックボックスを選択して、Next をクリックします。
7. インストールの詳細を確認し、Next をクリックします。
8. ライセンス契約の条件に同意し、Finish をクリックします。
9. Eclipse または CodeReady Studio を再起動します。

手順

1. ネットワークアクセスのあるコンピューターで、Migration Toolkit for Runtimes の ダウンロードサイト に移動し、migrationtoolkit-mtr-eclipse-plugin-repository ファイルをダウンロードします。
2. Eclipse または CodeReady Studio を起動します。
3. メニューバーから Help → Install New Software を選択します。
4. Work with フィールドの横にある Add をクリックします。
5. Name フィールドに MTR を入力します。
6. Location フィールドの横にある Archive をクリックします。
7. migrationtoolkit-mtr-eclipse-plugin-repository ファイルを選択し、OK をクリックします。
8. すべての JBoss Tools - MTR チェックボックスを選択して、Next をクリックします。
9. インストールの詳細を確認し、Next をクリックします。
10. ライセンス契約の条件に同意し、Finish をクリックします。
11. Eclipse または CodeReady Studio を再起動します。

手順

1. Window → Perspective → Open Perspective → Other をクリックします。

2. MTR を選択して OK をクリックします。

   以下のコンポーネントが表示されます。

   • Issue Explorer は、MTR プラグインで識別される移行の問題を表示します。

   • MTR Server は、プロジェクトを分析し、移行の問題にフラグを立て、レポートを生成する別個のプロセスです。

     Issue Explorer で MTR サーバーの開始、停止、およびステータス表示を行うことができます。

   • Issue Details には、ヒント、重大度、追加のリソースなど、選択した問題に関する詳細情報が表示されます。

   • MTR レポート は、MTR プラグインによって生成される HTML レポートです。レポートのランディングページから、アプリケーションの詳細、問題、依存関係などの詳細なレポートに移動できます。

     注記

     デフォルトでは、レポートは生成されません。実行設定で Generate Report オプションを選択する必要があります。

手順

1. Issue Explorer で MTR アイコン ( ) をクリックし、実行設定を作成します。

2. 入力 タブで、以下のフィールドを入力します。

   1. 移行パスを選択します。
   2. Projects フィールドの横にある Add をクリックし、1 つ以上のプロジェクトを選択します。

   3. Packages フィールドの横にある Add をクリックし、パッケージを 1 つまたは複数選択します。

      注記

      分析するパッケージを指定すると、ランタイム時間が短縮されます。パッケージを選択しないと、プロジェクト内のすべてのパッケージがスキャンされます。

3. Options タブで Generate Report を選択し、HTML レポートを生成することができます。レポートは Report タブに表示され、ファイルとして保存されます。

   その他のオプションが表示されます。詳細は、CLI ガイドの MTR コマンドライン引数 を参照してください。

4. Rules タブで、MTR プラグインにインポートまたは作成したカスタムルールセットを選択できます。
5. 実行 をクリックして分析を開始します。

手順

1. MTR パースペクティブで、Run ボタン ( ) をクリックし、実行設定を選択します。

   MTR プラグインはプロジェクトを分析します。Issue Explorer は、ルールセットで検出された移行の問題を表示します。

2. プロジェクトの分析が終了したら、Issue Explorer で MTR サーバーを停止して、メモリーを節約します。

手順

1. Window → Show View → Issue Explorer をクリックします。

2. オプション: Options メニュー をクリックし、Group By およびオプションを選択して問題をフィルタリングします。

   

3. 右クリックし、Issue Details を選択して問題についての情報を表示します。これには、重大度や対処方法が含まれます。

   以下のアイコンは、問題の重大度および状態を示しています。

   表3.1 問題アイコン

   アイコン	説明
   	移行を成功させるには、この問題を修正する必要があります。
   	移行については、この問題の修正は任意となります。
   	この問題は、移行時に対処する必要がある場合があります。
   	この問題は解決されています。
   	この問題は古くなっています。問題としてマークされたコードは、MTR が最後に問題として識別したときから変更されています。
   	この問題にはクイック修正を利用できます。正常に移行するには修正は必須となります。
   	この問題にはクイック修正を利用できます。移行については、修正は任意となります。
   	この問題にはクイック修正を利用できます。これは、移行中に問題が発生する可能性があります。

4. 問題をダブルクリックして、エディターでコードの関連する行を開きます。

手順

1. Rulesets タブをクリックします。
2. System を展開して、システムのルールセットまたは Custom を表示してカスタムルールセットを表示します。
3. ルールセットを展開します。
4. ルールをダブルクリックして、ビューアーで開きます。
5. Source タブをクリックして、ルールの XML ソースを表示します。

手順

1. Rulesets タブをクリックします。
2. ルールセットの作成アイコン ( ) をクリックします。
3. ルールセットのプロジェクトおよびディレクトリーを選択します。

4. ファイル名を入力します。

   注記

   ファイルには拡張子 .windup.xml が必要です。

5. ruleset ID (my-ruleset-id など) を入力します。
6. オプション: Generate quickstart template を選択し、基本的なルールテンプレートをファイルに追加します。
7. Finish をクリックします。
8. エディターでルールセットファイルが開かれ、ルールを追加および編集できます。
9. Source タブをクリックして、ルールセットファイルの XML ソースを編集します。

手順

1. Rulesets タブをクリックします。
2. ルールセットのインポートアイコン ( ) をクリックします。

3. インポートする XML ルールファイルを参照して選択します。

   Rulesets タブで Custom を拡張すると、カスタムルールセットが表示されます。

手順

1. Rulesets タブをクリックします。
2. 矢印アイコン ( ) をクリックし、Submit Ruleset を選択します。

3. 以下のフィールドに入力します。

   • Summary: ルールの目的を説明します。これは送信時のタイトルになります。
   • Code Sample: ルールが実行するソースコードの例を入力します。
   • Description: ルールの簡単な説明を入力します。
4. Choose Files をクリックし、ルールセットファイルを選択します。
5. Submit をクリックします。