インストールのトラブルシューティング

WebSphere Process Server のインストール失敗のトラブルシューティング方法。

インストールが正常に行われなかったとき、このトピックを使用して考えられる問題を診断します。 インストーラー・プログラムは、1 次ログ・ファイルの末尾に以下に示す成功の標識を記録します。このログ・ファイルは、Linux および UNIX プラットフォームでは install_root/logs/wbi/log.txt に、Windows プラットフォームでは install_root¥logs¥wbi¥log.txt にあります。
  • INSTCONFSUCCESS: インストールは正常に終了しました。
  • INSTCONFPARTIALSUCCESS: インストールは部分的に正常に終了しました。一部のインストール操作は失敗しましたが、再試行可能です。
  • INSTCONFFAILED: インストールは正常に終了しませんでした。 リカバリーは不可能です。
結果が INSTCONFPARTIALSUCCESS またはINSTCONFFAILED の場合は、以下のステップを実行して問題の分析を続行します。
  1. インストール・プロセスでエラー・メッセージが表示された場合は、エラー・メッセージ: インストールおよびプロファイルの作成と拡張の説明を確認します。

    メッセージが、記載されているものと対応する場合は、問題を訂正し、インストールされた部分をクリーンアップして、再インストールを試みます。

    再インストールの前にインストールされた部分をアンインストールする方法の詳細については、tins_uninstman.htmlを参照してください。

  2. WebSphere Application Server Network Deployment のインストールが正常に完了したかどうかを判別します。 WebSphere Process Server のインストールが正常に完了しなかった場合は、最初に、Linux および UNIX プラットフォームの場合は install_root/logs/log.txt で、Windows プラットフォームの場合は install_root¥logs¥log.txt でエラーがないかどうか調べ、WebSphere Application Network Deployment のインストールが正常に完了したかどうかを判別します。WebSphere Application Server Network Deployment のインストールが失敗した場合は、WebSphere Application Server Network Deployment バージョン 6.0 インフォメーション・センターにある WebSphere Application Server Network Deployment のインストールのトラブルシューティング情報を参照し、WebSphere Process Server の再インストールを試行する前に、その情報を使用して問題を訂正します。WebSphere Application Server Network Deployment のインストールは正常に完了したが、WebSphere Process Server のインストールは失敗した場合、以下のトラブルシューティング情報を使用して問題を訂正します。
  3. インストール後に、WebSphere Process Server インストール・ログ・ファイルでエラーがないか調べます。

    作成されるさまざまなログ・ファイルの名前、ロケーション、および説明については、ログ・ファイルを参照してください。以下の順序でログ・ファイルを確認してください。

    Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合:
    1. install_root/logs/wbi
    2. %tmp% (install_root/logs/wbi にファイルがない場合)
    3. install_root/logs/wasprofile/wasprofile_create_ profile_name.log または install_root/logs/wasprofile/wasprofile_augment_ profile_name.log。 完全インストールを実行した場合、default という名前のスタンドアロン・サーバーが作成され、profile_name の値は default になります。
    4. インストール操作によって生成される追加のログ・ファイルまたはトレース・ファイル。install_root/logs/wbi で、インストール(またはアンインストール) プロセスの間に生成されたトレース・ファイルを探します。profile_root/logs で、プロファイルの作成または拡張によって生成されたトレース・ファイルを探します。ここで、profile_rootWebSphere Process Server プロファイルのインストール・ロケーションを表します (Linux または UNIX プラットフォームでは、デフォルトは install_root/profiles/profile_name)。これらのファイルは、主に IBM 技術サポートが使用するためのものです。
    Icon indicating Windows platforms Windows プラットフォームの場合:
    1. install_root¥logs¥wbi
    2. %tmp% (install_root¥logs¥wbi にファイルがない場合)
    3. install_root¥logs¥wasprofile¥wasprofile_create_ profile_name.log または install_root¥logs¥wasprofile¥wasprofile_augment_ profile_name.log。 完全インストールを実行した場合、default という名前のスタンドアロン・サーバーが作成され、profile_name の値は default になります。
    4. インストール操作によって生成される追加のログ・ファイル。install_root¥logs¥wbi で、インストール(またはアンインストール) プロセスの間に生成されたトレース・ファイルを探します。profile_root¥logs で、プロファイルの作成または拡張によって生成されたトレース・ファイルを探します。ここで、profile_rootWebSphere Process Server プロファイルのインストール・ロケーションを表します (Windows プラットフォームでは、デフォルトは install_root¥profiles¥profile_name)。これらのファイルは、主に IBM 技術サポートが使用するためのものです。
  4. インストール・ログに情報が含まれていない場合は、応答ファイルを指定して -log パラメーターを使用します。
    あるイベントによって、InstallShield for Multiplatforms (ISMP) がインストール・ウィザードを開始できない場合があります。 このようなイベントとは、例えば、インストール・ウィザードの起動に十分なディスク・スペースがないことなどです。 インストールが失敗し、インストール・ログに情報がない場合は、-log パラメーターを応答ファイルと共に 使用して、ISMP プログラムがインストール・ウィザードの開始に失敗する原因となるイベントのエントリーを記録します。 これは、以下の応答ファイルのいずれを使用しても機能します。
    • responsefile.wps.txt
    • responsefile.pcaw.standAloneProfile.txt
    • responsefile.pcaw.dmgrProfile.txt
    • responsefile.pcaw.managedProfile.txt

    応答ファイルについて詳しくは、iins_rf_wps.htmlを参照してください。

    応答ファイルを使用するには、WebSphere Process Server CD 1 からシステムのハード・ドライブに応答ファイルをコピーする必要があります。このようなイベントをログに記録する install コマンドの構文は、以下の例に示すようになります (応答ファイルとログ・ファイルへのパス、および応答ファイルの実際の名前は異なる場合があります)。

    Icon indicating AIX platforms AIX プラットフォームの場合:
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating HP-UX platforms Icon indicating Solaris platforms HP-UX および Solaris プラットフォームの場合:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating Linux platforms Icon indicating 6.0.1 content only Linux プラットフォームの場合:
    install -options "/opt/ibm/WebSphere/silentFiles/myresponsefile.txt"
            -silent -log # !/opt/ibm/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating Linux platforms Linux プラットフォームの場合:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating Windows platforms Windows プラットフォームの場合:
    install.exe -options
                "C:¥Program Files¥IBM¥WebSphere¥silentFiles¥myresponsefile.txt"
                -silent -log #
                !C:¥Program Files¥IBM¥WebSphere¥silentFiles¥log.txt  @ALL
  5. 失敗した構成スクリプトがインストールの問題の原因となっているかどうかを判別します。

    Linux および UNIX プラットフォームの場合の install_root/logs/wbi/instconfig.log ファイル、または Windows プラットフォームの場合の install_root¥logs¥wbi¥instconfig.log ファイルは、製品の正常な動作を妨げる可能性がある構成の問題を示します。ストリング action failed を検索して、失敗した構成スクリプトの名前を検出します。

  6. install_root/classes ディレクトリー内に、ファイルが存在していないかどうか検証してください。

    IBM サポートはカスタマーのための作業をキューに入れ、テストまたはデバッグ修正を提供する場合があります。 修正用の共通ロケーションは、install_root/classes ディレクトリーの中です。

    デフォルトでは、install_root/classes ディレクトリーが最初に WebSphere Process Server クラスパスで選択され、他のクラスをオーバーライドします。

    このディレクトリーに修正を置くことにより、 ユーザーは、修正が問題を実際に解決するかどうかを検査できます。 修正が問題を解決することを検査したら、install_root/classes ディレクトリーから 修正を削除して、システムを作業状態に戻す必要があります。

    install_root/classes ディレクトリーからこのような修正を除去しない場合は、 エラーが発生します。

  7. エラー・ログに問題の原因を判別するための十分な情報が含まれない場合は、 製品をアンインストールし、ログ・ファイルまたはその他の成果物が残っていればクリーンアップし、トレースをオンにしてから再インストールします。
    • 以下のように、install コマンドに -is:javaconsole パラメーターを追加して、標準出力ログおよび標準エラー出力 ログをコンソール・ウィンドウにレポートします。
      • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合:
        install -is:javaconsole
        次のコマンドで、ストリームをファイルに取り込みます。
        install -is:javaconsole > captureFileName.txt 2>&1
      • Icon indicating Windows platforms Windows プラットフォームの場合:
        install.exe -is:javaconsole
        次のコマンドで、ストリームをファイルに取り込みます。
        install.exe -is:javaconsole > drivecaptureFileName.txt
    • -is:log file_name オプションを使用して、選択したログに対する追加情報を取り込みます。
    • 以下のように、install コマンド に -W Setup.product.install.logAllEvents="true" パラメーターを渡して、 追加のインストール・ロギングをオンにします。
      • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合:
        install -W Setup.product.install.logAllEvents="true"
      • Icon indicating Windows platforms Windows プラットフォームの場合:
        install.exe -W Setup.product.install.logAllEvents="true"
  8. プロセス・サーバー・プロファイルを正常に作成した場合は、 ファースト・ステップ・コンソールまたはコマンド行方式を使用して、プロセス・サーバーを始動します。
    特定のノードのファースト・ステップ・コンソールを始動 (ここで profile_rootWebSphere Process Server のインストール・ロケーション (デフォルトは、 Linux および UNIX プラットフォームではinstall_root/profiles/profile_name、Windows プラットフォームでは install_root¥profiles¥profile_name) を表します):
    • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: profile_root/firststeps/wbi/firststeps.sh
    • Icon indicating Windows platforms Windows プラットフォームの場合: profile_root¥firststeps¥wbi¥firststeps.bat
    コマンド行からサーバーを始動します。
    1. ディレクトリーを、プロファイル内の profile_root/bin ディレクトリーに変更します。
    2. サーバー・プロセスを開始します。
      • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: ./startServer.sh server_name
      • Icon indicating Windows platforms Windows プラットフォームの場合: startServer.bat server_name
  9. 実行中の Java プロセス、および SystemOut.log ファイル と SystemErr.log ファイル内の「Open for e-business」という メッセージを調べて、サーバーが適切に始動およびロードされていることを確認します。

    Java プロセスが存在せず、メッセージも記述されていない場合は、 同じログでその他のエラーを検査します。 すべてのエラーを訂正し、再試行します。

    SystemOut.log および SystemErr.log ファイルは、 以下のプラットフォーム固有のディレクトリーにあります。
    • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: profile_root/profiles/logs/server_name
    • Icon indicating Windows platforms Windows プラットフォームの場合: profile_root¥profiles¥logs¥server_name
  10. ファースト・ステップ・コンソールまたはコマンド行 方式を使用して、プロセス・サーバー server_name が稼働中の場合は停止し、デプロイメント・マネージャーが 存在する場合は始動します。
    server_name をコマンド行から停止する方法は、以下のとおりです。
    • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: profile_root/bin/stopServer.sh server_name
    • Icon indicating Windows platforms Windows プラットフォームの場合: profile_root¥bin¥stopServer.bat server_name
    セキュリティーを使用可能にする場合は、コマンドの -user および -password パラメーターを指定します。
    デプロイメント・マネージャーをコマンド行から始動する方法は、以下のとおりです。
    • Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: profile_root/bin/startManager.sh
    • Icon indicating Windows platforms Windows プラットフォームの場合: profile_root¥bin¥startManager.bat
  11. 実行中の Java プロセス、および profile_root/logs/server_name/SystemOut.log ファイル内の「Server dmgr open for e-business」というメッセージを調べて、サーバーが適切に始動およびロードされていることを確認します。
    Icon indicating Linux platforms Icon indicating UNIX platforms Linux および UNIX プラットフォームの場合: コマンド・ウィンドウを 開き、top コマンドを実行して、実行中のプロセスの表示を確認します。top コマンドがシステム上で使用不可の場合は、ps コマンドを使用します。
    ps -ef | grep java

    Icon indicating Windows platforms Windows プラットフォームの場合: Ctrl+Alt+Delete を押し、T を入力して、タスク・マネージャーを開きます。「プロセス」タブおよび 「Image Name」列見出しをクリックして、イメージ名でソートします。 java.exe という名前が付いたプロセスを探します。

    Java プロセスが存在せず、メッセージも記述されていない場合は、 同じログでその他のエラーを検査します。 エラーを修正し、デプロイメント・マネージャーの始動を再試行します。

既知の問題およびその解決法に関して IBM サポートから入手可能な現行情報については、IBM WebSphere Process Server サポート・ページを参照してください。

IBM サポートが提供する資料を参照すれば、 問題を解決するために必要な情報を集める時間を短縮することができます。 PMR を開く前に、IBM WebSphere Process Server サポート・ページを参照してください。


Terms of use |

Last updated: Fri Mar 24 07:19:12 2006

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)