プロファイルの作成または拡張の失敗からのリカバリー

プロファイル・ウィザードでは、プロファイルの新規作成時、または既存プロファイルの拡張時に障害が発生する場合があります。同じことは、manageprofiles コマンドを使用するときにも発生します。このような障害が発生した場合は、このトピックで説明するように、最初にログ・ファイルを調べてから、その状況に応じて、以下のリカバリー手順に従ってください。

ログ・ファイル

示されている順序で、次のログ・ファイルを参照します。それぞれのログ・ファイルには、「INSTCONFSUCCESS」という項目が含まれている必要があります。ファイルにこの項目が記述されていない場合は、障害が検出されています。ログ・ファイルを開き、障害が発生した原因を判別して、修復方法を決定してください。
  1. プロファイル・ウィザードによって作成されたログ・ファイル。
    注: manageprofiles コマンドを使用していて障害が発生した場合は、このファイルを調べる必要はありません。
    ファイルの名前は、部分的にタイム・スタンプを基にして作成され、形式は pcatLogNNNNNNNNNNNNN.txt のようになります。NNNNNNNNNNNNN は番号です。このファイルは、Linux および UNIX システムではディレクトリー profile_root/logs で、Microsoft Windows システムでは profile_root¥logs で検出できます (profile_root はプロファイルのインストール・ロケーション)。障害の原因を判別できない場合は、以下のオプションで説明されるログ・ファイルを調べてください。
    注: 1 つのプロファイルに対してプロファイル・ウィザードを複数回実行した場合、これらのファイルが複数個存在することがあります。常時、最新のファイルを参照してください。
  2. ログ・ファイル wasprofile_create_profile_name.log (profile_name はプロファイルの名前)。
    注: 新規プロファイルを作成し、既存のプロファイルを拡張しなかった場合にのみ、このファイルを調べます。

    このログ・ファイルは、Linux および UNIX システムでは install_root/logs/wasprofile ディレクトリー、Windows システムでは install_root¥logs¥wasprofile (install_rootWebSphere Process Server のインストール・ルート・ロケーション) 内にあります。「Result of executing」というテキストを検索して、見つかった各テキストが「true」で終了していることを確認します。それぞれの true または false の値は、プロファイル・テンプレート構成アクションの .ant スクリプトを実行した結果、生成されます。以下に例を示します。

    <message>Result of executing
    E:¥o0536.15¥profileTemplates¥default¥actions¥first was: true</messages>

    このファイルでは 、「false」の値で障害の原因を示すことができます。

    注: 複数の「false」が存在することがあります。それぞれの障害を調査し修正します。また、プロファイルが作成された場合は、以下のオプションで説明されるログ・ファイルも調べてください。
  3. ログ・ファイル wasprofile_augment_profile_name.log (profile_name はプロファイルの名前)。

    このログ・ファイルは、Linux および UNIX システムでは install_root/logs/wasprofile ディレクトリー、Windows システムでは install_root¥logs¥wasprofile (install_rootWebSphere Process Server のインストール・ルート・ロケーション) 内にあります。「Result of executing」というテキストを検索して、見つかった各テキストが「true」で終了していることを確認します。それぞれの true または false の値は、プロファイル・テンプレート構成アクションの .ant スクリプトを実行した結果、生成されます。 以下に例を示します。

    <messages>Result of executing
    E:¥o0536.15¥profileTemplates¥default.wbicore¥actions¥saveParamsWbiCore.ant
    was:true</messages>

    このファイルでは 、「false」の値で障害の原因を示すことができます。また、以下のオプションで説明されるログ・ファイルも調べてください。

    注: 複数の「false」が存在することがあります。それぞれの障害を調査し修正します。
  4. 個別のプロファイル・テンプレート処置ログ・ファイル。

    上記のオプションで説明したログ・ファイルで false の値が見つかった場合は、Linux および UNIX システムでは profile_root/logs ディレクトリー、Windows システムでは profile_root¥logs ディレクトリー (profile_root はプロファイルのインストール・ロケーション) にあるログ・ファイルを確認してください。これらのログ・ファイルは一貫性のある命名規則に従っていませんが、通常は失敗した .ant スクリプト名の後に .log が続く名前になっています。例えば、wasprofile_augment_profile_name.log ファイルに次のエントリーがあるものとします。

    <messages>Result of executing
    E:¥o0536.15¥profileTemplates¥default.wbicore¥actions¥saveParamsWbiCore.ant
    was:false</messages>

    最初に、wasprofile_augment_profile_name.log ファイル内で周囲のエントリーを調べます。 周囲のエントリーから障害の原因を判別できない場合は、障害が発生している .ant スクリプトのエントリーに対応するログ・ファイルを探してください。この例では、saveParamsWbiCore.ant スクリプトによって作成されたログ・ファイルは saveParamsWbiCore.ant.log です。ファイルを開き、障害が発生した原因を調査します。

作成に失敗した場合のリカバリー

プロファイルの作成で障害が発生した理由を判別し、その障害の原因を突き止めたら、もう一度プロファイルの作成を試みることができます。
注: プロファイルを作成すると、最初に WebSphere Application Server プロファイルが作成され、次に WebSphere Process Server プロファイル・テンプレートによって拡張されて WebSphere Process Server プロファイルが作成されます。 プロファイルの作成で障害が発生しても、(おそらく障害のために) 必要とされる拡張の一部を含んでいないプロファイルとして存続可能です。

プロファイルが存在しているかどうかを判別するには、Linux および UNIX システムでは install root/bin/wasprofile.sh -listProfiles コマンド、Windows システムでは install_root¥bin¥wasprofile.bat -listProfiles コマンド (install_rootWebSphere Process Server のインストール・ルート・ロケーション) を実行してください。作成に使用したプロファイル名が存在していない場合は、そのプロファイルを再作成できます。作成に使用したプロファイル名が存在している場合は、プロファイルが作成されており、拡張で障害が発生したことになります。 拡張時の障害からのリカバリーのヒントについては、拡張に失敗した場合のリカバリーを参照してください。

manageprofiles コマンドを使用してプロファイルが作成されているが、拡張に失敗した場合は、プロファイル・ウィザードを使用して残りの拡張を完了することをお勧めします。

拡張に失敗した場合のリカバリー

プロファイルの拡張で障害が発生した理由を判別し、その障害の原因に対処した後、以下の手順を実行すると、既存のプロファイルを再度拡張して、完全な WebSphere Process Server プロファイルを正常に作成することができます。

  1. プロファイル・ウィザードを開始して、新規プロファイルの作成ではなく、既存のプロファイルの拡張を選択します。
  2. 作業していたプロファイルを選択し、そのプロファイルの正しい情報を入力します。
注: プロファイル・ウィザードを初めて実行したときに、一部の拡張は正常に完了している場合があります。このため、最初にプロファイルを作成しようとしたときには表示されたパネルすべてが表示されない場合があります。 これは、プロファイル・ウィザードが完了すべき残りの拡張を検出して、必要なパネルだけを表示するためです。
重要: 再試行する前にプロファイルを手動で削除する場合は、削除する前にそのプロファイルからすべての拡張を除去する必要があります。そうしない場合、問題が発生する可能性があります。 これには、WebSphere Process Server プロファイル・ウィザードによって作成され、WebSphere Process Server プロファイルに拡張されたオリジナルの WebSphere Application Server や WebSphere Application Server Network Deployment のプロファイルへの拡張、および、その他のプロファイル・テンプレートによって作成された拡張の両方が含まれます。詳しくは、拡張の削除を参照してください。

拡張の削除

本来 WebSphere Process Server プロファイル・ウィザードによって作成された WebSphere Process Server プロファイルから拡張を除去するには、以下の手順を実行します。
  1. そのプロファイル用に実行されているサーバーがないことを確認します。
  2. ファイル install_root/properties/profileRegistry.xml (Linux および UNIX プラットフォームの場合) または install_root¥properties¥profileRegistry.xml (Windows プラットフォームの場合) からそのプロファイル用のエントリーを検索し、WebSphere Process Server 拡張がいくつあるか判別します。
  3. wasprofile -unaugment コマンドを使用して、そのプロファイルの各 WebSphere Process Server 拡張を除去します。
  4. 各呼び出しは、そのプロファイルに拡張された最後のテンプレートを除去します。 実行した拡張解除コマンドが、それぞれ正常に完了したことを確認します。
  5. wasprofile -delete コマンドを使用してプロファイルを削除します。
注: wasprofile コマンドを使用する以外の方法では、profileRegistry.xml の内容の変更は行わないでください。
プロファイル・テンプレートが WebSphere Process Server 以外の製品に行った拡張を除去するには、該当する製品の資料を参照して、テンプレートを適切に拡張解除してください。

手動による拡張の削除については、IBM 技術情報 1218704「Remove augmentations before manually deleting a profile using command line utility wasprofile」を参照してください。


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