データの収集方法

オンライン編集

データコレクターは Application Modernization Accelerator は、サポートされているミドルウェア環境から構成とアプリケーションの情報を収集し、詳細な近代化評価を生成します。移行経路の特定、依存関係の分析、アプリケーションの近代化とクラウド展開の準備を支援します。

のデータを収集するには、3つのアプローチがあります。 Application Modernization Accelerator.

ディスカバリー・ツールの使用
にはWSADMINコマンドを使用します。 WebSphere Application Server
アプリケーションバイナリの Migration Toolkit。

ディスカバリー・ツールの使用

ディスカバリーツールは、お客様の環境におけるミドルウェアのデプロイメントに関する情報を収集するツールです。これにより、 IBM Application Modernization Accelerator は、 IBM WebSphere Application Server、 Apache Tomcat、 Red Hat JBoss、または Oracle WebLogic アプリケーションサーバー上で動作する Java™ EE アプリケーションの移行分析を提供します。このツールは、プロファイル/ドメインごとに1つの.zipフォルダを生成し、分析結果をそのディレクトリに配置します。

Javaアプリケーションについては、 Migration Toolkit for Application Binariesを活用する。 Migration Toolkit for Application Binaries（別名「バイナリスキャナー」）を直接使用することもできます。これは特にトラブルシューティングの場面で役に立つだろう。 Migration Toolkit for Application Binariesのダウンロードと使用方法については、こちらをクリックしてください。これらのツールがすでに使用されている場合、それらを実行するために必要な同じセキュリティ要件が、ディスカバリー・ツールを実行するためにも必要です。

ディスカバリー・ツールは、バージョン 6.1 以降の WebSphere Application Server インストールの構成情報を収集します。収集される正確なコンフィギュレーション情報は、こちらをご覧ください。

アプリケーションを分析するために、ディスカバリー・ツールは以下のアクセスを必要とします：

アプリケーションサーバーのインストールディレクトリとすべてのサブディレクトリへの読み取りアクセス権
プロファイル・ディレクトリへの読み取りアクセス
ファイルとディレクトリの作成とカレントディレクトリへの書き込みアクセス

ディスカバリー・ツールは、以下に関連するデータを収集しない：

メッセージの内容またはワークロードによって処理されるデータ
ログまたはログデータ
パスワード情報

ディスカバリー・ツールのダウンロード

開始するには、以下の手順を Application Modernization Accelerator UI：

ワークスペースを作成します。
新しいワークスペースのページで、 Open Discovery Tool ボタンをクリックし、指示に従ってダウンロードします。

ディスカバリー・ツールのインストール

ディスカバリー・ツールをインストールするには、アプリケーション所有者のユーザー認証情報でアプリケーション・サーバーにログオンし、以下の手順を実行します：

ダウンロードしたファイルを、読み取り、書き込み、実行アクセスが可能なディレクトリにあるアプリケーションシステムにコピーします。

お使いのオペレーティングシステムに対応するコマンドを実行して、ダウンロードしたファイルを解凍します：

Linux: tar xvfz DiscoveryTool-Linux_<WORKSPACE_NAME>.tgz
 AIX: gunzip -c DiscoveryTool-AIX_<WORKSPACE_NAME>.tgz | tar xf -
 Solaris: tar xvfz DiscoveryTool-Solaris_<WORKSPACE_NAME>.tgz
 z/OS: gunzip -c DiscoveryTool-zOS_<WORKSPACE_NAME>.tgz | tar xf -
 Windows: unzip DiscoveryTool-Windows_<WORKSPACE_NAME>.zip

Discovery Toolディレクトリに移動する：
```
cd ama-discovery*
```
( z/OS のみ)
Discovery Tool bin ディレクトリに移動し、 z/OS 前提条件スクリプトを実行します：
```
cd ama-discovery*/bin
. zOSPrereq
 
```

必要なリソース

システム	メモリー (GB)	CPU (コア)	ディスク・スペース(GB)
ディスカバリー・ツール	2	2	0.5

ディスカバリー・ツールの実行

ディスカバリー・ツールを初めて起動すると、ライセンスが表示されます。条件に同意して続行する。

注意：ディスカバリー・ツールは本番サーバーで実行しないでください。

アプリケーションとその設定の両方を分析するには、ドメインに対してコマンドを実行する：

IBM WebSphere: ./bin/ama-discovery -w <WEBSPHERE_HOME_DIR> -p <PROFILE_NAME> [ --ignore-missing-binary --ignore-missing-shared-library --applications --applications-file --skip-applications --skip-applications-file --no-upload]
 Oracle WebLogic: ./bin/ama-discovery --web-logic-config-file <Path to the WebLogic domain config.xml file> [--applications --applications-file --skip-applications --skip-applications-file --no-upload]
 JBoss: ./bin/ama-discovery --jboss-config-dir <Path to the JBoss server configuration directory> [--applications --applications-file --skip-applications --skip-applications-file --no-upload]
 Apache Tomcat: ./bin/ama-discovery --tomcat-home-dir <TOMCAT_HOME_DIR> --tomcat-config-dir <TOMCAT_CONFIG_DIR> [--applications --applications-file --skip-applications --skip-applications-file --no-upload]

ディスカバリー・ツールで使用可能なコマンドライン・オプションを表示するには、 --help オプションを使用します。

データの表示

アプリケーションの数、サイズ、複雑さによっては、ディスカバリー・ツールの実行と結果のアップロードに時間がかかる場合があります。このプロセス中、コマンドラインをチェックすることで、進行状況を把握することができる。

あなたのシステムと新しいコレクションとの間に接続がある場合、ディスカバリー・ツールは自動的に結果を以下にアップロードします。 Application Modernization Accelerator. いくつかのレポートを含む詳細な分析が提供され、問題点やコードの変更が必要な箇所を理解するのに役立ちます。

接続がない場合、ディスカバリー・ツールはアプリケーション・データを含む .zip ファイルを返します。ワークスペース] ページの [データをアップロード] ボタンを使用して、zip ファイルを手動でアップロードする必要があります。

Application Modernization Accelerator ディスカバリー・ツールとJava

ディスカバリー・ツールの実行には、バージョン 1.7 +が必要です。第一に、ディスカバリー・ツールは、 WebSphere （これが WebSphere コレクションである場合）で使用されているJavaの互換バージョンを探す。 WebSphere Javaバージョンが見つからない場合、または WebSphere バージョンが互換性がない場合（すなわち< 1.7 ）、またはこれが WebSphere コレクションでない場合、ディスカバリーツールは -–java-home ディスカバリーツール引数で指定されたJavaの使用を試みます。 –java-home argument が提供されない場合、環境変数 JAVA_HOME で指定された Java が使用される。これらのオプションのいずれを選んでも互換性のあるバージョンのJavaが見つからない場合、ディスカバリ・ツールはディスカバリ・ツールに同梱されているJavaを使用します。

ディスカバリー・ツールのJavaのバージョンを置き換える

状況によっては、ディスカバリ・ツールを実行したいシステム上に互換性のあるバージョンのJavaがあらかじめ存在しないことがあり、ディスカバリ・ツールとともにパッケージされるJavaも、それが実行されるシステムとは互換性がありません。例えば、これはJava AMD64 アーキテクチャ用のJavaを含む Solaris Discovery Toolで発生する可能性があります。 Solaris がSPARC上で動作している場合、同梱のJavaは動作しません。このような場合、適切なJavaバージョンを使用して、独自のバージョンのディスカバリー・ツールを構築することができます。

次のステップを実行します。

ディスカバリー・ツールのバージョンをダウンロードする。 Application Modernization Accelerator UI
圧縮されたディスカバリー・ツールを解凍する
解凍されたディスカバリー・ツールの「jre」フォルダを探し、希望のJavaバージョンのjreに置き換える
オプション： 解凍されたディスカバリー・ツールには、 uploadEndpoint.json というファイルがあります。これには Application Modernization Accelerator サーバーの場所と、特定のワークスペースにアップロードするための一意のキーが含まれています。 uploadEndpoint.json 。これは、ディスカバリー・ツールがコレクションを自動的に Application Modernization Accelerator に自動的にアップロードすることはできません。 Application Modernization Accelerator UIを使用して手動でアップロードできます。 uploadEndpoint.json を削除すると、環境間で容易にコピーできるカスタム・ディスカバリー・ツールを作成できるという利点がある。事実上、ディスカバリー・ツールと特定のワークスペースとの間のリンクが解除される。 Application Modernization Accelerator.
ディスカバリーツールの圧縮

圧縮されたディスカバリー・ツールは、コレクションを実行したい環境にコピーできる。

SunOS および Solaris アーキテクチャからの移行

Application Modernization Accelerator は、 SunOS/Solaris 環境用のディスカバリー・ツールを提供している。 SunOS、 5.10、 5.11 （ Solaris 10、11）でテスト済みですが、古いバージョンでも動作する可能性があります。 SunOS/Solaris 向けに提供されるディスカバリーツールは、 AMD64 アーキテクチャ上の SunOS/Solaris で使用するためのJREをパッケージ化します。 SunOS/Solaris SPARCアーキテクチャ上でディスカバリーツールを実行したい場合、ディスカバリーツールを実行するシステム上で互換性のあるバージョンのJavaが利用可能である必要があります。

既知の問題:

SunOS/Solaris, 上でディスカバリー・ツールを実行する前に、環境上の bash のバージョンを確認してください。バージョンが 4.x 未満の場合は、ディスカバリーツールが正しく機能するよう、 4.x にアップグレードしてください。

の古いバージョンからの移行 WebSphere

ディスカバリー・ツール Application Modernization Accelerator ディスカバリー・ツールは、 WebSphere バージョン 6.1 + からの収集に対応しています。 6.1 より古いバージョンからの WebSphere 移行については、システム上にデプロイされたすべてのアプリケーション・バイナリを手動で見つけ、それらをある単一の場所に置く必要があります。その後、 -o オプションを使用してディスカバリー・ツールを実行し、その場所を指定してアプリケーションの分析を実行することができます。 -o オプションを指定してディスカバリー・ツールを実行すると、ソース WebSphere と Java バージョンを選択するよう求められます。正確なバージョンが表示されない場合は、最も正確な結果を得るために、実際のバージョンに最も近い値を選択してください。このような状況では、分析がすべての問題を捕捉しない可能性があります。サポートされているルールよりも古いバージョンの WebSphere、Javaの問題はフラグが立ちません。

対応アプリケーションサーバーからの移行

Application Modernization Accelerator は、以下のアプリケーション・サーバーからのコレクションをサポートしている：

WebSphere
Red Hat JBoss
WebLogic
Tomcat

サポートされていないアプリケーションサーバーからの移行

サポートされていないアプリケーション・サーバー（例：Glassfish）のアプリケーションに対して分析を実行したい場合は、以下のようにします：

アプリケーションのバイナリをシステムから手動で収集し、ディレクトリに配置する。
ディスカバリー・ツールを実行し、 -c オプションを使用してアプリケーションの場所を指定する。これは、Javaルールの基本セットとTomcat固有のルールを実行する。 Tomcat固有のルールは、分析対象のアプリケーション・サーバーに適用されるかもしれないし、適用されないかもしれないので、さらなる調査が必要である。ディスカバリー・ツールの将来のバージョンでは、一般的に適用されるJavaルールだけを実行するオプションが用意される予定です。

さらに調査が必要なTomcatのルールは以下の通り：

Set the sharing scope on resource references
Spring applications might fail to run from a non-expanded WAR file
Stub classes must be included when using remote Enterprise JavaBeans (EJB) 2.x
The getRealPath method previously returned null for files that do not exist
The OSGI remote bundle repository service API is unavailable
The OSGI Remote Service Admin API is unavailable
Transaction propagation is not supported for Enterprise JavaBeans (EJB) remote interfaces
Use correct case for tag attribute names
Use Java EE deployment descriptors and WebSphere bindings to define resource link references
Use Java EE deployment descriptors and WebSphere bindings to define resource references
Use Java EE deployment descriptors to define context lifecycle listeners
Use Java EE deployment descriptors to define context parameters
Use Java EE deployment descriptors to define environment references
Use Java EE deployment descriptors to define missing security roles
Validate the result of concatenation with getRealPath("")
Validate the result of concatenation with getRealPath("/")
Web Services Notification (WS-Notification) is unavailable

レポートファイルの生成に使用されるスキャンオプションのカスタマイズ

/confディレクトリ下の customCmd.propertiesファイルは、アプリケーションのスキャン中にレポートファイルを生成するために使用されるスキャンオプションを設定するために使用されます。ユーザーはこのファイルを編集してスキャンオプションをカスタマイズできる。

自分のルールを決める

のリリース以降 Application Modernization Acceleratorv2.5 のリリース以降、独自のカスタム分析ルールを定義して、アプリケーションの移行に固有のシナリオを検出できるようになりました。ユーザー定義のルールは、ここで詳しく説明するように簡単に作成できる。結果は Application Modernization Accelerator UIに表示される。

ディスカバリーツールのコマンドラインツールオプション

一般オプション

--バージョン

ディスカバリーツールのバージョンを表示します。

--help

ディスカバリーツールのすべてのオプションを表示します。

--Javaホーム

ディスカバリー・ツールに使用するJavaのバージョンを指定します。

-J-X

JVM ディスカバリーツールに渡されるオプション。「-J」は削除され、「-X」と残りのオプションはJavaランタイムに渡されます。たとえば、 “-J-Xmx4G” を実行すると、Discovery Tool ランタイムの最大ヒープサイズが 4 GB に設定されます。

--アップロードしない

フラグ。 Application Modernization Accelerator へのアップロードが行われないことを示すフラグ。

にはWSADMINコマンドを使用します。 WebSphere Application Server

WebSphere で利用可能な wsadmin コマンドには、インストールされているアプリケーションをスキャンし、zip ファイルを生成するオプションが組み込まれています。 Application Modernization Accelerator.

このコマンドを使用できるかどうかは、 WebSphere のバージョンと実行中の Fix Pack に依存します：

WebSphere 8: バージョン 8.5.5.23 以降
WebSphere 9: バージョン 9.0.5.14 以降

詳細と手順については、 Transformation Advisor データコレクションの作成と管理を参照してください。

アプリケーションバイナリの Migration Toolkit

ディスカバリーツールの代わりに Application Modernization Accelerator ディスカバリー・ツールを使用する代わりに、 Migration Toolkit for Application Binariesを使用してデータ・コレクションを生成し、それを以下にアップロードすることができます。 IBM Application Modernization Accelerator.

この方法の詳細については、 Transformation Advisor データ収集を参照のこと。