第3章 Web コンソールでのアプリケーションの分析

Web コンソールでプロジェクトを作成して、アプリケーションを分析できます。

各プロジェクトは、特定の分析用にアプリケーションをグループ化し、カスタムルールおよびラベルで設定できます。

分析プロセスは、移行またはモダナイゼーションのためのアプリケーションの準備ができていることを示すレポートを生成します。

3.1. プロジェクトの作成

Create project ウィザードを使用して、Web コンソールでプロジェクトを作成できます。

手順

  1. Web コンソールで、Projects をクリックします。
  2. Create project をクリックします。
  3. プロジェクトの一意な名前、オプションの説明を入力し、Next をクリックします。
  4. アプリケーションをアップロードするには、Upload タブをクリックし、Browse をクリックして、アップロードするアプリケーションファイルを選択し、Close をクリックします。

    アプリケーションをアップロードすると、MTR サーバーに直接保存されます。

  5. サーバーパスを登録するには、Server path タブをクリックし、フィールドにアプリケーションの Server 側のパス を入力します。

    アプリケーションのサーバーパスを登録すると、MTR は常に最新バージョンを使用するようにします。

  6. Next をクリックします。
  7. 1 つ以上の変換ターゲットをクリックします。

    変換ターゲット
  8. Next をクリックします。
  9. パッケージを選択し、フィルター > をクリックして分析に追加します。
  10. Next をクリックします。
  11. カスタムルールを追加する場合は、Add rule をクリックします。

    詳細は、ルール開発ガイド を参照してください。

    • ルールセットファイルをアップロードするには、Upload タブをクリックし、Browse をクリックして、1 つ以上のファイルを選択してから Close をクリックします。

      ルールセットファイルには .windup.xml 拡張子が必要です。アップロードしたファイルは MTR サーバーに保存されます。

    • ruleset ファイルのサーバーパスを登録するには、Server path タブをクリックし、Rules パスを入力して Save をクリックします。

      サーバーパスを登録すると、MTR サーバーは常に最新バージョンの ruleset ファイルを使用します。

  12. Next をクリックします。
  13. カスタムラベルを追加するには、Add label をクリックします。

    • labelset ファイルをアップロードするには、Upload タブをクリックし、Browse をクリックして、1 つ以上のファイルを選択してから Close をクリックします。

      ラベルセットファイルには .windup.label.xml 拡張子が必要です。アップロードしたファイルは MTR サーバーに保存されます。

    • サーバーパスを登録するには、Server path タブをクリックし、フィールドにラベルファイルの Labels パス を入力して、Save をクリックします。

      サーバーパスを登録すると、MTR サーバーは常に最新バージョンの labelset ファイルを使用するようになります。

  14. Next をクリックします。
  15. 以下の 高度なオプション を確認し、必要な変更を加えます。

    • Target
    • Source
    • Exclude tags: これらのタグを持つルールは処理されません。
    • Additional classpath: 逆コンパイルまたはその他の分析で使用できるように、追加の .jar ファイルまたはディレクトリーのスペース区切りリストを入力します。
    • Application name
    • Mavenize group ID
    • Ignore path: 分析から除外するファイルのパスを入力します。
    • Export CSV: レポートデータを CSV ファイルとしてエクスポートします。
    • Disable Tattletale: 各アプリケーションの Tattletale レポートの生成を無効にします。
    • Class Not Found analysis: クラスパスで利用できない Java ファイルの分析を有効にします。

      注記

      分析に一部のクラスが利用できない場合は、このオプションを使用しないでください。

    • Compatible Files report: 大規模なアプリケーションの場合、Compatible Files レポートの生成に時間がかかる場合があります。
    • Exploded app: 入力ディレクトリーには、アプリケーションのパッケージ化されていないソースファイルが含まれます。
    • Keep work dirs: デバッグ目的でグラフデータベースや抽出したアーカイブファイルなどの一時ファイルを保持します。
    • Skip report: HTML レポートは生成されません。Export CSV を有効にしている場合には有効にする必要があります。
    • ネットワークアクセスを許可する: 分析されたアプリケーション内のすべての XML ファイルをスキーマに対して検証します。

      注記

      このオプションは、パフォーマンスを低下させる可能性があります。

    • Mavenize: アプリケーションの構造および内容に基づいて Maven プロジェクトディレクトリー構造を作成します。
    • ソースモード: アプリケーションファイルがコンパイル済みのバイナリーではなく、生のソースファイルであることを示します。sourceMode 引数は廃止されました。そのため、指定する必要がなくなりました。MTR は、提示された入力を直感的に処理できます。さらに、プロジェクトソースフォルダーは、同じ分析実行内でバイナリー入力を使用して分析できます。
    • 既知のライブラリーを分析する: アプリケーションに埋め込まれた既知のソフトウェアアーティファクトを分析します。デフォルトでは、MTR はアプリケーションコードのみを分析します。

      注記

      このオプションを使用すると実行時間が長くなり、多数の移行問題が報告される可能性があります。

    • トランザクション分析: [テクニカルプレビュー] リレーショナルデータベーステーブルで操作を実行するコールスタックを表示するトランザクションレポートを生成します。Enable Transaction Analysis 機能は、Spring Data JPA と、SQL ステートメント実行用の従来の preparedStatement() メソッドをサポートします。Hibernate などの ORM フレームワークはサポートしていません。

      注記

      トランザクション分析はテクノロジープレビュー機能のみです。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は実稼働環境でこれらを使用することを推奨していません。テクノロジープレビューの機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。

  16. Next をクリックします。
  17. プロジェクトを確認し、Save または Save and run をクリックします。

    プロジェクトが Projects 画面に表示されます。