第2章 スタートガイド

前提条件

  • OpenJDK 1.8、OpenJDK 11、Oracle JDK 1.8、または Oracle JDK 11
  • 8 GB RAM
  • macOS にインストールする場合は、maxproc の値は 2048 以上である必要があります。

手順

  1. .zip ファイルを任意のディレクトリーに展開します。

    注記

    Windows オペレーティングシステムにインストールする場合は、以下を行います。

    1. .zip ファイルを mta という名前のディレクトリーに展開し、Path too long エラーを回避します。
    2. 抽出中に Confirm file replace ウィンドウが表示されている場合は、Yes to all をクリックします。

    インストールディレクトリーは、本ガイドでは <MTA_HOME> と呼ばれます。

2.1. CLI の実行

アプリケーションに対して MTA を実行できます。

手順

  1. ターミナルを開き、<MTA_HOME>/bin/ ディレクトリーに移動します。

  2. mta-cli スクリプト (Windows の場合は mta-cli.bat) を実行し、適切な引数を指定します。 

    $ ./mta-cli --input /path/to/jee-example-app-1.0.0.ear --output /path/to/output --source weblogic --target eap:6 --packages com.acme org.apache
    • --input: 評価されるアプリケーション。
    • --output: 生成されたレポートの出力ディレクトリー。
    • --source: アプリケーション移行元のテクノロジー。
    • --target: アプリケーション移行先のテクノロジー。
    • --packages: 評価されるパッケージ。この引数は、パフォーマンスを改善するために強く推奨されます。
  3. レポートにアクセスします。

MTA コマンドの例

アプリケーションアーカイブでの MTA の実行

次のコマンドは、JBoss EAP 5 から JBoss EAP 7 に移行するための サンプル EAR アーカイブ jee-example-app-1.0.0.ear の com.acme パッケージおよび org.apache パッケージを解析します。 

$ <MTA_HOME>/bin/mta-cli --input /path/to/jee-example-app-1.0.0.ear --output /path/to/report-output/ --source eap:5 --target eap:7 --packages com.acme org.apache
ソースコードでの MTA の実行

次のコマンドは、JBoss EAP 6 に移行するための seam-booking-5.2 サンプルソースコードの org.jboss.seam パッケージを分析します。 

$ <MTA_HOME>/bin/mta-cli --sourceMode --input /path/to/seam-booking-5.2/ --output /path/to/report-output/ --target eap:6 --packages org.jboss.seam
cloud-readiness ルールの実行

次のコマンドは、JBoss EAP 7 に移行するためのサンプル EAR アーカイブ jee-example-app-1.0.0.ear の com.acme パッケージおよび org.apache パッケージを解析します。また、クラウドの準備ができるかどうかも評価します。 

$ <MTA_HOME>/bin/mta-cli --input /path/to/jee-example-app-1.0.0.ear --output /path/to/report-output/ --target eap:7 --target cloud-readiness --packages com.acme org.apache
MTA プロパティーの上書き

デフォルトの Fernflower デコンパイラーを上書きするには、コマンドラインで -Dwindup.decompiler 引数を渡します。たとえば、Procyon デコンパイル機能を使用する場合は、以下の構文を使用します。 

$ <MTA_HOME>/bin/mta-cli -Dwindup.decompiler=procyon --input <INPUT_ARCHIVE_OR_DIRECTORY> --output <OUTPUT_REPORT_DIRECTORY> --target <TARGET_TECHNOLOGY> --packages <PACKAGE_1> <PACKAGE_2>

MTA CLI bash 補完

MTA CLI は、Linux システムの bash 補完を有効にするオプションを提供し、コマンドを入力した時に Tab キーを押して MTA コマンドライン引数を自動化できます。たとえば、bash 補完を有効にすると、以下のように利用可能な引数のリストが表示されます。 

$ <MTA_HOME>/bin/mta-cli [TAB]
bash 補完の有効化

現在のシェルで bash 補完を有効にするには、以下のコマンドを実行します。プロンプトが返されたら、CLI の使用手順に従います。 

$ source <MTA_HOME>/bash-completion/mta-cli
永続的な bash 補完の有効化

以下のコマンドを使用すると、再起動後も bash 補完が維持されます。

  • システムを再起動しても特定のユーザーの bash 補完を有効にするには、そのユーザーの ~/.bashrc ファイルに以下の行を追加します。 

    source <MTA_HOME>/bash-completion/mta-cli

  • システムの再起動後すべてのユーザーの bash 補完を有効にするには、Applications CLI bash 補完ファイルを /etc/bash_completion.d/ ディレクトリーにコピーします。デフォルトでは、このディレクトリーは root ユーザーのみが書き込み可能です。 

    # cp <MTA_HOME>/bash-completion/mta-cli /etc/bash_completion.d/

MTA ヘルプへのアクセス

mta-cli コマンドで利用可能な引数の完全な一覧を表示するには、ターミナルを開き、<MTA_HOME> ディレクトリーに移動して、以下のコマンドを実行します。 

$ <MTA_HOME>/bin/mta-cli --help