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

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

このタスクを実行する理由と実行時期

インストールが正常終了しなかったとき、このトピックを使用して考えられる問題を診断します。 インストーラー・プログラムは、1 次ログ・ファイルの末尾に以下のような成功を示す標識を記録します。これは、Linux および UNIX プラットフォームでは install_root/logs/wbi/log.txt 内、Windows プラットフォームでは install_root¥logs¥wbi¥log.txt 内にあります。 結果が INSTCONFPARTIALSUCCESS またはINSTCONFFAILED の場合は、以下のステップを実行して問題の分析を続行します。

このタスクのためのステップ

  1. インストール・プロセスでエラー・メッセージが表示される可能性があります。

    説明については、『エラー・メッセージ: インストールおよびプロファイルの作成と拡張』を参照してください。メッセージが、記載されているものと対応する場合は、問題を訂正し、インストールされた部分をクリーンアップして、再インストールを試みます。

    再インストールの前にインストールされた部分をアンインストールする方法の詳細については、『アンインストールに失敗した後の再インストールの準備』を参照してください。

  2. WebSphere Application Server Network Deployment のインストールが正常に完了したかどうかを判別します。 (インストールが失敗していて、WebSphere Application Server Network Deployment が WebSphere Process Server インストールの一部としてインストールされていた場合、 インストール・プロセスは続行されずにエラー・メッセージが表示されます。) WebSphere Process Server のインストールが正常に完了しなかった場合は、最初に install_root/logs/log.txt (Linux および UNIX プラットフォームの場合) または install_root¥logs¥log.txt (Windows プラットフォームの場合) でエラーがないかどうかを調べ、WebSphere Application Server Network Deployment のインストールが正常に完了したかどうかを判別します。

    WebSphere Application Server Network Deployment のインストールに失敗した場合は、WebSphere Application Server Network Deployment バージョン 6.0 のインフォメーション・センターにあるトピック『インストールのトラブルシューティング』を参照し、そこにある情報を使用して問題を修正してから 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 or 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

    応答ファイルについて詳しくは、WebSphere Process Server または Client をサイレント・モードでインストールするを参照してください。

    応答ファイルを使用するには、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 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. 失敗した構成スクリプトがインストールの問題の原因となっているかどうかを判別します。

    install_root/logs/wbi/instconfig.log ファイル (Linux および UNIX プラットフォームの場合) または install_root¥logs¥wbi¥instconfig.log ファイル (Windows プラットフォームの場合) では、製品の正しい動作を妨げている可能性のある構成の問題を示しています。ストリング 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 プロセスが存在せず、メッセージも記述されていない場合は、 同じログでその他のエラーを検査します。 エラーを修正し、デプロイメント・マネージャーの始動を再試行します。

次の作業

既知の問題とその解決方法についての現行情報、および問題の解決に必要な情報収集の時間節約に役立つ資料があります。 PMR を開く前に、IBM WebSphere Process Server サポート・ページを参照してください。


(c) Copyright IBM Corporation 2005, 2006.
このインフォメーション・センターには Eclipse テクノロジー (http://www.eclipse.org) が採用されています。