ディスカバリーツールのトラブルシューティングガイド

オンライン編集

ディスカバリーツールは Transformation Advisor ディスカバリー・ツールは、 Migration Toolkit for Application Binariesと呼ばれるツールを使用する。 バイナリー・スキャナーを直接使用できます。 これは、一部のトラブルシューティング・シナリオで特に役立つ場合があります。

アプリケーションバイナリ用のディスカバリーツールとMigration Toolkit

Migration Toolkit for Application Binariesのダウンロードと使用方法については、 こちらをクリックしてください。

コレクションZIPファイルのアップロードに失敗しました。 Transformation Advisor サーバー

ディスカバリー・ツールがアプリケーションのコンフィギュレーション情報を収集した後、zipファイルを作成し、それをサーバーにアップロードしようとする。 Transformation Advisor サーバーにアップロードしようとします。 サーバーに到達できないと、以下のエラー・メッセージが表示されることがあります。

Current Operation: Error occurred: Problem connecting with server See log for details.

この問題を回避するには、ディスカバリーツールのディレクトリからコレクションのzipファイルを取得し、UIのコレクションページからサーバーに手動でアップロードします。 Transformation Advisor サーバーに手動でアップロードします。

WebSphere プロファイル (profile_name) が存在しません

このメッセージは、ディスカバリツールが WAS プロファイルレジストリから入力プロファイル名を見つけられない場合に表示されます。 $WAS_HOME/properties/wasprofile.properties ファイルに定義されている WS_PROFILE_REGISTRY を調べて、入力プロファイル名が正しいことを確認します。

デフォルトの profileRegistry.xml ：

WS_PROFILE_REGISTRY=${was.install.root}/properties/profileRegistry.xml

このデフォルトのファイルをプロファイル・レジストリーの XML ファイルで使用していない場合は、$WAS_HOME/properties/profileRegistry.xml から実際のプロファイル・レジストリー・ファイルの場所へのシンボリック・リンクを作成してください。

WebSphereの Webアプリケーションのコンテキストルートが、検出ツールによって不正であることが検出された

バージョン Transformation Advisor バージョン 1.9.4 以降では、ディスカバリーツールは WebSphere で実行されているウェブアプリケーションのコンテキストルートを検出します。 アプリケーションへのアクセスを簡単にするために、Liberty のデプロイメントでは、アプリケーションのコンテキスト・ルートが使用されます。 コンテキスト・ルートが正しくないと、デプロイされたアプリケーションにアクセスしたときに、以下のエラー・メッセージのページが表示されます。

Context Root Not Found.

この問題を回避するには、Git リポジトリーにあるアプリケーションの Helm チャートを次のように更新します。

  1. アプリケーションの Helm チャートが入った Git リポジトリーを複製します。

  2. ファイル chart/[application name]/values.yaml を編集し rewriteTarget を'/'に変更する：

    ingress:
  enabled: true
  rewriteTarget: "/"

  3. 変更をコミットして Git リポジトリーにプッシュします。

  4. アプリケーションが再デプロイされるまで待ちます。 アプリケーションの Ingress パスが、Liberty 基本ページにリダイレクトされるようになります。 その Ingress パスにアプリケーションのコンテキスト・ルートを付加すると、アプリケーションにアクセスできます。

例えば、イングレスパスが modresortsで、アプリケーションのコンテキストルートが resortsの場合、アプリケーションにアクセスするための URL は http://[OCP public IP]/modresorts/resorts/。

ディスカバリーツールがserver.xml アーティファクトを生成できない

ディスカバリーツールをデプロイメントマネージャーを起動したユーザー以外のユーザーが実行した場合、 server.xml アーティファクトの生成に失敗します。 収集された成果物は、構成分析を要求していないコレクションのように見えます。 バージョン Transformation Advisor1.9.4 より前のバージョンでは、以下のエラーが表示されることがあります：

Exception in thread 'main' java.io.FileNotFoundException: <some_path>_server.xml (A file or directory in the path name does not exist.)

    at java.io.FileInputStream.<init>(FileInputStream.java:113)
    at java.io.FileInputStream.<init>(FileInputStream.java:73)
                ...
                ...

ディスカバリツールは、デプロイメントマネージャを起動したのと同じユーザーとして実行する必要があります。 ps コマンドを使用して、起動したユーザーを確認できます。

注意： すでに別のユーザーとしてディスカバリーツールを解凍している場合、新しいユーザーとして実行する前に、解凍したディスカバリーツールのディレクトリのパーミッションまたは所有者を編集する必要があるかもしれません。 あるいは、新しいユーザーとしてディスカバリー・ツールを再び解凍することもできる。

チェックサムエラーにより、ディスカバリーツールの抽出に失敗しました

ディスカバリーツールの抽出を試みた後にチェックサムエラーが返された場合は、次の回避策をお試しください

gzip -d transformationadvisor-<OperatingSystem>_<workspace>_<collection>.tgz
tar xf transformationadvisor-<OperatingSystem>_<workspace>_<collection>.tar

英語以外のロケールでディスカバリツールを実行するとエラーが発生する

コマンドを使用してディスカバリー・ツールを実行した際に、 Connecté au processus dmgr sur le noeud ... （または同様の何か）が表示された場合
/data/WebSphere/AppServer/profiles/Dmgr01/bin/wsadmin.sh -user wasadmin -password wasdm1i -lang jython -c "AdminApp.list()"
以下の回避策をお試しください：

ディスカバリーツールを実行しているターミナルで、次のように入力します

export LANG=C

その後、ディスカバリーツールコマンドを再度実行すると、問題を回避できるはずです。

バイナリー・スキャナーが com.ibm パッケージを無視する

ディスカバリーツールは、特定のパッケージを無視するように設定することができます。 $TA_HOME/conf ディレクトリにある customCmd.properties ファイルを確認してください。 無視されるパッケージがある場合は、その行をアンコメントして、それらのパッケージが含まれるようにコマンドを変更できます。 バイナリスキャナを起動する際、発見ツールにはコメントアウトされていないコマンドが含まれます。

指定したプロファイルに対して実行する場合、発見ツールは管理プロファイルをスキップします

マネージド・プロファイルは、コンフィギュレーションのコピーが dmgr に保持されているため、スキップされる。 dmgr 、この問題は解決するはずだ。

検出ツールは、指定されたプロファイルに対して実行された場合、ゼロ・バイナリ・コピー・モードを使用してインストールされたアプリケーションをスキップします

ゼロバイナリコピーモードでインストールされたアプリケーションは、ディスカバリーツールが移行分析を生成するために必要なアプリケーションのすべての設定を取得できないため、スキップされます。 このタイプのアプリケーションのマイグレーション工数を求めるには、手動で評価する必要があります。

ディスカバリーツールを実行すると、 libjvm.so failed to load: エラーが発生します

このエラーは、Java が正しいライブラリーを検出できない場合に発生することがあります。 ディスカバリーツールでダウンロードしたJavaバージョンではなく、マシン自体に搭載されているJavaバージョンを使用してください。 このエラーを解決するには、以下の手順を実行します。

  1. wsadminが特定のユーザーによって所有または実行されているかどうかを確認する。 もしそうであれば、同じユーザーがディスカバリツールを実行すべきです。

  2. ユーザーが、ディスカバリーツールをアンパッケージした場所に対して、読み取り、書き込み、実行の権限を持っていることを確認してください。

以下の手順に従って、マシン上にある Java バージョンを確実に使用してください。

  1. cd into transformationadvisor-2.1.

  2. JRE ディレクトリーを、WAS マシン自体の JRE ディレクトリーに置き換えます。

  3. ディスカバリーツールのコマンドを再度実行します。

アップロード中にエラーが発生 - 互換性のないファイルが検出されました

この発見ツールは、各アプリケーションにリンクされたレポートを作成します。 このエラーが表示された場合は、1 つ以上のアプリケーションが正しく処理されなかったこと、また、レポートをアプリケーションにリンクするステップが失敗したことを意味します。

この問題は、次のようにして解決できます。

  1. profile.zip ファイルを解凍します。

  2. 以下の名前のファイルを削除する：

    InventoryReport.json, InventoryReport.html, AnalysisReport.json,
AnalysisReport.html, TechnologyReport.json, TechnologyReport.html

  3. ZIPファイルを手動で Transformation Advisor に手動でアップロードしてください。

アプリケーションが欠落していないか調べるには、次のようにします。

  1. のアプリケーションのリストを取得する。 Transformation Advisor.

  2. WAS_HOME 内の profiles ディレクトリーを調べ、該当するプロファイルでインストールされているアプリケーションの完全なリストを確認します。

  3. プロファイルに欠けているアプリケーションを特定する Transformation Advisor.

ディスカバリーツールをダウンロードし、 Linuxにコピーした後、tarの解凍に失敗しました

代わりに以下のコマンドを試してください。

gzip -d transformationadvisor-2.1_Linux_xxxxxx.tgz
tar xf transformationadvisor-2.1_Linux_xxxxx.tar

データのアップロード後にマイグレーション・ファイルをダウンロードできない

ディスカバリーツールからzipファイルを Transformation Advisor UI にアップロードしても、移行バンドルや移行ファイルをダウンロードできない場合は、サーバー構成を取得できるように完全な分析を実行する必要があります。 Transformation Advisor を実行する必要があります。 以下のコマンドを実行します。

bin\transformationadvisor.bat -w <WEBSPHERE_HOME_DIR> -p <PROFILE_NAME>

その後、アップロードを再試行してください。

WebSphereにスペースが含まれるパスが指定されている場合、Windowsの検出ツールは動作しません

次のコマンドでWindows検出ツールを実行すると、

bin\transformationadvisor.bat -w "C:\Program Files (x86)\IBM\WebSphere\AppServer" -p AppSrv01

発見ツールがエラーメッセージを表示することがあります。 以下の手順で問題を解決してください：コマンドプロンプトを開き、ショートパスを知りたいディレクトリに移動する。

Type dir /x

ショートカット名でディスカバリツールを実行します。例えば：

bin\transformationadvisor.bat -w "C:\PROGRA~2\IBM\WebSphere\AppServer" -p AppSrv01

Windowsの検出ツールは、デフォルトのパスに展開した後、動作しない

Windowsディスカバリーツールを
bin\transformationadvisor.bat -w "C:\Program Files\IBM\WebSphere\AppServer" -p AppSrv01 admin admin
コマンドを実行し、以下の出力を見る：

コマンド・コンソールに、入力行が長すぎるというメッセージが表示されているスクリーン・ショット

TA_HOME のパスが長すぎます。 この問題を回避するには、ディスカバリーツールのZIPファイルをアンパックする際に、パスにすでに transformationadvisor-2.1が含まれている場合は、ファイル名をサブディレクトリとして使用するオプションのチェックを外します。 このボックスのチェックを外すと、ディスカバリーツールは次の場所に解凍します。 C:\Users\Administrator\TA\DC\transformationadvisor-2.1

ファイル名をサブディレクトリーとして使用するために、抽出ツールでオプションのチェック・マークを外す方法を示すスクリーン・ショット

z/OSでディスカバリツールを実行する手順

注： z/OS 環境での発見ツールの実行は、bash のバージョン 4.2 と 4.3 でテストされている。

  1. ディスカバリーツールは、3270タイプのデバイスでは動作しない方法で画面の更新を使用するため、UnixシステムサービスOMVSシェルではなく、sshセッションから実行することをお勧めします。

  2. まだ使用可能になっていない場合には Bash をインストールし、export PATH=/usr/bin/rocket/bash-4.3/bin:$PATH などのシステム・パスに追加されたことを確認します。

  3. gunzip がまだ入手可能でなければ、Rocket Software などからインストールしてください。

  4. z/OS マシンにディスカバリツールファイル transformationadvisor-zOS.tgz を sftp/ ダウンロードする。

  5. .tgz ファイルを解凍します。例えば、 gunzip -c transformationadvisor-zOS.tgz | tar xf - を実行します。

  6. transformationadvisor-2.X.Xの所有権が、後にディスカバリーツールを実行するユーザーのものであることを確認してください。 必要に応じて、フォルダのパーミッションと所有権を変更してください：

    chown -R <user> transformationadvisor-2.X.X

  7. ディレクトリを transformationadvisor-2.X.X フォルダに変更し、システムパスに追加する。

  8. 通常のシェルから実行する：

    cd bin && . ./zOSPrereq && cd ..

  9. すべてのランオプションを見るには

    bin/transformationadvisor --help

    ディスカバリーツールを初めて実行すると、ライセンス契約のテキストが表示されますので、内容をご確認ください。

    メモリ関連の問題が発生した場合は、 -J-Xmx512m オプションを追加する：

    bin/transformationadvisor -J-Xmx512m --help

  10. (このステップは Transformation Advisor3.0 以降は不要です) ユーザー定義ルールを使用する場合（この機能は Transformation Advisor2.5.0 でしか利用できない機能）、 conf/userDefinedRules ディレクトリ内のすべてのファイルは UTF-8 であり、そのエンコーディングで保持する必要があることに注意してください。 したがって、 z/OS でこの機能を使用するには、別のシステムで UTF-8 のファイルを操作し、それらをコピーして戻します。

  11. 例えば、ディスカバリーツールを実行する：

    bin/transformationadvisor -w <WAS home>

    または

    bin/transformationadvisor -w <WAS home> -p default

  12. ディスカバリー・ツールはzipファイルを作成する。例えば、 default.zip、 にアップロードできる。 IBM Transformation Advisor UIにアップロードできる。