2.3. CLI の実行
アプリケーションに対して MTA を実行するには、次の手順を使用します。
-
ターミナルを開き、
RHAMT_HOME/bin/
ディレクトリーに移動します。 rhamt-cli
スクリプト、または Windows の場合はrhamt-cli.bat
を実行し、適切な引数を指定します。./rhamt-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
$ ./rhamt-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
Copy to Clipboard Copied! -
--input
: 評価されるアプリケーション。--input
引数の説明を参照してください。 -
--output
: 生成されたレポートの出力ディレクトリー。--output
引数の説明を参照してください。 -
--source
: アプリケーション移行元のテクノロジー。--source
引数の説明を参照してください。 -
--target
: アプリケーション移行先のテクノロジー。--target
引数の説明を参照してください。 -
--packages
: 評価されるパッケージ。この引数は、パフォーマンスを改善するために強く推奨されます。--packages
引数の説明を参照してください。
使用可能なすべてのコマンドライン引数の詳細な説明については、MTA コマンドライン引数 を参照してください。
-
- レポートにアクセスします。
MTA GitHub リポジトリーにあるソースコードディレクトリーとアーカイブを使用するコマンドの例については、以下の MTA コマンドの例 を参照してください。
MTA コマンドの例
アプリケーションアーカイブでの MTA の実行
次のコマンドは、JBoss EAP 5 から JBoss EAP 7 に移行するための サンプル EAR アーカイブ jee-example-app-1.0.0.ear の com.acme
パッケージおよび org.apache
パッケージを解析します。
RHAMT_HOME/bin/rhamt-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
$ RHAMT_HOME/bin/rhamt-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
パッケージを分析します。
RHAMT_HOME/bin/rhamt-cli --sourceMode --input /path/to/seam-booking-5.2/ --output /path/to/report-output/ --target eap:6 --packages org.jboss.seam
$ RHAMT_HOME/bin/rhamt-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
パッケージを解析します。また、cloud-readiness についても評価します。
RHAMT_HOME/bin/rhamt-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
$ RHAMT_HOME/bin/rhamt-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 デコンパイル機能を使用する場合は、以下の構文を使用します。
RHAMT_HOME/bin/rhamt-cli -Dwindup.decompiler=procyon --input INPUT_ARCHIVE_OR_DIRECTORY --output OUTPUT_REPORT_DIRECTORY --target TARGET_TECHNOLOGY --packages PACKAGE_1 PACKAGE_2
$ RHAMT_HOME/bin/rhamt-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 補完を 有効 にすると、以下のように利用可能な引数のリストが表示されます。
RHAMT_HOME/bin/rhamt-cli [TAB]
$ RHAMT_HOME/bin/rhamt-cli [TAB]
bash 補完を有効にする
現在のシェルで bash 補完を有効にするには、以下のコマンドを実行します。プロンプトが返されたら、CLI の実行 の手順に従います。
source RHAMT_HOME/bash-completion/rhamt-cli
$ source RHAMT_HOME/bash-completion/rhamt-cli
永続的な bash 補完を有効にする
次のコマンドを使用すると、再起動後も bash 補完を維持できます。ただし、現在のシェルで bash 補完が必要な場合は、bash 補完を有効にする の手順に従う必要があります。
システムを再起動しても特定のユーザーの bash 補完を有効にするには、そのユーザーの
~/.bashrc
ファイルに以下の行を追加します。source RHAMT_HOME/bash-completion/rhamt-cli
source RHAMT_HOME/bash-completion/rhamt-cli
Copy to Clipboard Copied! システムの再起動後すべてのユーザーの bash 補完を有効にするには、Applications CLI bash 補完ファイルを
/etc/bash_completion.d/
ディレクトリーにコピーします。デフォルトでは、このディレクトリーは root ユーザーのみが書き込み可能です。cp RHAMT_HOME/bash-completion/rhamt-cli /etc/bash_completion.d/
# cp RHAMT_HOME/bash-completion/rhamt-cli /etc/bash_completion.d/
Copy to Clipboard Copied!
MTA ヘルプ
rhamt-cli
コマンドで利用可能な引数の完全な一覧を表示するには、ターミナルを開き、RHAMT_HOME
ディレクトリーに移動して、以下のコマンドを実行します。
RHAMT_HOME/bin/rhamt-cli --help
$ RHAMT_HOME/bin/rhamt-cli --help