|
|
WebOTX Manual V12.1 (第3版) 目次を表示 |
|
|
|
WebOTX Manual V12.1 (第3版) 目次を表示 |
| 移行元環境 |
WebOTX WebLogic Server JBoss EAP Apache Tomcat |
| 移行先非互換検証対象 |
JDK(JDK5,6,7,8,11,17,21,OpenJDK) JavaEE JakartaEE10 WebOTXフルプロファイル WebOTXマイクロプロファイル WebOTXコンテナ環境 |
Memo
アプリケーションアーカイブファイルの検証では、対象アーカイブファイル内に含まれるjar等のアーカイブファイルも検証対象となります。
Caution
フォルダを指定し、フォルダ内の複数のアーカイブファイルを同時に検証することも可能ですが、マーカー表示や出力レポートに問題が生じる場合があります。
[注意事項 > 大量かつ重複のアーカイブファイルを同時検証する際の注意事項]および、
[注意事項 > 重複アーカイブファイルに対するマーカー表示]を参照してください。
Memo
ソースフォルダを対象とする際、プルダウンメニューにアプリケーション検証がない場合、[注意事項 > ソースフォルダに対してのアプリケーション検証について] を参照してください。
Caution
JavaDoc構文が存在するjavaソースファイルを検証した場合、ソースレポート内で指摘される行数がずれる事があります。
JavaDoc構文が存在する場合のソースレポートについては、[JavaDoc構文が存在する場合のSource Report
(移行課題があるソースの詳細)]を参照してください。
Memo
レポート出力先に同名のフォルダが存在する場合は、新しいレポート内容が上書き保存されます。
既存のレポート内容を保存する場合は、対象フォルダをリネームして保存してください。
Memo
検証処理時のログは、{AS_INSTALL}\Developer\migration_Toolkit\logに出力されます。
Caution
マーカービュー、問題ビュー等のマーカーを表示するビューにはフィルタ機能による表示数制限があり、既定値ではグループ（分類）ごとに100件までとなっています。
アプリケーション検証結果が大量に存在することで表示できないマーカーは、本設定を変更することで表示可能となります。
設定変更手順については[マーカーの表示数設定]を参照してください。
| 項目 | 説明 |
|---|---|
| 件名 | 指摘の概要を表示します。 |
| 説明 | 指摘の詳細を表示します。 |
| カテゴリ | 指摘のカテゴリを表示します。詳細はカテゴリを参照してください。 |
| ストーリーポイント | 指摘のストーリーポイントを表示します。詳細はストーリーポイントを参照してください。 |
| ルールID | 指摘のルールIDを表示します。 |
| リンク | 指摘に関連するリンク情報を表示します。 |
| ソース | 現在は未使用のフィールドです。 |
Caution
アプリケーション検証実行により表示するアプリケーション検証マーカーは、開いているエディタ及び各ビューに非同期に表示します。
詳細は[注意事項 > アプリケーション検証マーカーは非同期に表示する]を参照してください。
Memo
アプリケーション検証マーカーはDeveloperを終了すると同時に自動で削除し、次回起動時には持ち越しません。
Developerを再起動した際は、再度アプリケーション検証を実行してください。
ファイルパス：{AS_INSTALL}\Developer\Studio\plugins\com.nec.webotx.appmigtool_{バージョン名}\config.properties
アプリケーション検証機能の変更可能な設定項目は以下の通りです。
| 属性名(attribute-name) | 説明 | 既定値 |
|---|---|---|
| sourceMode |
ソースファイル、アーカイブファイルを検証対象とするかどうかを設定します。 設定値による検証動作は以下のようになります。 true: 検証対象のアプリケーションに含まれているJavaソースファイル、xmlファイル等を解析します。 検証対象のアプリケーションにコンパイルされたアーカイブファイルが含まれている場合、アーカイブファイルのMaven座標等の情報を検証します。 false: アーカイブファイルを検証対象とする場合に設定します。 検証対象のアプリケーションに含まれているアーカイブファイルを展開、デコンパイルします。 展開されたJavaソース、xmlファイル等を検証します。 |
false(V11.2以降) |
| output |
レポート出力フォルダを指定する場合に設定します。 設定しない場合、レポート出力先は {AS_INSTALL}\Developer\migration_Toolkit\report\{検証対象フォルダ名}.report となります。 指定したフォルダが存在しない場合、新たにフォルダを作成してレポートを格納します。 既にフォルダが存在する場合は、新しいレポート内容が上書き保存されます。 レポート出力フォルダを指定する場合、パス表記は [注意事項 > config.propertiesのoutputパラメータについて] を参照してください。 相対パスを指定する場合、レポート出力先は {AS_INSTALL}\Developer\Studio\{指定した相対パス}となります。 |
なし |
| userIgnorePath | 検証除外設定ファイルを配置したフォルダパスを指定します。 詳細については、--userignorepathオプションを参照してください。 |
なし |
| rmiPort | アプリケーション検証時に使用するRMIポートを設定します。 | 1100 |
Memo
プロパティファイルの設定値を変更した場合、Developerの再起動は必要ありません。
| OS | JDK | メモリ |
|---|---|---|
| WebOTX AS、および WebOTX Developer(with Developer's Studio)の環境に準ずる |
Oracle JDK 11、17、21 OpenJDK 11、17、21 |
最小4GB (8GB以上を推奨) |
{TOOL_DIR} > .\bin\amt-cli.bat --sourcemode --input {検証対象フォルダ} --output {検証結果出力先フォルダ} --target {移行先ターゲット}
Memo
アプリケーション検証ツールコマンドの詳細については、[その他機能 > アプリケーション検証ツールコマンド]を参照してください。
| 番号 | 説明 |
|---|---|
| １ | 検証されたアプリケーション名、またはフォルダ名 クリックすることで、Dashboard (レポートインデックス) 画面に遷移します。 |
| ２ | 検証されたアプリケーションのストーリーポイント(※１) |
| ３ | Cloud Mandatoryカテゴリごとの検出数(※２) |
| ４ | Informationカテゴリごとの検出数(※２) |
| ５ | 総検出数 |
| ６ | 使用されている技術 |
| ７ | ヘッダメニュー ヘッダメニューから表示されるレポートは複数アプリケーションの情報が表示されます。 |
(※1) ストーリーポイント
(※2) カテゴリごとの検出数
| 番号 | 説明 |
|---|---|
| １ | 検証されたアプリケーションに使用されている技術を機能別に分類し 「EJB」などの項目をクリックすると、３のソート対象データをもとに降順/昇順で並べ替えられます。 |
| ２ |
検証されたアプリケーション名 表示項目の「Name」をクリックすることでファイル名でソートされます。 検証されたアプリケーション名をクリックすることで検証されたアプリケーション単位の Technologies (使用されている技術)に遷移します。 |
| ３ | ソート対象データ |
| ４ | 検証されたアプリケーションで使用されている技術がどのように分散されているかを示しています。 |
| ５ | 検証されたアプリケーションのサイズ、ライブラリの数、ストーリーポイントの合計が表示されます。 |
| 番号 | 説明 |
|---|---|
| １ | 複数のアプリケーション単位の各依存関係が表示されます。 |
| ２ | 選択されたファイル名、またはフォルダ名 グラフ表示されたアイコンが選択されている場合に表示されます。 |
| ３ |
グラフアイコンの凡例 ※3rd-party JARs について アプリケーション検証機能内のリポジトリからMaven座標を取得し、Maven座標が存在するライブラリを3rd-party JARsとします。 一部3rd-party JARsとして判定できないjarが存在します。[注意事項 > 3rd-party JARsについて] を参照してください。 |
| 番号 | 説明 |
|---|---|
| １ | カテゴリごとの検出インシデント数とストーリーポイント数 |
| ２ | 検出カテゴリ(※２)毎の検出インシデント数 |
| ３ | 検出カテゴリ(※２)の検出インシデント数とストーリーポイント数 |
| ４ | ストーリーポイントレベル(※１)に対する検出インシデント数、ストーリーポイント数 |
| ５ | ストーリーポイントレベル(※１)毎の検出インシデント数 |
| ６ | カテゴリ別の検出インシデント数 |
| ７ | Javaパッケージ毎の検出インシデント数 |
| ８ | Javaパッケージ毎の検出インシデント数の構成比 |
(※1) ストーリーポイントレベル
(※2) 検出カテゴリ
| レポート | 説明 |
|---|---|
| Issues (移行課題) | 注意を要するすべての問題の簡潔な要約を提供します。 |
| Application Details (アプリケーション詳細) | アプリケーション内で見つかった、移行中に注意が必要なすべてのリソースの詳細な概要を提供します。 |
| Technologies (使用されている技術) | 機能別にグループ化されたすべての埋め込みライブラリを表示し、各アプリケーションで使用されている技術を表示します。 |
| Dependencies Graph (依存関係グラフ) | 分析されたアプリケーション内で見つかったすべてのJavaパッケージの依存関係のグラフを表示します。 |
| Dependencies (依存関係) | アプリケーション内で見つかったすべてのJavaパッケージの依存関係を表示します。 Shaded-jar の解析についての注意事項があります。 [注意事項 > Shaded-jarの解析について] を参照してください。 |
| Remote Services | アプリケーション内で見つかったすべてのリモートサービス参照を表示します。 |
| EJB Report | アプリケーション内で見つかったEJBのリストを表示します。 情報内に「unknown」が出力される事象が発生する場合があります。[注意事項 > EJBレポートに出力される「unknown」情報について] を参照してください。 |
| Server Resources | アプリケーションのすべてのサーバーリソース（JNDIリソースなど）を表示します。 |
| Ignored Files (除外ファイル) | 処理されなかったアプリケーションで見つかったファイルを表示します。 詳細については、--userignorepathオプションを参照してください。 |
Caution
一部検出に制限がある場合があります。
[注意事項 > 要素の型を指定するクラスの検出について]
を参照してください。
| 番号 | 説明 |
|---|---|
| １ | カテゴリ(※１) |
| ２ | 検証されたアプリケーション内で検出したインシデント名(※２) |
| ３ | 検出インシデント毎の総数 |
| ４ | 検出インシデントのストーリーポイント(※３) |
| ５ | 検出インシデント毎の総数に対するストーリーポイント総数(※４) |
(※１)カテゴリ
(※２)インシデント名を選択するとインシデントの詳細情報を表示します。
(※３)ストーリーポイントレベル
(※４)ストーリーポイント総数(検出インシデント毎の総数×検出インシデントのストーリーポイント)
| 番号 | 説明 |
|---|---|
| １ | 検証されたアプリケーション内で検出したインシデント名 |
| ２ | インシデントが検出されたファイル名(※１) |
| ３ | ファイル内検出インシデント数(※２) |
| ４ | 検出インシデント詳細 |
| ５ | インシデント検出ルール(※３) |
(※１)ファイル名を選択するとソースレポートを表示します。
(※２)ストーリーポイント数。
(※３)選択すると検出ルールを表示します。
| 番号 | 説明 |
|---|---|
| １ | ファイル内でのストーリーポイント総数 |
| ２ | 検出インシデントの概要説明 |
| ３ | インシデントを検出したソースコード行数 |
| ４ | インシデント対応のヒント |
| ５ | インシデント検出ルール(※１) |
(※１)選択すると検出ルールを表示します。
| レベル | ストーリーポイント | 説明 |
|---|---|---|
| Information | ０ | 優先度が非常に低い情報 |
| Trivial | １ | 些細な対応、使用APIの変更、または使用ライブラリ変更等 |
| Complex | ３ | 複雑な対応が必要 |
| Redesign | ５ | 大幅なAPIの変更を伴う再設計、またはライブラリの完全な変更が必要 |
| Rearchitecture | ７ | 完全なコンポーネント、またはサブシステムの再構成が必要 |
| Unknown | １３ | 完全な書き換えが必要な場合がある |
| 名称 | 説明 |
|---|---|
| Cloud Mandatory | 必ず解決が必要です。 変更が行われない場合には移行先環境にて正常に動作しません。 |
| Cloud Optional | 移行先環境でアプリケーションは動作するが正常に動作しないことがあります。 |
| Mandatory | 必ず解決が必要です。 変更が行われない場合、正常に動作しません。 |
| Optional | アプリケーションは動作するが正常に動作しないことがあります。 |
| Potential | 移行先環境での互換性など調査が必要です。 |
| Information | 問題はありませんが、将来的に調査または修正が必要です。 |
| 番号 | 説明 |
|---|---|
| １ | インシデントを検出されたとしてJavaDoc先頭行にインシデント対応のヒント「Micropro Service(inheritance)」が表示されます。 |
| ２ | 指摘されている行の前にJavaDoc構文のブロックコメントが存在するため、この行で指摘されたインシデントが１の位置に表示されます。 |
| ３ | インシデントを検出されたとしてJavaDoc先頭行にインシデント対応のヒント「Java Remote Method Invocation (RMI) API」が表示されます。 |
| ４ | 指摘されている行の前にJavaDoc構文のブロックコメントが存在するため、この行で指摘されたインシデントが３の位置に表示されます。 |
| ５ | 指摘されている行の前のブロックコメントがJavaDoc構文ではないため、位置ずれなくインシデント対応のヒント「Java Remote Method Invocation (RMI) API」が表示されます。 |
Memo
アプリケーション検証機能は、アプリケーションアーカイブファイルを使った検証を推奨しています。
Memo
出力されるCSVファイルの文字コードはUTF-8です。
| データフィールド | 説明 |
|---|---|
| Rule Id (ルールID) | インシデントを生成したルールのIDを示します。 |
| Issue Category (カテゴリ) | インシデントのカテゴリを示します。 |
| Title (件名) | インシデントの問題の要約を示します。 |
| Description (説明) | インシデントの詳細な説明を示します。 Descriptionについての注意事項があります。 [注意事項 > CSVレポートのDescriptionについて] を参照してください。 |
| Links (リンク) | インシデントに関する追加情報を提供するURLを示します。 |
| Application (アプリケーション) | インシデント対象のアプリケーションの名前を示します。 |
| File Name (ファイル名) | インシデント対象のファイル名を示します。 |
| File Path (ファイルパス) | インシデント対象のファイルパスを示します。 |
| Line (行) | インシデント対象のファイル内行番号を示します。 |
| Story points (ストーリーポイント) | インシデントのストーリーポイントを示します。 |
）ではアプリケーション検証のメニューが表示されません。
） ＞ コンテンツタブ ＞ Java要素のチェックを外す
| 件名 | Unparseable Java File |
| ルールID | IndexJavaSourceFilesRuleProvider_1 |