OPMNのトラブルシューティングこの付録では、OPMNのトラブルシューティングのヒントを説明します。次のトピックで構成されています。問題点とソリューションこの項では、OPMNの使用に際して発生する共通の問題をいくつか説明します。次のトピックで構成されています。システム・プロセスが起動しない問題点OPMNを使用してシステム・プロセスを起動することができません。ソリューションOPMNを使用してシステム・プロセスを起動できない場合は、次のことを実行してみてください。コマンド入力を検証し、必要に応じて修正します。入力しているコマンドのスペルと選択したオプションについて確認してください。Middlewareのコマンドライン・スクリプトまたはユーティリティを使用しないでください。現在ではほとんどの管理対象プロセスには独自のログ・ディレクトリがあり、そのディレクトリがプロセス・ログ・ファイルの場所である場合は、OPMNはそのディレクトリを使用します。ORACLE_INSTANCE/diagnostic/logs/<type>/<ias-component>/管理対象プロセスのデフォルトのディレクトリが存在しない場合は、OPMNは次の独自のログ・ディレクトリにコンソール・ログを格納します。Serverの標準出力ログは、ORACLE_INSTANCE/diagnostics/logs/OHS/ohs1/console~OHS~1.logのようになります。起動しようとしているシステム・プロセスの依存性要件を検証します。opmn.xmlファイル内のシステム・コンポーネントの要素値を検証します。validateコマンドを使用して、opmn.xmlファイルの構成を検証してください。起動しようとしているシステム・コンポーネントのopmn.xmlが正しく構成されていない場合もあります。システム・プロセスに障害が発生または応答なしの状態になっているかどうかを判断する問題点システム・プロセスが障害でダウンしているか、接続不能になっています。ソリューションシステム・プロセスが障害でダウンしているか、接続不能になっている場合は、次のことを実行してみてください。ORACLE_INSTANCE/diagnostics/logs/OPMN/opmnにあるシステム・コンポーネント固有の出力を確認します。ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.logを参照してシステム・プロセスを探します。unreachableメッセージを探します。OPMNは、障害が発生または応答なしの状態になっているシステム・プロセスを自動的に再起動します。関連項目:OPMNログ・ファイルの詳細は、第B.2.1項を参照してください。停止前またはクラッシュ後のイベントのイベント・スクリプトを作成します。イベント・スクリプトを使用すれば、特定のログ・ファイルを作成したり、障害に関する情報を電子メールで送信したりすることができます。関連項目:イベント・スクリプトを使用したトラブルシューティングの詳細は、第B.2.4項を参照してください。opmnctlコマンド実行のタイムアウト問題点opmnctlコマンドの実行にかかる時間は、システム・プロセスのタイプおよび使用可能なコンピュータ・ハードウェアによって異なります。そのため、opmnctlコマンドの実行にかかる時間は、簡単には判断できません。ソリューションopmnctlコマンドが正常に実行されていることを検証するには、次のことを実行してみてください。起動していないコンポーネントのstart要素のtimeout属性値を大きくします。opmn.xmlファイルに記述されているタイムアウトを、プロセスが起動するまでOPMNが待機できるレベルに設定します。この機能は、startprocコマンドで使用できます。このコマンドは、opmn.xml内に構成されているすべての関連プロセスを起動するものです。opmn.xmlファイル内のstart要素をチェックして、retry属性をより大きな時間増分値に変更します。ORACLE_INSTANCE/diagnostics/logs/を参照して、起動していないシステム・プロセスがないか確認します。起動していないシステム・コンポーネントのコンポーネント固有のログ・ファイルを確認します。ORACLE_INSTANCE/diagnostics/logs/OHS/ohs1/console~OHS~1.logを確認します。関連項目:opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。システム・コンポーネントがOPMNによって自動的に再起動される問題点システム・コンポーネントがOPMNによって自動的に再起動されます。ソリューションシステム・コンポーネントがOPMNによって自動的に再起動される場合は、次のことを実行してみてください。ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.logファイルに記録されているシステム・コンポーネントのメッセージを確認します。システム・コンポーネントのpingタイムアウト時間が十分な長さであることを確認します。多くのアクティビティを受け取るシステム・コンポーネントについては、タイムアウトの時間を長くする必要がある場合もあります。システム・コンポーネントのopmn.xmlファイルで、pingタイムアウト要素値を大きくします。startコマンドを使用してOPMNを起動すると予想外の動作が発生します。OPMNだけが起動されたり、OPMNがシステム・プロセスを起動しようとしたりします。通常、この予想外の動作は、まずOPMNを停止しないでコンピュータの電源を切ったり再起動したりすることに起因します。コンピュータを再起動すると、すべてのシステム・コンポーネント・プロセスが起動されます。ソリューションOPMNを停止してから、コンピュータをシャットダウンすることをお薦めします。stopallコマンドを使用します。パネルを使用して、OPMNとシステム・コンポーネントを停止できます。注意:OPMNは、管理されるプロセスの予想ステータスをディスクに記録します。OPMNの稼働中にコンピュータが停止した場合、再起動時にOPMNは、ディスクにキャッシュされていた情報を使用して、システムの停止時に実行されていたプロセスをすべて自動的に再起動しようとします。そのため、OPMNのみを起動するつもりで、OPMNが管理するプロセスを起動する明示的なリクエストを発行していなくても、それらのプロセスも起動されてしまっている場合があります。この自動プロセス・リカバリを無効にするには、opmn.xmlファイルでprocess-manager要素の次の属性を設定します。問題点システム・プロセスを起動することができません。ソリューションシステム・プロセスを起動できない場合は、システムのopmn.xmlファイル内の要素がdisabledになっているかどうかを確認してください。opmn.xmlファイルの要素がdisabledである場合、OPMNは、"Missing"または"Disabled"という出力メッセージを生成します。Middlewareをインストールしており、それらを同時に起動しようとすると(たとえばファームを起動するために)、OPMNが応答しなくなる場合があります。この場合、次のようなエラー・メッセージが表示されます。limit"この問題は、同一ホスト上の2つのOracleインスタンスが同じポートを使用する場合に発生することがあります。一方のOracleインスタンス内のOHSコンポーネントが、他方のOracleインスタンス内のOHSコンポーネントと同じポートを使用しようとするためです。同一ホスト上の2つのOPMNプロセスが同時に起動された場合、これらのプロセスの間でポートの使用に関する調整は行われません。Middleware内のすべてのOHSインスタンスに対するポートの割当てはOPMNによって制御されるため、単一のopmn.xmlファイル内で重複するポート範囲が存在する可能性があります。1つのホスト上で2つのOPMNプロセスが同時に起動された場合、そのプロセス間でポートの使用に関する調整は行われません。ソリューション各Oracleインスタンス内のOHSに割り当てられるポートが重複しておらず、コンピュータ上の他のどのプロセスによっても使用されていないことを確認してください。Oracleインスタンス起動の最大再試行回数を増やすこともお薦めします。2つのOracleホームで同一のポート範囲を割り当てている場合に、OPMNによるプロセス再起動の試行回数を大きくすることで、OPMNでは最終的に空きポートが選択されます。opmn.xmlファイルで指定したポート接続試行回数ではOPMNが空きポートを見つけられない可能性もあるため、この方法で問題が完全に解決されるわけではありません。stopallコマンドを使用してシステム・コンポーネントを停止できない場合は、そのコンポーネントまたはプロセスは、OPMNを使用して起動されていない可能性が高いと考えられます。そのコンポーネントまたはプロセスは、起動スクリプトまたはユーティリティを使用して起動された可能性があります。ソリューションどのような場合でも、システム・コンポーネントを手動で起動したり停止したりしないでください。Middlewareのコマンドライン・スクリプトまたはユーティリティを使用しないでください。Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。関連項目:OPMNコマンドラインの例は、第5章を参照してください。問題点opmnctlコマンドを実行すると、globalInitNLSエラーが発生する場合があります。次のエラー・メッセージが表示されます。201."ソリューションこのエラーは、ORA_NLS33環境変数が設定されている場合に発生します。この環境変数は、設定しないでください。一部のコンピュータでは、OPMNの起動時にCPU使用率が大幅に上昇します。コンピュータのCPU使用率は約50〜60%に変化することがあります。対象となるコンピュータでは、OPMNが停止されるまでCPU使用率は上昇し続けます。ソリューションCPU使用率が大幅に上昇する原因の1つとしては、インストール環境で日本語などのマルチバイト・テキスト文字セットが使用されていることが考えられます。startallコマンドを使用してOPMNを起動しようとすると、次のエラー・メッセージが表示されます。1220396これらのエラー・メッセージは、ORACLE_INSTANCE/config/OPMN/opmn/opmn.xml内に修正が必要な構文エラーがあると生成されます。ソリューションこれらのエラー・メッセージが表示された場合は、次の操作を行います。次のコマンドを実行します(opmn.xmlファイルへの完全なディレクトリ・パスを使用する)。opmn.xmlopmn.xmlファイルから、空のタグをすべて削除します。Middlewareをインストールすると、ロギングが継続的に実行されるために、ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.logファイルのサイズが増加して4100000KBを超えます。このファイルには、次のエラー・メッセージが記録されます。ソリューションopmn.xmlファイルのリクエスト・ポートを6100よりも大きな値に変更してください。Middlewareとの競合です。Middlewareの既存のインストールまたは以前のインストールのoraInventoryディレクトリ内のエントリに起因します。不適切な状態にあるOracleインスタンスまたはコンポーネントのクリーンアップ問題点Oracleインスタンスまたはコンポーネントによって、opmnctlコマンドの間違ったデフォルト値がいくつか割り当てられています。trueオプションで実行して、Oracleインスタンスまたはコンポーネントをクリーンアップしてください。true-forceオプションは注意して使用してください。deleteinstanceコマンドでこのオプションを使用すると、Oracleインスタンスまたはコンポーネントの整合性を保護するためのいくつかの安全上の仕組みが無効化されます。このオプションを不適切に使用すると、問題が発生することがあります。deleteinstanceコマンドで明示的に指定すると、望ましい結果が得られる可能性があります。クリーンアップの実行時、forceオプションを使用したコマンドにより、Oracleインスタンスまたはコンポーネントの破損状態に応じた警告や例外が表示されます。これらの警告は、検出された不一致に対する視覚的なフィードバックとして表示されるものであり、さらに修正処置が必要であることを必ずしも示しているわけではありません。問題点opmnctlに指定されたパス引数に引用符(")が含まれていると、最初の引用符の後に続くすべての部分(opmn用のその他のフラグも含む)がORACLE_INSTANCEの名前になります。この問題は、Windowsオペレーティング・システムの場合にのみ発生します。-adminRegistrationOFFこの例では、ORACLE_INSTANCEの名前は次のようになります。OFFソリューション引数またはコマンド全体を引用符で囲んでください。OFF修正された例では、ORACLE_INSTANCEの名前は次のようになります。OPMNの問題の診断OPMNの使用に際して発生する可能性のある問題のトラブルシューティングには、いくつかの方法があります。OPMNログ・ファイルOPMNログ・ファイルにより、OPMNおよびシステム・コンポーネント・プロセスの実行と使用に際して発生する可能性のある問題のトラブルシューティングを行うことができます。OPMNおよびシステム・コンポーネント・プロセスは、処理時にログ・ファイルを生成します。生成される次のログ・ファイルを確認して、OPMNコマンドの実行に成功したか、または失敗したかを検証できます。OPMNの標準出力(stdout)および標準エラー(stderr)のログが記録されています。OPMNのコンソール・ログとも呼ばれます。OPMNの特定の初期化ポイント以降は、このファイルには他に何も書き込まれません。少数のメッセージ群のみがこのファイルに書き込まれます。したがって、ログ・ファイルのディレクトリに対して検索を実行した場合、このファイルが存在しないこともあります。コマンドの実行と動作の進行状況を追跡します。OPMNサーバーの動作を監視するうえで有益なメッセージが収められています。opmn.logファイルに書き込まれた出力には、OPMNの子プロセスの終了ステータスが含まれます。ステータス・コードが4の場合は、OPMNが正常に再ロードされたことを示します。他のステータス・コードはすべて、OPMNの子プロセスが異常終了したことを示します。opmn.logファイルは、opmn.xmlファイルに記述されている<log>属性を使用して構成されます。opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。ONSとPMに対するOPMNデバッグ・ログ・メッセージ(英語表記のみ)が収められています。debug.logファイルに記録されているエラー・コードおよびメッセージを確認してください。OPMNのPM部分は、エラー・メッセージを生成して、このファイル内に出力します。debug.logファイルは、コマンドの実行と動作の進行状況の追跡に使用されます。debug.logに記録されるログ情報の詳細レベルは、opmn.xmlファイル内の<debug>要素の構成によって変更できます。デバッグ・レベルの例は、第6章を参照してください。debug.logファイルを使用して、OPMNのONS部分を修正するか、またはOPMNの初期エラーを調べます。OPMNのONS部分は、PMの前に初期化されます。したがって、OPMNの初期化の早期段階で生じるエラーは、debug.logファイルに記録されます。debug.logファイルの使用は、Oracleサポート・サービスに問い合せた後にのみ有効化してください。Oracleサポート・サービスでは、debug.logファイルを使用して、OPMNの問題のデバッグおよび診断を実行します。debug.logファイル内のメッセージは通常、ユーザーに簡単に理解できるものではありません。opmn.logとdebug.logのファイル・ローテーションOPMNを使用すると、ファイル・サイズ、特定の時刻、またはその両方のパラメータに基づいて、opmn.logおよびdebug.logファイルのローテーションを行うことができます。ローテーションを使用できるようにするには、<log>および<debug>タグのrotation-sizeおよびrotation-hour属性をopmn.xmlファイル内に構成します。ログ・ファイルが指定されたサイズに達するか、指定された時刻になったとき、またはその両方のパラメータを組み合せた条件が満たされたときに、OPMNのロギング・メカニズムにより、ファイルが閉じられ、ファイル名が一意のタイムスタンプを接尾辞とする名前に変更され、新しいopmn.logまたはdebug.logファイルが作成されます。OPMNコンソールのログ・ファイル(opmn.out)については、ローテーションは行われません。このファイルのサイズは、通常、非常に小さいからです。OPMNが初期化ポイントを超えた後は、出力はコンソールの出力ファイルに書き込まれなくなるため、このファイルに記録されるメッセージ群は少なくなります。プロセス・コンソールのログ・ファイル・ローテーションプロセスが起動すると、コンソールの既存のログ・ファイルが管理対象プロセスに渡される前に、OPMNが、構成された制限(<log>タグのrotation-size属性)と突き合せてサイズをチェックします。ファイル・サイズがこの制限を超えると、OPMNによって既存ファイルの名前がタイムスタンプ付きの名前に変更されてから、その管理対象プロセスの新しいファイルが作成されます。rotation-size属性が構成されていない場合、OPMNは、プロセス・コンソールのログ・ファイルのローテーションを行うことができません。debugコマンドを使用します。このコマンドは、最寄りのOracleサポート・サービスに問い合せる際に使用できる、OPMNの問題の診断に役立つ出力を生成します。debugコマンドの構文は、次のとおりです。debugコマンドの実行後に生成されます。生成された出力を問題の診断に役立てる際に、Oracleサポート・サービスに問い合せることをお薦めします。このコマンドの属性(<attr>)名は、comp、intervalまたはcountのいずれかです。compの値は、onsまたはpmのいずれかで、それぞれONSとPMを表します。compが指定されていない場合、onsとpmの両方のデバッグ情報がレポートされます。次のコマンドでは、ONSのデバッグ情報が出力されます。comp=onsOPMNに送信されるリクエストの間隔(秒単位)と数を指定して、デバッグ・プロセスを支援できます。<interval>および<count>の値は、常に両方とも指定する必要があります。それらの値は0よりも大きな整数にしてください。次のコマンドでは、5秒間隔で3回デバッグ情報が出力されます。debugコマンドを使用してOPMNの問題の診断に役立てください。Controlコンソールのグラフィカル・インタフェースを使用して、ネットワークや企業内のシステム・コンポーネントを診断できます。Controlコンソールでは、ログ・ページが用意されています。ログ・ページでは、1つの場所にすべてのシステム・ログ・ファイルを表示し、複数のログ・ファイルにわたって問題をトレースすることが可能です。Controlコンソールは、OPMNと通信するAPIを使用します。イベント・スクリプトを使用したトラブルシューティングシステム・プロセスのイベント・アクティビティを記録する、ユーザー独自のイベント・スクリプトを作成できます。システム・プロセスの起動または停止の前のイベントや、予定外のシステム・クラッシュを記録するスクリプトを作成できます。第6章のevent-scripts要素の説明を参照してください。例B-1は、起動前のイベント・スクリプトを示しています。Windowsオペレーティング・システムでは機能しません。同様の機能を持つ.bat拡張子付きのスクリプトを作成できます。必要な構成情報をopmn.xmlファイルに追加するときには、.batファイルへのフルパスを使用します。opmn.xmlの環境変数OPMNサーバーの起動に使用される環境変数は、OPMNサーバーによって起動されるシステム・プロセスによって継承されません。OPMNは、ias-instanceレベルにこの環境変数を設定しますが、その際に、値はias-instance構成またはOPMNランタイム環境から抽出されます。関連項目:opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。MetaLink(http://metalink.oracle.com)にあります。問題点に対するソリューションが見つからない場合は、サービス・リクエストをログに記録してください。reserved.法律上の注意点ライブラリ。