Middlewareコンポーネントに対して使用できるopmnctlコマンドの概要について説明します。次のトピックで構成されています。Controlコンソールを除く、Oracleインスタンスのすべてのコンポーネントの起動および停止をサポートするツールです。opmnctlでは、コマンドラインからシステム・コンポーネントを集中的に制御および監視できます。OPMNが他のOracleインスタンスを検出するように構成されている場合、opmnctlを使用して、複数のOracleインスタンスに対する制御コマンドや監視コマンドを同時に実行できます。opmnctlスクリプトの場所に応じて、使用できるopmnctlコマンドが決定されます。opmnctlコマンドは、次の2つのディレクトリに保存されています。opmnctlコマンドORACLE_HOME/opmn/bin/opmnctlの場所は、Oracleインスタンスやローカル・システム上のOracleインスタンスのコンポーネントを作成する場合にのみ使用されます。この場所で生成されたopmnctlコマンドを使用して、システム・プロセスを管理することはできません。別のopmnctlコマンドは、ORACLE_INSTANCE/bin/ディレクトリにあり、Oracleインスタンスごとにopmnctlをインスタンス化します。このOracleインスタンスのプロセスを管理するには、この場所にあるopmnctlコマンドを使用する必要があります。このコマンドは、Oracleインスタンスのコンポーネントを作成する際にも使用できます。Middlewareコンポーネントは、手動で起動および停止しないでください。Middlewareのコマンドライン・スクリプトやユーティリティを使用しないでください。Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。Middlewareをインストールしたユーザーとして実行することをお薦めします。次のコマンドは、opmnctlコマンドの構文例です。[<options>]表4-1にopmnctlの構文の説明を示します。説明verbose可能な場合、詳細な実行メッセージを出力します。commandopmnctlコマンドを指定します。コマンドの一覧は、例4-1を参照してください。optionsコマンドのオプションを指定します。コマンドのオプションの一覧は、第4.3.5.1.1項を参照してください。opmnctlコマンドのクイック・リファレンス例4-1にopmnctlコマンドのクイック・リファレンスを示します。helpコマンドを実行すると、同じ情報が出力されます。次の項では、例4-1の一覧に示したopmnctlコマンドについて詳しく説明します。opmnctlの各コマンドについては、次の項を参照してください。コマンド定義opmnctlには、OPMNで実行する操作をより詳細に定義できるコマンド定義があります。この項では、opmnctlコマンドで使用できるコマンド定義について説明します。次の項で構成されています。scopescopeオプションは、opmnctlコマンドを適用するOracleインスタンスを指定します。Middlewareの旧バージョンとは異なり、このリリースでは、forceオプションは使用されず、下位互換性が保持されます。<attribute>=<value>opmnctlの属性を使用すると、特定のシステム・コンポーネントのプロセスを制御できます。Cacheに構成されたすべてのシステム・プロセスが起動します。ias-component=webcache1その他のopmnctlコマンドの例は、第5章を参照してください。表4-2に、opmnctlコマンドで使用できる属性名と値の一覧を示します。属性値ias-instanceopmn.xmlファイル内の<ias-instance>要素に指定したid属性と同じ値を指定します。ias-componentopmn.xmlファイル内の<ias-component>要素に指定したid属性と同じ値を指定します。process-typeopmn.xmlファイル内の<process-type>要素に指定したid属性と同じ値を指定します。process-setopmn.xmlファイル内の<process-set>要素に指定したid属性と同じ値を指定します。modesyncまたはasyncのいずれかの値を指定します。デフォルト値はsyncです。この場合、このリクエストは同期的に動作し、操作が完了するまで待機してから制御を戻します。"asyncを指定した場合、制御はすぐに戻りますが、OPMNは操作が完了するまでリクエストを実行します。timeoutmodeにsyncを指定した場合のみ、この属性を指定できます。値は秒単位で指定します。指定したタイムアウトが経過すると、OPMNはstartproc操作のリクエストを中断します。restartprocおよびstopproc操作のリクエストは引き続き実行されます。timeout属性は、各ias-instance、ias-component、process-typeおよびprocess-set値に構成されたタイムアウト値よりも優先されます。uniqueidこれは、OPMNによって起動後に割り当てられる値です。stopprocコマンドを実行する場合に、この値を使用できます。sequentialsequential属性の値がtrueの場合、リクエストのターゲットである各プロセスまたはアプリケーションは順番に(一度に1つずつ)実行されます。関係する管理対象プロセスの依存性のリクエスト順序も反映されます。reportreport属性の値がtrueの場合、OPMNは、リクエストの各部分が完了したときに(たとえば、プロセスが起動されるたびに)、その結果をレポートします。OPMNのデフォルトの動作では、リクエスト全体が完了するまで待機してから、すべての結果が一度に送信されます。ias-instance、ias-component、process-typeおよびprocess-setのターゲット属性は、階層的に指定できます。特定のias-instance、そのias-instance内の1つのias-component、ias-component内の1つのprocess-type、process-type内の1つのprocess-setのように指定できます。これらの属性は省略できます。省略した場合は、ワイルド・カードとして処理されます(たとえば、process-setを省略すると、指定したprocess-typeの下のすべてのprocess-setにリクエストが適用される)。ターゲット属性は、1つの階層型のリスト(たとえば、ias-componentsのリスト)で指定することもできます。Directoryの依存性の障害により、そのリクエストはタイムアウトになります。関連項目:OPMNコマンドラインの例は、第5章を参照してください。verboseオプションを指定すると、実行中のコマンドに関する詳細情報を取得できます。次のコマンドは例4-2のような情報を出力します。start、startall、reload、stopallおよびshutdownコマンドを実行すると、OPMNサーバーを制御できます。reloadopmnctlのサーバー制御コマンドが正常に実行された場合、出力は生成されません。opmnctlコマンドの実行時にエラー・メッセージが出力された場合は、付録Bを参照してください。Windowsオペレーティング・システムでは、OPMNがWindowsサービス(Oracle<OracleHomename>ProcessManager)としてインストールされており、コンピュータを再起動すると自動的に起動します。Windowsサービスを使用したOPMNの起動や停止では、ローカルのOracleインスタンス上のすべてのシステム・コンポーネントが起動または停止されます。Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。startシステム・プロセスを開始せずにローカルのOracleインスタンス用のOPMNサーバーを起動する場合は、このコマンドを実行します。Windowsでは、コンピュータを起動または再起動すると、OPMNが自動的に起動します。すべてのシステム・コンポーネント・プロセスも開始されます。関連項目:OPMNコマンドラインの例は、第5章を参照してください。[timeout=<seconds>]ローカルのOracleインスタンス用のOPMNおよびシステム・プロセスを起動する場合は、このコマンドを実行します。startallは、引数を指定しないstartコマンドおよびstartprocコマンドと同じです。startコマンドまたはstartprocコマンドの使用をお薦めします。このコマンドは同期的に動作し、操作が完了するまで待機してから制御を戻します。リクエストのタイムアウトを設定する場合は、タイムアウト値を秒単位で指定します。id-matching="true"が構成されているコンポーネントは起動されません。詳細な情報を取得するには、次のコマンドを入力します。パネルでOracle<OracleHomename>ProcessManagerサービスを開始することもできます。Oracle<OracleHomename>ProcessManagerは、コンピュータを起動または再起動すると自動的に開始します。stopallコマンドを実行します。このリクエストは同期的に動作し、操作が完了するまで待機してから制御を戻します。通常の動作では、OPMNサーバーをシャットダウンする必要はありません。OPMNサーバーをシャットダウンすると、再起動するまでOPMNに対するリモート・コマンドをOracleインスタンスで実行できません。stopallコマンドは、OPMNとコンピュータをシャットダウンする前にのみ実行してください。このリクエストは最初に、すべてのシステム・コンポーネントを正常に停止しようとします。正常に停止しないプロセスは、強制的に停止されます。すべての管理対象プロセスの停止後に、OPMNデーモン自体が停止されます。stopallコマンドは、緊急時にOPMNデーモンの速やかな停止が必要な場合にのみ使用してください。OPMNデーモンは、いったん起動したら、コンピュータの再起動が必要になったり、他の予期しない管理イベントが発生したりするまで、稼働状態にしておいてください。stopprocコマンドを実行します。reloadコマンドを実行します。reloadコマンドの使用は、新しい構成でOPMNデーモンを再起動することのみが目的の場合に適しています。stopprocコマンドを実行してください。reloadコマンドを実行してください。付加情報を取得するには、次のいずれかのコマンドを入力します。shutdownコマンドを実行します。shutdownコマンドは、ローカルのOracleインスタンスに対してOPMNデーモンとシステム・コンポーネントを迅速に停止します。stopallコマンドと似ていますが、より短い待機時間でシステム・コンポーネントの強制終了を開始します。すべてのシステム・コンポーネントの停止後に、OPMNデーモン自体が停止されます。shutdownコマンドは、OPMNデーモンの停止が必要な場合にのみ実行してください。OPMNデーモンは、いったん起動したら、コンピュータの再起動が必要になったり、他の予期しない管理イベントが発生したりするまで、稼働状態にしておいてください。stopprocコマンドを実行します。reloadコマンドを実行します。reloadコマンドの使用は、新しい構成でOPMNデーモンを再起動することが目的の場合に適しています。パネル」のWindowsサービスでOracle<OracleHomename>ProcessManagerサービスを停止することもできます。stopprocコマンドを実行してください。reloadコマンドを実行してください。付加情報を取得するには、次のいずれかのコマンドを入力します。reloadOPMNに、その構成ファイルを再度読み込ませるには、このコマンドを実行します。このコマンドは、OPMNが管理するシステム・プロセスを再起動せずにOPMNサーバーを再起動します。OracleインスタンスのOPMNサーバーが稼働している必要があります。パネル」のサービスでOracle<OracleHomename>ProcessManagerを選択して「再起動」を選択できます。reloadの実行とは異なります。startallを実行した場合と同じです。reloadを実行した場合より処理にはるかに時間がかかります。詳細な情報を取得するには、次のコマンドを入力します。reload関連項目:OPMNコマンドの定義は、第4.3.1項を参照してください。プロセス制御コマンドopmnctlのプロセス制御コマンドを実行すると、1つまたは複数のシステム・コンポーネントを起動、停止または再起動できます。システム・コンポーネントを<ias-component>、<process-set>または<process-type>レベルで制御できます。この項では、opmnctlで実行できるプロセス制御コマンドについて説明します。プロセス制御コマンドには、次のものがあります。stopproc斬新なリクエスト・レポート順次リクエストopmnctlのプロセス制御コマンドが正常に実行された場合、出力は生成されません。opmnctlコマンドの実行時にエラー・メッセージが出力された場合は、付録Bを参照してください。[<attr>=<value>...]システム・プロセスを起動、再起動または停止する場合は、これらのコマンドを実行します。OracleインスタンスのOPMNサーバーが稼働している必要があります。これらのコマンドでは属性を使用できます。startproc、stopprocおよびrestartprocの実行時に属性を指定しない場合、opmn.xmlファイルでid-matching="true"が指定されているコンポーネントを除く、すべてのシステム・プロセスが起動されます。次の属性および値は、startproc、stopprocおよびrestartprocコマンドで使用できます。これらの属性値は、opmn.xmlファイルで指定したid値と一致する必要があります。属性を指定しない場合、このコマンドはopmn.xmlファイルでid-matching="true"が構成されているプロセスを除く、すべてのシステム・コンポーネント・プロセスに適用されます。id-matching="true"が構成されているコンポーネントでこのコマンドを実行するには、ias-component引数を指定する必要があります。syncまたはasyncを指定できます。デフォルト値はsyncです。modeの値にsyncを指定すると、opmnctlコマンドは同期的に動作し、コマンドの実行が完了するまで待機してから制御を戻してプロンプトを表示します。modeの値がsyncの場合のみ、タイムアウト要素を指定できます。値は秒単位で指定します。指定したタイムアウトが経過すると、startprocの操作は中断されますが、restartprocおよびstopprocの操作は中断されません。restartprocまたはstopprocコマンドのリクエストを操作が完了するまで実行します。modeの値にasyncを指定すると、すぐにプロンプトが表示されますが、OPMNサーバーはopmnctlコマンドのリクエストを操作が完了するまで実行します。これは、OPMNによって起動後に割り当てられる値です。restartprocおよびstopprocコマンドを実行する場合に、この値を使用できます。この値を取得するには、次のコマンドを実行します。生成される出力のuid列に、システム・コンポーネントの一意の番号が表示されます。-lOPMNが管理するいくつかのタイプのシステム・プロセスでは、一覧にない属性名が指定される場合もあります。各タイプのシステム・プロセスには、一意の属性名を指定する必要があります。startproc、restartprocまたはstopprocコマンドと属性を使用すると、Oracleインスタンス内の特定のプロセスを制御できます。startproc、restartprocまたはstopprocコマンドは、<ias-component>、<process-type>および<process-set>レベルで実行できます。Cacheが再起動します。Serverが停止します。ias-component=ohs1付加情報を取得するには、次のいずれかのコマンドを入力します。stopproc関連項目:OPMNコマンドの定義は、第4.3.1項を参照してください。OPMNコマンドラインの例は、第5章を参照してください。漸進的なリクエスト・レポートstartproc、restartprocまたはstopprocでreport=true属性を使用すると、リクエストの各部分が完了するたびに、その部分についてOPMNにレポートさせることができます。startprocリクエストで4つのプロセスの開始を試みる場合、個々のプロセスの開始が完了すると、ただちにそのプロセスの開始結果がOPMNによってユーザーにレポートされます。リクエストデフォルトでは、依存性によって特定の順序が指定されている場合を除き、OPMNリクエストはすべての対象プロセスに対して同時に実行されます。startproc、restartprocまたはstopprocコマンドで属性sequential=trueを指定した場合、OPMNは一度に1つのプロセスに対してのみリクエストを実行し、最初のプロセスでリクエストが完了するまで、次のプロセスではリクエストを実行しません。1つのプロセスでリクエストが完了すると、次のプロセスに進みます。この場合も依存性は有効であり、リクエストに順番に組み込まれることに注意してください。図4-1に示すように、デフォルトでは、OPMNはすべてのプロセスに対してジョブを並列に発行し、各プロセスでジョブが同時に実行されるようにします(依存性が有効な場合を除く)。次にコマンドの例を示します。並列のプロセス」の説明sequential属性をtrueに設定した場合、OPMNは一度に1つのプロセスに対してのみリクエストを実行します(図4-2を参照)。次にコマンドの例を示します。sequential=trueこの場合、すべての管理対象のシステム・プロセスが順番に起動します。管理対象プロセスの順次リクエスト-1」の説明OPMNは1つの管理対象プロセスを処理しています。その後、図4-3に示す次のプロセスに移ります。図4-3に示すように、最初の管理対象プロセスに対してリクエストが完了すると、次の管理対象プロセスでリクエストが開始されます。図4-4に示すように、対象となるすべての管理対象プロセスでリクエストが完了しました。プロビジョニング・コマンドopmnctlプロビジョニング・コマンドは、Oracleインスタンス内のプロビジョニング・システム・コンポーネントに対して使用されます。これらのコマンドを使用して、次の操作を実行します。注意:opmnctlプロビジョニング・コマンドでは、次のネーミング規則を使用する必要があります。名前の先頭は文字でなければなりません。名前には英数字、ハイフン(-)およびアンダースコア(_)のみを使用できます。名前は30文字以内にする必要があります。名前は4文字以上にする必要があります。この項の項目は次のとおりです。一般的な構文opmnctlプロビジョニング・コマンドは、次の構文を使用して起動されます。...次のプロビジョニング・コマンドがサポートされています。プロビジョニング・コマンドの代替構文プロビジョニング・コマンドは、他のopmnctlコマンドで使用される次の構文によって起動することもできます。...この代替構文は、属性形式(第4.3.1.2項を参照)に従い、小文字で指定された引数名を受け入れます。代替構文を使用すると、opmnctlコマンド内で統一化を図ることができます。すべてのopmnctlプロビジョニング・コマンドで、入力時にどちらの構文も使用できます。次のコマンドは同等になります。componentname=ohs1同じコマンド内で両方の構文形式を組み合せることができます。一般的な引数コンポーネント関連のコマンドにのみ適用されるコンポーネント固有の引数を除いて、通常、次の引数がすべてのプロビジョニング・コマンドに適用されます。Serverドメインの管理サーバーと通信する方法を表します。管理サーバーの値は、後続のコマンドのデフォルト値としてOracleインスタンスに保存されています。opmnctlは、登録されていないOracleインスタンスに対して管理サーバーの値を使用したり要求したりしません。登録されていないインスタンスを作成するためのcreateinstanceコマンドの詳細は、第4.3.4.4.1項を参照してください。管理サーバーの引数は次のとおりです。Weblogic管理サーバー・ホスト。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンド、またはローカル・ホストです。Weblogic管理サーバー・ポート。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンド、または7001です。Weblogic管理サーバー・プロトコル。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンド、または3です。Weblogic管理サーバー・ログイン・ユーザー名。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンドです。成功したコマンドがない場合、ログイン・ユーザー名の入力を求めるプロンプトが表示されます。user)のパスワードが記載されたファイルの場所。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンドです。成功したコマンドがない場合、管理ユーザーのパスワードの入力を求めるプロンプトが表示されます。ロギングの引数デフォルトでは、opmnctlは、ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/provision.logファイル内のプロビジョニング・エラーおよび例外の詳細を記録します。createinstanceコマンドを実行する際の特定のエラーでは、特にprovision.logファイルが作成されていない場合、例外の詳細がコンソールに表示されます。ログ・ファイルの場所は、-logFile引数を使用して指定できます。プロビジョニング・ログ・ファイルの場所。プロビジョニング・ログのロギング・レベル。INFOまたはFINERのように記述します。Oracleインスタンスの引数-oracleInstance引数および-instanceName引数は主に、createinstanceコマンドで使用されます。Oracleインスタンスを作成すると、ORACLE_INSTANCE/bin/opmnctlディレクトリにデフォルトのOracleインスタンス・ホームが作成されます。Oracleインスタンスの名前は、自動的に決まります。Oracleインスタンスの引数は次のとおりです。Oracleインスタンスのルート・ディレクトリ。このディレクトリは、opmnctlコマンドがOracleインスタンス・ホームから実行されなかった場合にのみ必要です。このコマンド・オプションは、Oracleインスタンスの作成時にOracleインスタンス名を割り当てたり、Oracleインスタンス名を後から検証する際に使用されます。createinstanceコマンドは、instanceNameが直接入力されていない場合、-oracleInstanceの最後のディレクトリ名がOracleインスタンス名として使用されます。単一コンポーネントを対象にしたコマンドは、コンポーネント・タイプ固有の引数を受け入れることができます。Cacheコンポーネント作成時には受け入れられますが、OHSコンポーネント作成時には受け入れられません。これらの引数は、構文的にはオプションですが、適切な構成のためには理解する必要があります。Middleware管理者ガイド』を参照してください。usageコマンドの実行時にコンポーネント・タイプを入力すると表示されます。コマンドこの項では、一連のcreateコマンドについて説明します。次の項で構成されています。createinstancecreateinstanceコマンドは、Oracleインスタンスを作成して登録します。次の引数が使用されます。作成されたOracleインスタンスの登録ステータス。サポートされる値は、ON(登録済)およびOFF(未登録)です。デフォルト値はONです。OPMNのリモート・ホスト。デフォルト値は、コンピュータの正規ホスト名です。OPMNのローカル・ポート値。デフォルト・ポート値は6700です(ポートが使用可能な場合)。OPMNのリモート・ポート値。デフォルト・ポート値は6701です(ポートが使用可能な場合)。createcomponentcreatecomponentコマンドは、Oracleインスタンス内にコンポーネントを作成します。作成されたコンポーネントは、登録状態についてはOracleインスタンスと一致します。createcomponentコマンドは、次の引数を使用します。8888それぞれのシステム・コンポーネントで、構成に使用できる別々の引数のセットが用意されている点に注意してください。上のコマンド例では、-proxyPortの使用はOHSコンポーネント固有です。コンポーネント固有の引数の詳細は、第4.3.4.3.4項を参照してください。deleteinstancedeleteinstanceコマンドは、Oracleインスタンスを削除し、Oracleインスタンスと関連のシステム・コンポーネントの登録を解除します。Oracleインスタンスが正常に削除されると、デフォルトのprovision.logファイルを除く、すべてのOracleインスタンスのファイルが削除されます。deleteinstancedeleteinstanceコマンドは、次の引数を使用します。deleteinstanceコマンドを続行します。このコマンドは、値がtrueの場合のみ有効です。デフォルト値はfalseです。-forceオプションは、大半の検証前のチェックを回避することに注意してください。したがって、-forceオプションは注意して使用するようにお薦めします。「deleteinstanceの-forceオプション」に例を示します。trueがコマンドに含まれている場合、強制モードで動作します。このオプションを使用すると、Oracleインスタンスで検出された警告やエラーとは関係なく、opmnctlに操作を続行するように指示します。Oracleインスタンスが不適切かつ応答不能な状態である可能性があるため、Oracleインスタンスに関連付けられている適切な(-instanceName、-adminHost、-adminPortなどの)オプション値を明示的に入力し、正しい値が使用されていることを確認することをお薦めします。クリーンアップ実行時、forceオプションを使用したdeleteinstanceコマンドにより、Oracleインスタンスの破損状態に応じた警告や例外が表示されます。これらの警告や例外は、検出された不一致に対する視覚的なフィードバックとして表示されるものであり、さらに修正処置が必要であることを必ずしも示しているわけではありません。deletecomponentdeletecomponentコマンドは、システム・コンポーネントを削除します。deletecomponentコマンドは、次の引数を使用します。registerinstanceregisterinstanceコマンドは、Oracleインスタンスを登録済の状態に切替え、管理サーバーの値を更新します。registerinstanceコマンドは、次の引数を使用します。管理サーバーロギングOracleインスタンス次に例を示します。unregisterinstanceunregisterinstanceコマンドは、Oracleインスタンスを未登録状態に切替え、管理サーバーの値を更新します。unregisterinstanceunregisterinstanceコマンドは、次の引数を使用します。Oracleインスタンス内の矛盾とは関係なく、opmnctlのunregisterinstanceコマンドに続行するように指示します。このオプションは、値がtrueの場合のみ有効です。デフォルト値はfalseです。-forceオプションは、大半の検証前のチェックを回避することに注意してください。したがって、-forceオプションは注意して使用するようにお薦めします。「unregisterinstanceの-forceオプション」に例を示します。trueが含まれている場合、強制モードで動作できます。このオプションは、Oracleインスタンスを登録解除するようにopmnctlのunregisterinstanceに指示しますが、変更の範囲を管理サーバーに限定します。評価したりOracleインスタンスとやり取りしたりせず(オプションでprovision.logファイルに書き込む場合を除いて)、Oracleインスタンス名を管理サーバーから登録解除します。このモードにより、簡単に登録の関連付けを解除できます。このコマンドを登録されている運用Oracleインスタンスの名前で実行すると、管理サーバーとOracleインスタンスが同期しなくなります。その後、管理サーバーがOracleインスタンスや関連のシステム・コンポーネントを一覧表示しなくなります。この例では、Oracleインスタンスはこの時点でも登録済として構成されていますが、大半のプロビジョニング・コマンドは失敗します。したがって、-forceオプションは注意して使用するようにお薦めします。updateinstanceregistrationupdateinstanceregistrationコマンドは、管理サーバーに登録された、Oracleインスタンスの情報を更新します。updateinstanceregistrationコマンドは、登録されたOPMNリモート・ポート、OPMNリモート・ホストおよびOPMNウォレットを現在のOPMN設定から更新します。updateinstanceregistrationコマンドは、次の引数を使用します。管理サーバーロギングOracleインスタンス次に例を示します。updatecomponentregistrationupdatecomponentregistrationコマンドは、管理サーバーに登録された、サブジェクト・システム・コンポーネントの設定を更新します。Controlコンソールのコンポーネント・プロパティ、さらにコンポーネントのタイプに固有のその他の値が含まれています。updatecomponentregistrationコマンドは、次の引数を使用します。statusコマンドを実行すると、システム・コンポーネント・プロセスのステータスを確認できます。この項では、opmnctlコマンドで使用できるコマンド・オプションについて説明します。次の項で構成されています。query関連項目:属性の詳細は、第4.3.1.2項を参照してください。opmnctlのstatusコマンドのオプションの詳細は、第4.3.5.1.1章を参照してください。-portコマンドの詳細は、第4.3.5.1.2項を参照してください。[<options>]statusコマンドを使用すると、OPMNが管理するシステム・プロセスに関する情報を取得できます。出力はテキストの表で表示されます。表の各行が1つのシステム・プロセスを表します。次のようにステータス・コマンドをカスタマイズできます。各システム・プロセスについて表示される情報を変更する。出力から表のヘッダーを削除する。フィールド区切り値を変更する。レコード区切り値を変更する。各列のデータの位置揃えを変更する。statusコマンドを実行すると、ステータス・コマンドの使用方法の詳細を取得できます。statusコマンドを実行した場合の出力を示します。opmnctlのステータス・コマンドのオプション<options>パラメータには、次のオプションを指定できます。(uid)値と他の特定のプロセス・パラメータ情報を取得する場合は、このオプションを使用します。-lたとえば、このコマンドは例4-4に示す情報を出力します(読みやすくするため、一部の列は省略している)。Middlewareプロセスを停止または再起動できます。process-typeが停止します。statusの出力にフィールド区切り値を割り当てる場合は、このオプションを使用します。デフォルト値は|です。statusの出力にレコード区切り値を割り当てる場合は、このオプションを使用します。デフォルト値は\nです。statusコマンドを実行した後にヘッダーを表示しない場合は、このオプションを使用します。次の書式で指定する1つ以上の統計識別子を連結した単一の文字列です。<statname>[<width>{<justification>]。デフォルト値は%cmp18%prt18%pid5R%sta8です。表4-3に、<fmtlist>オプションで使用する書式指定文字列の構文を示します。説明<statname>次のいずれかを指定します。詳細なポートのリスト<width>フィールドのサイズを指定します。出力がこの値より短い場合は、指定した<justification>に従ってパディングが行われます。出力がこの値より長い場合は省略され、末尾に「〜」が表示されます。各データの幅<justification>フィールドの行揃えを指定します。出力がフィールド幅より短い場合に出力位置を揃えることができます。L、RまたはC(左揃え、右揃えまたは中央揃え)を指定します。Lたとえば、次のコマンドは例4-5に示す出力を表示します。-noheadersの出力webcache1@WebCache-admin@1544@Alivewebcache1@WebCache@1545@Aliveohs1@OHS@1543@Alive関連項目:コマンドの定義は、第4.3.1項を参照してください。詳細な情報を取得するには、次のコマンドを入力します。-portコマンドでは、OPMNデーモンへの接続に使用されるリクエスト接続文字列を表示できます。次のコマンドを実行します。-port次の文字列が表示されます。-portコマンドを使用すると、opmn.xmlファイルでリクエスト・アクセス・ポートを確認する必要がなくなるため便利です。metricコマンドを使用すると、システム・コンポーネント・プロセスのDMS統計を出力できます。opmnctlメトリックには、次のコマンドと引数の構造があります。dmsarg=<dmsargs>]opmnctlメトリック・コマンドは、次のコマンド引数を使用します。<op>がlistまたはqueryのいずれかになる操作を指定します。list操作では、その他の引数は使用されません。ターゲットOPMNは、DMSメトリックがメトリック・リクエストを介して使用できる管理対象のシステム・プロセスのリストを返します。query操作では、<identifier>=<value>引数によって修飾された管理対象のプロセスのメトリック・ツリーが返されます(すべての使用可能なプロセスは、識別子の引数が指定されていないことが前提となっています)。trueに設定すると、このオプションではコマンドがローカルのOracleインスタンス内で動作するように限定されます。これは、OPMNが他のOracleインスタンスを検出するように構成されている場合に有用です。どの管理対象のプロセスがDMSメトリックを問い合せるかを指定します。複数の識別子を指定でき、各識別子は、アドレス・プロパティ(リストを含む)を持つ管理対象のプロセスと一致させます。5つの標準的なプロパティは、次のとおりです。<uid>はターゲット・プロセスの一意のIDです。DMSメトリックを表示する際に使用される任意の類似した方法で取得されます。このプロパティは、常にOPMN自身を指定します。<instance>はターゲットOracleインスタンスのOracleインスタンス名で、<uid>はOracleインスタンスのターゲット・プロセスに対する一意のIDです。この識別子は、<instance>がローカルのOracleインスタンス名であるか、ファーム内のすべてのOPMNサーバーが相互接続するように構成されている場合にのみ有効です。<component-name>は、opmn.xmlファイルにおける<ias-component>のidの値です。COMPONENT_NAME=opmnは、常にOPMN自身を指定します。<component-type>は、opmn.xmlファイルにおける<ias-component>のタイプの値です。それが定義されていない場合、<process-type>要素のidの値です。COMPONENT_TYPE=OPMNは、常にOPMN自身を指定します。メトリックの問合せにDMS固有のオプションを指定します。<dmsargs>は単一の引数で、これにはDMS層に対する複数のオプションが含まれます。各オプションは<attr>=<value>形式で、&で区切られています。format=raw、format=xml&name=/ProcessInfoのように記述します。Middlewareパフォーマンス・ガイドを参照してください。Service(DMS)統計を出力できます。特定のシステム・コンポーネントに対するプロセス制御操作の出力を取得できます。属性を指定しない場合は、システム・コンポーネントに対するすべてのシステム・コンポーネント・プロセスのパフォーマンス・データが出力されます。DMSでは、1つのパフォーマンス・メトリック、複数のパフォーマンス・メトリックまたはすべてのパフォーマンス・メトリックを監視できます。オプションを使用すると、リクエストしたメトリックをレポートするレポート間隔を指定できます。複数の<attr>=<value>ペアは、&で区切る必要があります。次のopmnctlコマンドを実行します。"table=opmn_ons&format=xml"この場合、ONSに対して収集された統計セットが出力されます。出力には、ONSがリスニングするポートと、ONSが処理した通知数が含まれます。出力は、テキストではなく.xml形式です。テキスト形式で出力を参照する場合は、コマンドラインで&format=xmlを指定しないでください。Middlewareパフォーマンス・ガイドを参照してください。pingコマンドでは、ローカルのOPMNサーバーに接続してサーバーの操作を検証できます。<max_retry>には、最大再試行回数を指定します。<max_retry>を指定すると、コマンドが正常に終了するか<max_retry>で指定した回数に達するまで、1秒ごとにローカルのOPMNに対してpingが実行されます。次のコマンドを実行します。10この場合、pingコマンドが正常に終了するまで、OPMNにpingが10回実行されます。setコマンドでは、OPMNのロギング構成を設定できます。属性名は、属性値とともに指定する必要があります。このコマンドでは、OPMNに必要な次の属性名を指定する必要があります。targetの値には、standard.logを表すlog、またはdebug.logを表すdebugを指定します。標準ログは、デフォルトですべての考えられるログ・メッセージが含まれるように構成されているため、その設定を変更しないことをお薦めします。OPMNのトラブルシューティングの詳細は、付録Bを参照してください。注意:debug.logファイルの使用は、Oracleサポート・サービスに問い合せた後にのみ有効化してください。Oracleサポート・サービスでは、debug.logファイルを使用して、OPMNの問題のデバッグおよび診断を実行します。debug.logファイル内のメッセージは通常、ユーザーに簡単に理解できるものではありません。OPMNの内部コンポーネントおよびサブコンポーネントを指定します。comp属性comp属性の値には、onsまたはpmのいずれかを指定します。この属性値として、ons属性またはpm属性の特定のサブコンポーネント・セットを指定することもできます。compの次の値は、OPMNの内部コンポーネントおよびサブコンポーネントを表します。OPMNの共通内部情報を表します。OPMNのONSコンポーネント情報を表します。OPMNのPMコンポーネント情報を表します。onsコンポーネントとpmコンポーネントはどちらもサブコンポーネントで構成されます。これらのサブコンポーネントは、構文component[subcomponents](componentはonsまたはpm)を使用して指定できます。onsとpmを両方とも指定する場合は、opmn.xmlファイル内でそれぞれをセミコロンで区切る必要があります。サブコンポーネントを複数指定する場合は、それぞれのサブコンポーネントをカンマで区切ります。出力が得られるのは、modLog()(デバッグ・ログの場合はmodDebug)関数をコールするモジュールのみです。modules(module-id)を使用すると、特定のモジュールまたはそのリストを指定できます。(module1-id:module2-id)のように指定します。構成され、有効になっているモジュールと一致しないmodule-idは処理されません。onsおよびpmの各サブコンポーネントには、先頭に否定文字「!」を付けることができます。これにより、そのサブコンポーネントの選択が解除されます。allと指定した後に、特定のサブコンポーネントを否定することによって、そのサブコンポーネントを表示対象から簡単に除外できます。コンポーネントおよびサブコンポーネントは、検出される順序に従って設定または否定されます。次のように指定します。ons[all,!topology]この場合、topologyを除く、onsのすべてのサブコンポーネントが設定されます。ons[!topology,all]この場合、topologyを含む、onsのすべてのサブコンポーネントが設定されます。queryコマンドでは、OPMNのロギング構成の問合せを実行できます。属性名targetは、属性値とともに指定する必要があります。targetの値には、opmn.logファイルを表すlogまたはopmn.dbgファイルを表すdebugのいずれかを指定します。詳細は、第B.2.1項「OPMNログ・ファイル」を参照してください。helpコマンドを使用すると、OPMNに関する追加情報を取得できます。この項では、opmnctlコマンドで使用できるヘルプ・コマンド・オプションについて説明します。次の項で構成されています。helpopmnctlコマンドの構文に関する簡単な説明を出力する場合は、このコマンドを使用します。helpコマンドの出力を示します。[<command>]usageコマンドを実行すると、任意の指定されたopmnctlコマンドのヘルプが表示されます。helpと同じ情報が表示されます。次のいずれかのコマンドを指定できます。startstartallstartprocstopallstopprocrestartprocreloadshutdownpingstatusmetricdmsdumpdebugsetquerylaunchphantompingvalidatehelpusagecreateinstancecreatecomponentdeleteinstancedeletecomponentregisterinstanceunregisterinstanceupdateinstanceregistrationupdatecomponentregistrationhelpたとえば、次のコマンドを入力すると、例4-7に示す出力が表示されます。validateコマンドを実行すると、opmn.xmlファイルのXML構文が検証されます。ORACLE_INSTANCE/bin/opmnctlを使用する場合は、デフォルトのORACLE_INSTANCE/config/OPMN/opmn/opmn.xmlが検証されます。<filename>は、相対パスと絶対パスのどちらでも指定できます。reserved.法律上の注意点ライブラリ。