Fusion Middleware Oracle Process Manager and Notification Server管理者ガイド

11gリリース1（11.1.1.1.3）

B60985-01(原本部品番号:E14007-04)

目次

タイトルと著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 OPMNの新機能

- 1.1 Oracleインスタンスとの統合

- 1.2 Oracle WebLogic Serverでのサポート

2 Oracle Process Manager and Notificationの概要

- 2.1 OPMNとは

- 2.2 OPMNの動作

- 2.2.1 Oracle Notification Server

- 2.2.2 Oracle Process Manager

- 2.2.3 PMモジュール

- 2.3 OPMNが管理するシステム・コンポーネント

- 2.3.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

3 opmn.xmlファイル

- 3.1 opmn.xml

- 3.2 自動再起動

- 3.3 OPMNログ・ファイル

- 3.4 セキュリティ

- 3.5 IPv6サポート

4 opmnctlコマンド

- 4.1 opmnctl

- 4.1.1 opmnctlの構文

- 4.2 opmnctlコマンドのクイック・リファレンス

- 4.3 opmnctlコマンドの詳細説明

- 4.3.1 コマンド定義

- 4.3.1.1 scope

- 4.3.1.2 属性

- 4.3.1.3 verbose

- 4.3.2 サーバー制御コマンド

- 4.3.2.1 Microsoft Windowsのサーバー制御コマンド

- 4.3.2.2 opmnctl start

- 4.3.2.3 opmnctl startall

- 4.3.2.4 opmnctl stopall

- 4.3.2.5 opmnctl shutdown

- 4.3.2.6 opmnctl reload

- 4.3.3 プロセス制御コマンド

- 4.3.3.1 opmnctl startproc、opmnctl restartprocおよびopmnctl stopproc

- 4.3.3.2 漸進的なリクエスト・レポート

- 4.3.3.3 順次リクエスト

- 4.3.4 プロビジョニング・コマンド

- 4.3.4.1 一般的な構文

- 4.3.4.2 プロビジョニング・コマンドの代替構文

- 4.3.4.3 一般的な引数

- 4.3.4.4 コマンド

- 4.3.5 ステータス・コマンド

- 4.3.5.1 opmnctl status

- 4.3.5.2 opmnctl metric

- 4.3.5.3 opmnctl dmsdump

- 4.3.5.4 opmnctl ping

- 4.3.5.5 opmnctl set

- 4.3.5.6 opmnctl query

- 4.3.6 ヘルプ・コマンド

- 4.3.6.1 opmnctl help

- 4.3.6.2 opmnctl usage

- 4.3.6.3 opmnctl validate

5 OPMNの使用

- 5.1 OPMNの起動

- 5.2 すべてのシステム・コンポーネントの起動と停止

- 5.3 1つのシステム・コンポーネントの起動と停止

- 5.4 同じタイプのすべてのシステム・コンポーネントの起動と停止

6 opmn.xmlの一般的な構成

- 6.1 opmn.xmlの要素および属性の例

- 6.1.1 グローバル定義および構文

- 6.2 opmn.xmlの要素および属性の説明

A カスタム・プロセスの構成

- A.1 カスタム・プロセス・モジュールの構成

- A.2 カスタム・プロセスの最小構成

- A.3 カスタム・プロセスの完全構成

- A.3.1 Ping

- A.4 カスタム・プロセスの属性の説明

B OPMNのトラブルシューティング

- B.1 問題点とソリューション

- B.1.1 システム・プロセスが起動しない

- B.1.2 システム・プロセスに障害が発生または応答なしの状態になっているかどうかを判断する

- B.1.3 opmnctlコマンド実行のタイムアウト

- B.1.4 システム・コンポーネントがOPMNによって自動的に再起動される

- B.1.5 opmnctl startの予想外の動作

- B.1.6 opmn.xmlファイル内の無効な要素

- B.1.7 OHSを起動できない

- B.1.8 コンポーネントを停止できない

- B.1.9 globalInitNLSエラー

- B.1.10 OPMNの起動時にCPU使用率が増加する

- B.1.11 OPMN起動時にエラー・メッセージが表示される

- B.1.12 opmn.logファイルのサイズが増える

- B.1.13 不適切な状態にあるOracleインスタンスまたはコンポーネントのクリーンアップ

- B.1.14 引用符を含むパス引数をWindowsオペレーティング・システムで使用する場合

- B.2 OPMNの問題の診断

- B.2.1 OPMNログ・ファイル

- B.2.1.1 opmn.logとdebug.logのファイル・ローテーション

- B.2.1.2 プロセス・コンソールのログ・ファイル・ローテーション

- B.2.2 opmnctl debug

- B.2.3 Oracle Enterprise Manager Fusion Middleware Controlコンソール

- B.2.4 イベント・スクリプトを使用したトラブルシューティング

- B.2.5 opmn.xmlの環境変数

- B.3 その他のヘルプ情報

索引

Oracle® Fusion Middleware

Oracle Process Manager and Notification Server管理者ガイド

11gリリース1（11.1.1.1.3）

B60985-01(原本部品番号:E14007-04)

2010年6月

Oracle Fusion Middleware Oracle Process Manager and Notification Server管理者ガイド, 11gリリース1（11.1.1.1.3）

B60985-01

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.

原本著者: Kurt Heiss

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアを危険が伴うアプリケーションで使用する際、このソフトウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

このガイドでは、Oracle Fusion Middlewareのコンポーネントを管理するためのOracle Process Manager and Notification Server（OPMN）の管理方法について説明します。

この章は、次の項で構成されています。

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

対象読者

このドキュメントは、Oracle Fusion Middlewareの管理者を対象としています。

ドキュメントのアクセシビリティについて

オラクル社は、オラクル社の製品、サービスおよびサポート・ドキュメントを、障害のあるお客様を含むすべてのお客様にご利用いただけることを目標としています。オラクル社のドキュメントには、ユーザーが障害支援技術を使用して情報を利用できる機能が組み込まれています。HTML形式のドキュメントで用意されており、障害のあるお客様が簡単にアクセスできるようにマークアップされています。標準規格は改善されつつあります。オラクル社はドキュメントをすべてのお客様がご利用できるように、市場をリードする他の技術ベンダーと積極的に連携して技術的な問題に対応しています。オラクル社のアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/accessibility/を参照してください。

ドキュメント内のサンプル・コードのアクセシビリティについて

スクリーン・リーダーは、ドキュメント内のサンプル・コードを正確に読めない場合があります。コード表記規則では閉じ括弧だけを行に記述する必要があります。しかしJAWSは括弧だけの行を読まない場合があります。

外部Webサイトのドキュメントのアクセシビリティについて

このドキュメントにはオラクル社およびその関連会社が所有または管理しないWebサイトへのリンクが含まれている場合があります。オラクル社およびその関連会社は、それらのWebサイトのアクセシビリティに関しての評価や言及は行っておりません。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportを通じて電子的な支援を受けることができます。詳細については、http://www.oracle.com/support/contact.htmlにアクセスしてください。また、聴覚に障害があるお客様は、http://www.oracle.com/accessibility/support.htmlを参照してください。

関連ドキュメント

詳細は、次に示すOracle製品関連ドキュメント・リソースを参照してください。

- Oracle Fusion Middlewareのドキュメント・ライブラリ

- Oracle Fusion Middlewareのプラットフォーム別ドキュメント

表記規則

本文では、次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するグラフィカル・ユーザー・インタフェース要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、パラグラフ内のコマンド、URL、例に記載されているコード、画面に表示されるテキスト、または入力するテキストを示します。

1 OPMNの新機能

この章では、Oracle Fusion Middleware 11gリリース1（11.1.1.1.3）で使用できるOracle Process Manager and Notification Server（OPMN）の新しい機能について説明します。

この章の項目は次のとおりです。

- Oracleインスタンスとの統合

- Oracle WebLogic Serverでのサポート

1.1 Oracleインスタンスとの統合

各ORACLE_HOMEには、独自の構成および診断ディレクトリ・ツリー（ORACLE_INSTANCE）があり、複数のインスタンスをサポートできます。OPMNは現在、ORACLE_INSTANCE内から動作します。

ORACLE_INSTANCEベース・ディレクトリ内には、ORACLE_INSTANCE/configおよびORACLE_INSTANCE/diagnostics/logsという2つの基本サブディレクトリが格納されています。これらの2つのディレクトリ内には、component type/component nameという形式の、各コンポーネントに固有のディレクトリ・ツリーがあります。ここで、component typeはias-componentに対して構成されたOPMN type値またはコンポーネントのprocess-type idであり、component nameはias-componentに対して構成されたid値です。

たとえば、デフォルトのOracle HTTP Server（OHS）のインストール・ログの構成ディレクトリは、次のとおりです。

ORACLE_INSTANCE/config/OHS/ohs1（UNIX）

ORACLE_INSTANCE\config\OHS\ohs1（Microsoft Windows）

OPMN component typeは常にOPMNであり、component nameは常にopmnです。

1.2 Oracle WebLogic Serverでのサポート

大半のOracle Fusion Middlewareのインストールでは、Oracleインスタンスが、Oracle Enterprise Manager Fusion Middleware Controlコンソール（Fusion Middleware Controlコンソール）を使用してシステム・コンポーネントを管理するためのOracle WebLogic Serverドメインに関連付けられています。これらのデプロイメントでは、OPMNがWebLogicドメインと統合され、システム・コンポーネントをリモートから管理できます。

Oracle Fusion Middlewareの旧リリースとは異なり、OPMNは、ローカルのOracleインスタンスのシステム・コンポーネントを管理できるだけでなく、WebLogicドメインと統合して、Fusion Middleware ControlコンソールやWLSTコマンドラインを使用したリモートのシステム・コンポーネントの管理ができるようになりました。

注意:
Oracle Fusion Middlewareの管理コンセプトの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

2 Oracle Process Manager and Notificationの概要

この章では、Oracle Fusion MiddlewareのOracle Process Manager and Notification（OPMN） Serverの概要について説明します。次のトピックで構成されています。

- OPMNとは

- OPMNの動作

- OPMNが管理するシステム・コンポーネント

2.1 OPMNとは

Oracle Process Manager and Notification（OPMN）は、次のインストール・タイプでインストールおよび構成されます。

- Web Tierのインストール: OPMNは、Oracle HTTP ServerおよびOracle Web Cacheを管理します。

- Oracle Portal、Forms、Reports、およびDiscovererのインストール: OPMNは、Oracle Portal、Oracle Forms Services、Oracle Reports、Oracle Business Intelligence Discoverer、およびOracle EM Agent and Service Managerを管理します。

- Oracle Identity Managementのインストール: OPMNは、Oracle Internet DirectoryおよびOracle Virtual Directoryを管理します。

OPMNには次のような機能があります。

- 1つまたは複数のシステム・コンポーネントのプロセス制御と監視のためのコマンドライン・インタフェースを提供する。

- システム・コンポーネントの統合的な管理方法を提供する。

- システム・サブコンポーネントおよびサブ・サブコンポーネントの管理を可能にする。

- 様々なシステム・コンポーネント・インスタンスからのすべてのイベントを、それらのイベントを使用するすべてのシステム・コンポーネントに配信する。

- 設定した順序でコンポーネントを起動、停止することにより、システム・コンポーネント間の相互依存性の問題を解決する。

- イベント・スクリプトを使用してエンタープライズ機能をカスタマイズ可能にする。

- ホストおよびシステム・プロセスの統計やタスクの収集を可能にする。

- pingや通知操作により、応答なし、予期せぬ終了または切断が確認された場合にシステム・プロセスを自動的に再起動する。

- システム・プロセスの停止を自動的に検出する。

- opmn.xmlファイルを変更することで、Oracleインスタンスを制御できるようにする。

Oracleインスタンスは、共通のOPMNによって管理される一連のシステム・コンポーネントが格納されたディレクトリです。

コンピュータの起動後できるだけ早くOPMNサーバーを起動してください。システム・コンポーネントを起動または停止する際には、OPMNが実行されている必要があります。

Microsoft Windowsでは、OPMNは各Oracleインスタンスに対するサービスとして作成されます。

OPMNが管理するOracle Fusion Middlewareコンポーネントは、手動で起動および停止しないでください。システム・コンポーネントの起動および停止に、旧バージョンのOracle Fusion Middlewareのコマンドライン・スクリプトやユーティリティを使用しないでください。コンピュータを再起動またはシャットダウンするとき、OPMNサービスは最後に停止する必要があります。

システム・コンポーネントを起動および停止するには、Fusion Middleware Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。

注意:
opmnctlコマンドの詳細は、第4章を参照してください。

2.2 OPMNの動作

OPMNは、同じまたは異なるOPMNサーバー内のシステム・プロセス間で送信される通知情報を解析および伝送する、3つのコンポーネントから成るコア・グループで構成されます。

OPMNのコアは、次の3つのコンポーネントで構成されます。

- Oracle Notification Server

- Oracle Process Manager

- PMモジュール

図2-1にOPMNのコアのアーキテクチャを示します。

図2-1 OPMNのアーキテクチャ

「図2-1 OPMNのアーキテクチャ」の説明

2.2.1 Oracle Notification Server

Oracle Notification Server（ONS）は、Oracle Fusion Middlewareのコンポーネント間で障害、リカバリ、起動、その他の関連する通知を転送するメカニズムです。ONSは、パブリッシュ・サブスクライブ・モデルに基づいて動作します。このモデルでは、システム・コンポーネントが、ONSに登録したサブスクリプションごとに特定のタイプの通知を受信します。こうした通知が発行されると、ONSはその通知を適切なサブスクライバに送信します。

旧バージョンのOracle Fusion Middlewareとは異なり、ONSは他のOPMNサーバーを検出するようには構成されていません。WebLogicドメインですべてが集中的に管理されるため、OPMNの通常の動作では他のOPMNに接続する必要がありません。必要に応じて、WebLogicドメインでは、各OPMNサーバーへのリモート・クライアント接続が確立されます。

2.2.2 Oracle Process Manager

Oracle Process Manager（PM）は、システム・プロセスを管理するための集中プロセス管理メカニズムです。PMは、管理するすべてのプロセスの起動、再起動、停止および監視を行います。PMは、プロセスの制御やプロセスのステータス取得に関連するOPMNに送信されるすべてのリクエストを処理します。また、PMが管理するプロセスの障害検出と自動再起動も実行します。PMの管理対象となるシステム・プロセスは、opmn.xmlファイルで指定されます。

PMは、特定またはすべてのシステム・プロセスを起動するユーザー・コマンドを待機します。プロセスが停止すると、PMはリクエスト・パラメータで指定されたリクエストを受け取ります。

OPMNサーバーは2つのプロセスで構成されます。第1のOPMNサーバー・プロセスは、必要時に第2のOPMNサーバー・プロセスを起動する目的のみに使用されます。第2のOPMNサーバー・プロセスがすべてのリクエスト・トラフィックを処理し、すべての機能を実行します。第2のOPMNサーバー・プロセスは、opmnctl reloadコマンドや予期せぬクラッシュが原因で停止した場合、第1のOPMNサーバー・プロセスによって再起動されます。

Microsoft Windowsの場合、第2のOPMNサーバー・プロセスは、意図的に終了された場合、再起動されません。第1のOPMNサーバー・プロセスも終了します。この状況からリカバリするには、コマンドラインまたはサービス・マネージャからOPMNサーバーを再起動します。

Fusion Middleware Controlコンソールもプロセスの処理にPMを使用します。

PMは、Oracle Notification Serverを使用して次のことを行います。

- プロセスの初期化完了およびリクエストの受信準備完了の検出

- 使用中のポートの特定

- コンポーネント固有のランタイム情報の取得

2.2.3 PMモジュール

Oracle Process Managerモジュール（PMモジュール）は、システム・コンポーネント固有のプロセス管理機能を実装します。PMモジュールは、同じまたは異なるOPMNサーバー内の他のシステム・コンポーネントのPMモジュールから返される通知情報を渡します。

PMモジュールの機能は次のとおりです。

- 実行中のコンポーネントから発信されるすべての通信の処理

- システム・コンポーネント固有の制御情報（コンポーネントの起動、停止および再起動方法）の構成

- コンポーネントがリクエストに応答するかどうかを確認するシステム・コンポーネント固有の方法による応答性のテスト

関連項目:
opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。

2.3 OPMNが管理するシステム・コンポーネント

OPMNは、Oracle EM Agent、Service Managerなど、すべてのシステム・コンポーネントを管理します。

カスタムPMモジュールを使用して、その他のプロセス（Oracle製品やサード・パーティ製品を含む）を管理するようにOPMNを構成することも可能です。カスタム・プロセスの構成の詳細は、付録Aを参照してください。

OPMNは次のOracle Fusion Middlewareコンポーネントを管理します。

- OHS

- Oracle Web Cache

- Oracle Internet Directory

- Oracle Virtual Directory

- Oracle Forms

- Oracle Reports

- Oracle Business Intelligence Discoverer

2.3.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

OPMNの他にも、Fusion Middleware Controlコンソールを使用して企業を管理できます。Fusion Middleware Controlコンソールは、OPMNの機能を利用してOracle Fusion Middlewareエンタープライズを管理します。Fusion Middleware Controlコンソールは、Webブラウザを使用して、ネットワークおよび企業内のすべてのシステム・コンポーネントを管理できるグラフィカル・インタフェースを提供します。

関連項目:
Oracle Fusion Middleware管理の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

3 opmn.xmlファイル

この章では、Oracle Fusion Middlewareのopmn.xmlファイルの概要について説明します。次のトピックで構成されています。

- opmn.xml

- 自動再起動

- OPMNログ・ファイル

- セキュリティ

- IPv6サポート

3.1 opmn.xml

ORACLE_INSTANCE/config/OPMN/opmn/opmn.xmlファイルは、OPMNの主要な構成ファイルです。opmn.xmlファイルには、PMおよびシステム・コンポーネント固有の構成情報が格納されています。opmn.xmlファイルは、システム上のどのシステム・コンポーネントがOPMNによって管理されているかを示します。

opmn.xmlファイルは、log files、notification-serverおよびprocess-managerの3つの主要セクションに分けられています。

- log files: デフォルトのlog files構成は、標準ログを完全に有効化しますが、デバッグ・ログを無効化します。

- notification-server: notification-server構成には、OPMNリスナー・ポートおよびセキュアな接続定義が含まれています。オプションの<topology> opmn.xmlファイル要素は、OPMN検出のために手動で追加できます。

- process-manager: process-manager構成には、各管理対象コンポーネントに必要なすべての情報が含まれます。

opmn.xmlファイルには、コンポーネント固有の要素名は含まれません。コンポーネント固有の管理コードは、opmn.xmlファイルのmodulesセクションで指定されたPMモジュールにあります。これらのPMモジュールはOPMNの起動時にロードされます。

各レベルには、一連の固有の構成があります。また、複数のレベルで有効な構成要素もあるため、ある構成をシステム・コンポーネント全体に適用することもコンポーネントの一部にのみ適用することも柔軟にできます。

<ias-component>
<process-type>
<process-set>

<ias-component>: システム・コンポーネントを表します。このエントリにより、起動や停止などコンポーネントのプロセスを管理できます。

<process-type>: <ias-component>エントリのサブコンポーネントであり、特定のPMモジュールに関連して実行するプロセス・タイプを宣言します。

<process-set>: <ias-component>エントリのサブ・サブコンポーネントであり、システム・コンポーネントに対するオプションのランタイム引数やランタイム環境の様々なセットを宣言できます。<process-set>はオプションの構成要素です。

opmn.xmlファイルには、システム・コンポーネントのエントリが、例3-1に示すような階層構造で配置されます。

例3-1 opmn.xmlファイルの要素のエントリ

<ias-component id="ohs1">
<process-type id="OHS">
<process-set id="OHS">....

3.2 自動再起動

OPMNでは、コンポーネントの自動障害検出と再起動をユーザーが制御できます。つまり、OPMNがプロセスの障害を特定する際に使用するパラメータを設定したり、各コンポーネントの自動再起動を無効化したりできます。

OPMNは、次の方法で管理対象プロセスの動作を監視します。

- オペレーティング・システム・レベルでのシステム・プロセス障害の検出

- システム・プロセスへの定期的なpingリクエスト

- システム・プロセスからの定期的なステータス通知（リバースping）

pingおよび通知機能は、システム・コンポーネントの機能に従って適切な場合にのみ実行されます。

OPMNは、予期せず中断したシステム・コンポーネントを自動的に再起動します。またOPMNは、通知およびping操作の結果に基づいて応答しないプロセスを再起動します。

関連項目:
opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。

3.3 OPMNログ・ファイル

OPMNが生成するログ・ファイルには、パフォーマンスや構成の問題の特定に役立つ重要な情報が保存されています。Fusion Middleware Controlコンソールでは、システム・コンポーネントのログ・ファイルを容易に検索および表示し、確認できるようになっています。

関連項目:

- 診断ユーティリティの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

- OPMNログ・ファイルの詳細は、第B.2.1項を参照してください。

3.4 セキュリティ

ONSクライアントおよびPM管理プロセスが使用するOPMNのローカル・リスナー・ポートでは、セキュリティにSecure Sockets Layer（SSL）暗号化を使用しませんが、別の2つのメカニズムを使用してOPMNサーバーへのアクセスを許可します。

- OPMNは、ローカル・リスナー・ポートをローカル・ホストにバインドします。ローカル・システムのユーザーは、このポートに接続してOPMNプロセスの制御リクエストを発行します。情報のリクエストは、システムIPにバインドされたOPMNリクエスト・ポート上で許可されます。リクエスト・ポートはSSL暗号化をサポートしません。

- OPMNサーバー・プロセスが初めて起動してローカル・ポートに正常にバインドすると、出力可能なASCII文字の文字列が作成され、これがローカル接続の鍵として使用されます。ローカル・ポートへのすべての接続には、この鍵が含まれている必要があります。含まれていないと、OPMNサーバーにより切断されます。このASCII文字列は、ORACLE_HOME/opmn/.formfactorファイルに書き込まれます。.formfactorファイルにアクセスできないプロセスは、OPMNサーバーとのやり取りを許可されません。

セキュリティ上の理由から、OPMNサーバーは、無効なフォーム・ファクタ鍵（このOPMNプロセスによって.formfactorファイルに書き込まれた値と一致しない鍵）を使用したローカル・ポートへの接続をすべてログに記録します。次のようなことが発生する可能性があります。

- ユーザーが、間違ったユーザーIDを使ってOPMNクライアントを手動で実行しようとする。アプリケーション・サーバーのユーザーのみ.formfactorファイルの値を読み取ることができるため、間違ったユーザーが実行するリクエストまたはプロセスでは、OPMNサーバーに正しい鍵を渡すことができません。

- ユーザーが間違ったOracleインスタンスからOPMNクライアントを実行しようとする（1つのシステムに複数のOracleインスタンスを構成できます）。他のOracleインスタンスのOPMNが同じローカル・ポートを使用するように構成されていると、間違ったOracleインスタンスからのシステム・プロセス・リクエストが、間違った.formfactorファイルを読み取ります。

- ユーザーが、opmn.xmlファイルのローカル・ポート構成を手動で変更し、前のOPMNサーバーを停止せずに新しいOPMNサーバーを起動した。新しいOPMNサーバーを実行すると、このプロセスが新しいポートにバインドし、.formfactorファイルが上書きされます。ローカル・ポートから前のOPMNサーバーに接続できなくなり、リモートのOPMNリクエスト（SSLおよび認証が構成されている場合）を実行するか前のOPMNサーバーを手動で停止しないと、前のサーバーをシャットダウンできなくなります。

- Oracle Fusion MiddlewareとOracle Databaseの両方がONSを使用している。これらの2つの製品が同じホストにインストールされていると、ONS用のポート値がOracle DatabaseとOracle Fusion Middlewareコンポーネントの両方で同一である場合には、ONSポートの競合が発生することがあります。
Oracle Databaseでは、ONSは特別な構成に対してのみ使用されるため、通常は起動されていません。しかし、データベース・リスナーがDatabase ONSサーバーに接続を試みると、Oracle Fusion MiddlewareとともにインストールされたONSサーバーに接続してしまうことになります。ONS（OPMNの構成要素としての）は、Oracle Fusion Middlewareを起動すると常に起動されます。

Oracle DatabaseはOracle Fusion Middlewareとは異なる場所にインストールされるため、Oracle Fusion MiddlewareとともにOPMNが起動されたときに作成された.formfactorファイルにDatabase ONSはアクセスできません。結果として、データベース・リスナーはOPMNへの接続を試み、DBリスナーはそれをフォーム・ファクタ文字列のない自分用のスタンドアロンONSとして解釈します。OPMNは、ons.logファイルに次のようなエラーを記録します。

04/11/15 18:43:32 [4] Local connection 0,127.0.0.1,6100 invalid form factor

これはOPMNの予定された動作で、正しいフォーム・ファクタ文字列を所持しないかぎり、ONSサーバーへのクライアント・アクセスが禁止されます。

Oracle DatabaseリスナーがシステムOPMNサーバーに接続するのを回避するには、Oracle DatabaseとともにインストールしたONSサーバーに対するデフォルトのローカルおよびリモート・ポート値を変更します。

3.5 IPv6サポート

ONSは、ネットワーク・インタフェースIPv4とIPv6を同時にサポートできます。

IPv4は、インターネット・プロトコル（IP）のバージョン4です。これは、広く普及したIPの最初のバージョンであり、現在のほとんどのインターネットの基盤となっています（2004年時点）。

IPv4のアドレスは32ビットであるため、一意のアドレス数は4,294,967,296までに制限されます。これらのアドレスのほとんどは、ローカル・ネットワーク、マルチキャスト・アドレスなどの特別な用途に確保されるため、公に割り当てられるインターネット・アドレス数は少なくなります。

IPv6の導入により、デバイス（特に携帯電話やモバイル機器）の接続性に対する今後の需要拡大に対応可能なIPアドレスの不足問題を解決することが期待されています。IPv6は、340澗（3.4 × 10^38）アドレスをサポートします。

図3-1に示すように、デバッグやログの記録などの出力のための各IPv4識別子は、アドレス用に8ビットのフィールドが4つ（それぞれ3桁の10進数表記）とポート用に16ビットのフィールドが1つ（5桁の10進数表記）表示されます。

各IPv6識別子は、アドレス用に16ビットのフィールドが8つ（それぞれ4桁の16進数表記）とポート用に16ビットのフィールドが1つ（5桁の10進数表記）表示されます。

図3-1 IPv4とIPv6のホスト識別子

「図3-1 IPv4とIPv6のホスト識別子」の説明

4 opmnctlコマンド

この章では、OPMNで管理するOracle Fusion Middlewareコンポーネントに対して使用できるopmnctlコマンドの概要について説明します。次のトピックで構成されています。

- opmnctl

- opmnctlコマンドのクイック・リファレンス

- opmnctlコマンドの詳細説明

4.1 opmnctl

opmnctlは、Fusion Middleware Controlコンソールを除く、Oracleインスタンスのすべてのコンポーネントの起動および停止をサポートするツールです。opmnctlでは、コマンドラインからシステム・コンポーネントを集中的に制御および監視できます。

OPMNが他のOracleインスタンスを検出するように構成されている場合、opmnctlを使用して、複数のOracleインスタンスに対する制御コマンドや監視コマンドを同時に実行できます。

opmnctlスクリプトの場所に応じて、使用できるopmnctlコマンドが決定されます。

opmnctlコマンドは、次の2つのディレクトリに保存されています。

- ORACLE_HOME/opmn/bin/opmnctl: opmnctlコマンドORACLE_HOME/opmn/bin/opmnctlの場所は、Oracleインスタンスやローカル・システム上のOracleインスタンスのコンポーネントを作成する場合にのみ使用されます。この場所で生成されたopmnctlコマンドを使用して、システム・プロセスを管理することはできません。

- ORACLE_INSTANCE/bin/opmnctl: 別のopmnctlコマンドは、ORACLE_INSTANCE/bin/ディレクトリにあり、Oracleインスタンスごとにopmnctlをインスタンス化します。このOracleインスタンスのプロセスを管理するには、この場所にあるopmnctlコマンドを使用する必要があります。このコマンドは、Oracleインスタンスのコンポーネントを作成する際にも使用できます。

注意:
OPMNが管理するOracle Fusion Middlewareコンポーネントは、手動で起動および停止しないでください。システム・コンポーネントの起動および停止に、旧バージョンのOracle Fusion Middlewareのコマンドライン・スクリプトやユーティリティを使用しないでください。システム・コンポーネントを起動および停止するには、Fusion Middleware Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。

注意:
OPMNの起動は、Oracle Fusion Middlewareをインストールしたユーザーとして実行することをお薦めします。

4.1.1 opmnctlの構文

次のコマンドは、opmnctlコマンドの構文例です。

opmnctl [verbose] <command> [<options>]

表4-1にopmnctlの構文の説明を示します。

表4-1 opmnctlの構文

構文

説明

verbose

可能な場合、詳細な実行メッセージを出力します。

command

opmnctlコマンドを指定します。コマンドの一覧は、例4-1を参照してください。

options

コマンドのオプションを指定します。コマンドのオプションの一覧は、第4.3.5.1.1項を参照してください。

4.2 opmnctlコマンドのクイック・リファレンス

例4-1にopmnctlコマンドのクイック・リファレンスを示します。opmnctl helpコマンドを実行すると、同じ情報が出力されます。

例4-1 opmnctlコマンド

opmnctl help

usage: opmnctl [verbose] [<scope>] <command> [<options>]

verbose: print detailed execution message if available

Permitted <scope>/<command>/<options> combinations are:

scope     command    options
-------  ---------   ---------
start                         - Start opmn
startall                      - Start opmn & all managed processes
stopall                       - Stop opmn & all managed processes
shutdown                      - Shutdown opmn & all managed processes
[<scope>] startproc   [<attr>=<val> ..] - Start opmn managed processes
[<scope>] restartproc [<attr>=<val> ..] - Restart opmn managed processes
[<scope>] stopproc    [<attr>=<val> ..] - Stop opmn managed processes
[<scope>] reload                        - Trigger opmn to reread opmn.xml
[<scope>] status      [<options>]       - Get managed process status
[<scope>] metric      [<attr>=<val> ..] - Get DMS metrics for managed processes
[<scope>] dmsdump     [<dmsargs>]       - Get DMS metrics for opmn
[<scope>] debug       [<attr>=<val> ..] - Display opmn server debug information
[<scope>] set         [<attr>=<val> ..] - Set opmn log parameters
[<scope>] query       [<attr>=<val>]    - Query opmn log parameters
launch      [<attr>=<val> ..] - Launch a configured target process
phantom     [<attr>=<val> ..] - Register phantom processes
ping        [<max-retry>]     - Ping local opmn
validate    [<filename>]      - Validate the given opmn xml file
help                          - Print brief usage description
usage       [<command>]       - Print detailed usage description
createinstance                - Create an Oracle Instance
createcomponent               - Create a specified component
deleteinstance                - Delete an instance and components
deletecomponent               - Delete a specified component
registerinstance              - Register with admin server
unregisterinstance            - Unregister with admin server
updateinstanceregistration    - Update instance registration
updatecomponentregistration   - Update component registration

4.3 opmnctlコマンドの詳細説明

次の項では、例4-1の一覧に示したopmnctlコマンドについて詳しく説明します。opmnctlの各コマンドについては、次の項を参照してください。

- コマンド定義

- サーバー制御コマンド

- プロセス制御コマンド

- プロビジョニング・コマンド

- ステータス・コマンド

- ヘルプ・コマンド

4.3.1 コマンド定義

opmnctlには、OPMNで実行する操作をより詳細に定義できるコマンド定義があります。

この項では、opmnctlコマンドで使用できるコマンド定義について説明します。次の項で構成されています。

- scope

- 属性

- verbose

4.3.1.1 scope

scopeオプションは、opmnctlコマンドを適用するOracleインスタンスを指定します。Oracle Fusion Middlewareの旧バージョンとは異なり、このリリースでは、forceオプションは使用されず、下位互換性が保持されます。

4.3.1.2 属性

構文: <attribute>=<value>

opmnctlの属性を使用すると、特定のシステム・コンポーネントのプロセスを制御できます。

たとえば、次のコマンドを実行すると、Oracle Web Cacheに構成されたすべてのシステム・プロセスが起動します。

opmnctl startproc ias-component=webcache1

その他のopmnctlコマンドの例は、第5章を参照してください。

表4-2に、opmnctlコマンドで使用できる属性名と値の一覧を示します。

表4-2 opmnctlの属性名と値

属性名

属性値

ias-instance

opmn.xmlファイル内の<ias-instance>要素に指定したid属性と同じ値を指定します。

ias-component

opmn.xmlファイル内の<ias-component>要素に指定したid属性と同じ値を指定します。

process-type

opmn.xmlファイル内の<process-type>要素に指定したid属性と同じ値を指定します。

process-set

opmn.xmlファイル内の<process-set>要素に指定したid属性と同じ値を指定します。

mode

syncまたはasyncのいずれかの値を指定します。デフォルト値はsyncです。この場合、このリクエストは同期的に動作し、操作が完了するまで待機してから制御を戻します。"asyncを指定した場合、制御はすぐに戻りますが、OPMNは操作が完了するまでリクエストを実行します。

timeout

modeにsyncを指定した場合のみ、この属性を指定できます。値は秒単位で指定します。指定したタイムアウトが経過すると、OPMNはstartproc操作のリクエストを中断します。restartprocおよびstopproc操作のリクエストは引き続き実行されます。timeout属性は、各ias-instance、ias-component、process-typeおよびprocess-set値に構成されたタイムアウト値よりも優先されます。

uniqueid

これは、OPMNによって起動後に割り当てられる値です。opmnctl restartprocおよびopmnctl stopprocコマンドを実行する場合に、この値を使用できます。

sequential

sequential属性の値がtrueの場合、リクエストのターゲットである各プロセスまたはアプリケーションは順番に（一度に1つずつ）実行されます。関係する管理対象プロセスの依存性のリクエスト順序も反映されます。

report

report属性の値が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のリスト）で指定することもできます。

注意:
Oracle Internet DirectoryがOPMNによって管理されていて、Oracle Internet Directoryの依存性（Oracle Internet Directoryの管理対象プロセスの依存性ではない）がリクエストの一部として出現し、リクエストが2つのOracle Internet Directoryプロセスを起動するリクエスト（opmnctl startallリクエストなど）である場合、Oracle Internet Directoryプロセスは、事前にopmn.xmlファイルで構成されていないかぎり起動 しません。あるいは、Oracle Internet Directoryの依存性の障害により、そのリクエストはタイムアウトになります。

関連項目:
OPMNコマンドラインの例は、第5章を参照してください。

4.3.1.3 verbose

構文: opmnctl verbose command

opmnctl verboseオプションを指定すると、実行中のコマンドに関する詳細情報を取得できます。

たとえば、次のコマンドは例4-2のような情報を出力します。

prompt> opmnctl verbose startproc ias-component=ohs1

例4-2 opmnctl verboseの出力

opmnctl startproc: starting opmn managed processes...

HTTP/1.1 200 OK
Content-Length: 661
Content-Type: text/html
Response: 1 of 1 processes started.

<?xml version='1.0' encoding='WINDOWS-1252'?>
<response>
<opmn id="stapk08:6704" http-status="200" http-response="1 of 1 processes
started.">
<ias-instance id="instance1">
<ias-component id="ohs1">
<process-type id="OHS">
<process-set id="OHS">
<process id="1792746301" pid="5106" status="Alive" index="1"
log="/scratch/lbottlem/product/11.1.1/as
1/instances/instance1/diagnostics/logs/OHS/ohs1/console~OHS~1.log"
operation="request" result="success">
<msg code="0" text="">
</msg>
</process>
</process-set>
</process-type>
</ias-component>
</ias-instance>
</opmn>
</response>

4.3.2 サーバー制御コマンド

opmnctl start、startall、reload、stopallおよびshutdownコマンドを実行すると、OPMNサーバーを制御できます。

- Microsoft Windowsのサーバー制御コマンド

- opmnctl start

- opmnctl startall

- opmnctl stopall

- opmnctl shutdown

- opmnctl reload

opmnctlのサーバー制御コマンドが正常に実行された場合、出力は生成されません。opmnctlコマンドの実行時にエラー・メッセージが出力された場合は、付録Bを参照してください。

4.3.2.1 Microsoft Windowsのサーバー制御コマンド

Microsoft Windowsオペレーティング・システムでは、OPMNがWindowsサービス（Oracle<OracleHomename>ProcessManager）としてインストールされており、コンピュータを再起動すると自動的に起動します。Microsoft Windowsサービスを使用したOPMNの起動や停止では、ローカルのOracleインスタンス上のすべてのシステム・コンポーネントが起動または停止されます。

システム・コンポーネントを起動および停止するには、Fusion Middleware Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。

4.3.2.2 opmnctl start

構文: opmnctl start

システム・プロセスを開始せずにローカルのOracleインスタンス用のOPMNサーバーを起動する場合は、このコマンドを実行します。

注意:
Microsoft Windowsでは、コンピュータを起動または再起動すると、OPMNが自動的に起動します。すべてのシステム・コンポーネント・プロセスも開始されます。

関連項目:
OPMNコマンドラインの例は、第5章を参照してください。

4.3.2.3 opmnctl startall

構文: opmnctl startall [timeout=<seconds>]

ローカルのOracleインスタンス用のOPMNおよびシステム・プロセスを起動する場合は、このコマンドを実行します。startallは、引数を指定しないstartコマンドおよびstartprocコマンドと同じです。startコマンドまたはstartprocコマンドの使用をお薦めします。

このコマンドは同期的に動作し、操作が完了するまで待機してから制御を戻します。リクエストのタイムアウトを設定する場合は、タイムアウト値を秒単位で指定します。

id-matching="true"が構成されているコンポーネントは起動されません。

さらに詳細な情報を取得するには、次のコマンドを入力します。

opmnctl usage startall

Microsoft Windowsでは、opmnctl startallを実行するかわりに、Windowsサービスのコントロール パネルでOracle<OracleHomename>ProcessManagerサービスを開始することもできます。Oracle<OracleHomename>ProcessManagerは、コンピュータを起動または再起動すると自動的に開始します。

4.3.2.4 opmnctl stopall

構文: opmnctl stopall

ローカルのOracleインスタンスに対してOPMNサーバーとシステム・プロセスをシャットダウンする場合は、opmnctl stopallコマンドを実行します。このリクエストは同期的に動作し、操作が完了するまで待機してから制御を戻します。

通常の動作では、OPMNサーバーをシャットダウンする必要はありません。OPMNサーバーをシャットダウンすると、再起動するまでOPMNに対するリモート・コマンドをOracleインスタンスで実行できません。

opmnctl stopallコマンドは、OPMNとコンピュータをシャットダウンする前にのみ実行してください。このリクエストは最初に、すべてのシステム・コンポーネントを正常に停止しようとします。正常に停止しないプロセスは、強制的に停止されます。すべての管理対象プロセスの停止後に、OPMNデーモン自体が停止されます。

opmnctl stopallコマンドは、緊急時にOPMNデーモンの速やかな停止が必要な場合にのみ使用してください。OPMNデーモンは、いったん起動したら、コンピュータの再起動が必要になったり、他の予期しない管理イベントが発生したりするまで、稼働状態にしておいてください。OPMNデーモンを停止することなく、すべてのシステム・コンポーネントを停止するには、引数を指定しないでopmnctl stopprocコマンドを実行します。システム・コンポーネントを再起動することなくOPMNデーモンを再起動するには、opmnctl reloadコマンドを実行します。opmnctl reloadコマンドの使用は、新しい構成でOPMNデーモンを再起動することのみが目的の場合に適しています。

すべてのシステム・プロセスを停止するには、opmnctl stopprocコマンドを実行してください。

OPMNに構成を再度読み込ませるには、opmnctl reloadコマンドを実行してください。

付加情報を取得するには、次のいずれかのコマンドを入力します。

opmnctl usage stopall

または

opmnctl usage shutdown

4.3.2.5 opmnctl shutdown

構文: opmnctl shutdown

ローカルのOracleインスタンスに対してOPMNサーバーとシステム・プロセスをシャットダウンする場合は、opmnctl shutdownコマンドを実行します。

opmnctl shutdownコマンドは、ローカルのOracleインスタンスに対してOPMNデーモンとシステム・コンポーネントを迅速に停止します。opmnctl shutdownコマンドは、opmnctl stopallコマンドと似ていますが、より短い待機時間でシステム・コンポーネントの強制終了を開始します。すべてのシステム・コンポーネントの停止後に、OPMNデーモン自体が停止されます。

opmnctl shutdownコマンドは、OPMNデーモンの停止が必要な場合にのみ実行してください。OPMNデーモンは、いったん起動したら、コンピュータの再起動が必要になったり、他の予期しない管理イベントが発生したりするまで、稼働状態にしておいてください。OPMNデーモンを停止することなく、すべてのシステム・コンポーネントを停止するには、引数を指定しないでopmnctl stopprocコマンドを実行します。システム・コンポーネントを再起動することなくOPMNデーモンを再起動するには、opmnctl reloadコマンドを実行します。opmnctl reloadコマンドの使用は、新しい構成でOPMNデーモンを再起動することが目的の場合に適しています。

Microsoft Windowsでは、opmnctl shutdownを実行するかわりに、「コントロール パネル」のWindowsサービスでOracle<OracleHomename>ProcessManagerサービスを停止することもできます。

すべてのシステム・コンポーネント・プロセスを停止するには、opmnctl stopprocコマンドを実行してください。

OPMNに構成を再度読み込ませるには、opmnctl reloadコマンドを実行してください。

付加情報を取得するには、次のいずれかのコマンドを入力します。

opmnctl usage stopall

または

opmnctl usage shutdown

4.3.2.6 opmnctl reload

構文: opmnctl reload

OPMNに、その構成ファイルを再度読み込ませるには、このコマンドを実行します。このコマンドは、OPMNが管理するシステム・プロセスを再起動せずにOPMNサーバーを再起動します。OracleインスタンスのOPMNサーバーが稼働している必要があります。

注意:
Microsoft Windowsでは、「コントロール パネル」のサービスでOracle<OracleHomename>ProcessManagerを選択して「再起動」を選択できます。ただし、サービスの再起動はopmnctl reloadの実行とは異なります。この操作は、opmnctl shutdownに続けてopmnctl startallを実行した場合と同じです。サービスの再起動では、OPMNと、OPMNが管理するすべてのプロセスが再起動されるため、opmnctl reloadを実行した場合より処理にはるかに時間がかかります。

さらに詳細な情報を取得するには、次のコマンドを入力します。

opmnctl usage reload

関連項目:
OPMNコマンドの定義は、第4.3.1項を参照してください。

4.3.3 プロセス制御コマンド

opmnctlのプロセス制御コマンドを実行すると、1つまたは複数のシステム・コンポーネントを起動、停止または再起動できます。システム・コンポーネントを<ias-component>、<process-set>または<process-type>レベルで制御できます。

この項では、opmnctlで実行できるプロセス制御コマンドについて説明します。プロセス制御コマンドには、次のものがあります。

- opmnctl startproc、opmnctl restartprocおよびopmnctl stopproc

- 斬新なリクエスト・レポート

- 順次リクエスト

opmnctlのプロセス制御コマンドが正常に実行された場合、出力は生成されません。opmnctlコマンドの実行時にエラー・メッセージが出力された場合は、付録Bを参照してください。

4.3.3.1 opmnctl startproc、opmnctl restartprocおよびopmnctl stopproc

構文: opmnctl startproc [<attr>=<value>...]

opmnctl restartproc [<attr>=<value>...]

opmnctl stopproc [<attr>=<value>...]

システム・プロセスを起動、再起動または停止する場合は、これらのコマンドを実行します。OracleインスタンスのOPMNサーバーが稼働している必要があります。

これらのコマンドでは属性を使用できます。startproc、stopprocおよびrestartprocの実行時に属性を指定しない場合、opmn.xmlファイルでid-matching="true"が指定されているコンポーネントを除く、すべてのシステム・プロセスが起動されます。

次の属性および値は、startproc、stopprocおよびrestartprocコマンドで使用できます。

- ias-component、process-typeおよびprocess-set: これらの属性値は、opmn.xmlファイルで指定したid値と一致する必要があります。属性を指定しない場合、このコマンドはopmn.xmlファイルでid-matching="true"が構成されているプロセスを除く、すべてのシステム・コンポーネント・プロセスに適用されます。id-matching="true"が構成されているコンポーネントでこのコマンドを実行するには、ias-component引数を指定する必要があります。

- mode: mode属性の値には syncまたはasyncを指定できます。デフォルト値はsyncです。modeの値にsyncを指定すると、opmnctlコマンドは同期的に動作し、コマンドの実行が完了するまで待機してから制御を戻してプロンプトを表示します。modeの値がsyncの場合のみ、タイムアウト要素を指定できます。値は秒単位で指定します。指定したタイムアウトが経過すると、startprocの操作は中断されますが、restartprocおよびstopprocの操作は中断されません。opmnctlコマンドのプロンプトは戻りますが、OPMNサーバーはopmnctl restartprocまたはstopprocコマンドのリクエストを操作が完了するまで実行します。
modeの値にasyncを指定すると、すぐにプロンプトが表示されますが、OPMNサーバーはopmnctlコマンドのリクエストを操作が完了するまで実行します。

- uniqueid: これは、OPMNによって起動後に割り当てられる値です。restartprocおよびstopprocコマンドを実行する場合に、この値を使用できます。この値を取得するには、次のコマンドを実行します。生成される出力のuid列に、システム・コンポーネントの一意の番号が表示されます。

opmnctl status -l

OPMNが管理するいくつかのタイプのシステム・プロセスでは、一覧にない属性名が指定される場合もあります。各タイプのシステム・プロセスには、一意の属性名を指定する必要があります。

opmnctl startproc、restartprocまたはstopprocコマンドと属性を使用すると、Oracleインスタンス内の特定のプロセスを制御できます。opmnctl startproc、restartprocまたはstopprocコマンドは、<ias-component>、<process-type>および<process-set>レベルで実行できます。

次のコマンドを実行すると、<process-type>レベルでOracle Web Cacheが再起動します。

opmnctl restartproc ias-component=webcache1 process-type=WebCache

次のコマンドを実行すると、<ias-component>レベルでOracle HTTP Serverが停止します。

opmnctl stopproc ias-component=ohs1

付加情報を取得するには、次のいずれかのコマンドを入力します。

opmnctl usage startproc

または

opmnctl usage restartproc

または

opmnctl usage stopproc

関連項目:

- OPMNコマンドの定義は、第4.3.1項を参照してください。

- OPMNコマンドラインの例は、第5章を参照してください。

4.3.3.2 漸進的なリクエスト・レポート

startproc、restartprocまたはstopprocでreport=true属性を使用すると、リクエストの各部分が完了するたびに、その部分についてOPMNにレポートさせることができます。たとえば、opmnctl startprocリクエストで4つのプロセスの開始を試みる場合、個々のプロセスの開始が完了すると、ただちにそのプロセスの開始結果がOPMNによってユーザーにレポートされます。

4.3.3.3 順次リクエスト

デフォルトでは、依存性によって特定の順序が指定されている場合を除き、OPMNリクエストはすべての対象プロセスに対して同時に実行されます。startproc、restartprocまたはstopprocコマンドで属性sequential=trueを指定した場合、OPMNは一度に1つのプロセスに対してのみリクエストを実行し、最初のプロセスでリクエストが完了するまで、次のプロセスではリクエストを実行しません。1つのプロセスでリクエストが完了すると、次のプロセスに進みます。

この場合も依存性は有効であり、リクエストに順番に組み込まれることに注意してください。

図4-1に示すように、デフォルトでは、OPMNはすべてのプロセスに対してジョブを並列に発行し、各プロセスでジョブが同時に実行されるようにします（依存性が有効な場合を除く）。次にコマンドの例を示します。

> opmnctl startproc

図4-1 並列のプロセス

「図4-1 並列のプロセス」の説明

sequential属性をtrueに設定した場合、OPMNは一度に1つのプロセスに対してのみリクエストを実行します（図4-2を参照）。

次にコマンドの例を示します。

% opmnctl startproc sequential=true

この場合、すべての管理対象のシステム・プロセスが順番に起動します。

図4-2 管理対象プロセスの順次リクエスト-1

「図4-2 管理対象プロセスの順次リクエスト-1」の説明

OPMNは1つの管理対象プロセスを処理しています。その後、図4-3に示す次のプロセスに移ります。

図4-3に示すように、最初の管理対象プロセスに対してリクエストが完了すると、次の管理対象プロセスでリクエストが開始されます。

図4-3 管理対象プロセスの順次リクエスト-2

「図4-3 管理対象プロセスの順次リクエスト-2」の説明

図4-4に示すように、対象となるすべての管理対象プロセスでリクエストが完了しました。

図4-4 管理対象プロセスの順次リクエスト-3

「図4-4 管理対象プロセスの順次リクエスト-3」の説明

4.3.4 プロビジョニング・コマンド

opmnctlプロビジョニング・コマンドは、Oracleインスタンス内のプロビジョニング・システム・コンポーネントに対して使用されます。これらのコマンドを使用して、次の操作を実行します。

- Oracleインスタンスまたはシステム・コンポーネントの作成と削除

- Fusion Middleware Controlコンソールを使用して管理されるWebLogicドメインでのOracleインスタンスの登録と登録解除

- WebLogicドメインでのOracleインスタンスの更新またはシステム・コンポーネントの登録の更新

注意:
opmnctlプロビジョニング・コマンドでは、次のネーミング規則を使用する必要があります。

1. 名前の先頭は文字でなければなりません。名前には英数字、ハイフン（-）およびアンダースコア（_）のみを使用できます。

2. 名前は30文字以内にする必要があります。

3. 名前は4文字以上にする必要があります。

この項の項目は次のとおりです。

- 一般的な構文

- プロビジョニング・コマンドの代替構文

- 一般的な引数

- コマンド

4.3.4.1 一般的な構文

opmnctlプロビジョニング・コマンドは、次の構文を使用して起動されます。

opmnctl  command  [-argName1  value1]  [-argName2  value2]  ...

次のプロビジョニング・コマンドがサポートされています。

- createinstance

- createcomponent

- deleteinstance

- deletecomponent

- registerinstance

- unregisterinstance

- updateinstanceregistration

- updatecomponentregistration

4.3.4.2 プロビジョニング・コマンドの代替構文

プロビジョニング・コマンドは、他のopmnctlコマンドで使用される次の構文によって起動することもできます。

opmnctl command [argName1=value1] [argName2=value2] ...

この代替構文は、属性形式（第4.3.1.2項を参照）に従い、小文字で指定された引数名を受け入れます。代替構文を使用すると、opmnctlコマンド内で統一化を図ることができます。

すべてのopmnctlプロビジョニング・コマンドで、入力時にどちらの構文も使用できます。

たとえば、次のコマンドは同等になります。

opmnctl createcomponent -componentType OHS -componentName ohs1
opmnctl createcomponent componenttype=OHS componentname=ohs1

同じコマンド内で両方の構文形式を組み合せることができます。

4.3.4.3 一般的な引数

コンポーネント関連のコマンドにのみ適用されるコンポーネント固有の引数を除いて、通常、次の引数がすべてのプロビジョニング・コマンドに適用されます。

- 管理サーバーの引数

- ロギングの引数

- Oracleインスタンスの引数

- コンポーネント固有の引数

4.3.4.3.1 管理サーバーの引数

管理サーバー（Adminserver）の引数は、opmnctlがOracle WebLogic Serverドメインの管理サーバーと通信する方法を表します。

管理サーバーの値は、後続のコマンドのデフォルト値としてOracleインスタンスに保存されています。opmnctlは、登録されていないOracleインスタンスに対して管理サーバーの値を使用したり要求したりしません。登録されていないインスタンスを作成するためのcreateinstanceコマンドの詳細は、第4.3.4.4.1項を参照してください。

管理サーバーの引数は次のとおりです。

- -adminHost: Weblogic管理サーバー・ホスト。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンド、またはローカル・ホストです。

- -adminPort: Weblogic管理サーバー・ポート。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンド、または7001です。

- -adminProtocol: Weblogic管理サーバー・プロトコル。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンド、または3です。

- -adminUsername: Weblogic管理サーバー・ログイン・ユーザー名。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンドです。成功したコマンドがない場合、ログイン・ユーザー名の入力を求めるプロンプトが表示されます。

- -adminPasswordFile: 管理ユーザー（admin user）のパスワードが記載されたファイルの場所。デフォルト値は、Oracleインスタンスに対して最後に成功したコマンドです。成功したコマンドがない場合、管理ユーザーのパスワードの入力を求めるプロンプトが表示されます。

4.3.4.3.2 ロギングの引数

デフォルトでは、opmnctlは、ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/provision.logファイル内のプロビジョニング・エラーおよび例外の詳細を記録します。createinstanceコマンドを実行する際の特定のエラーでは、特にprovision.logファイルが作成されていない場合、例外の詳細がコンソールに表示されます。ログ・ファイルの場所は、-logFile引数を使用して指定できます。

- -logFile: プロビジョニング・ログ・ファイルの場所。

- -logLevel: プロビジョニング・ログのロギング・レベル。たとえば、INFOまたはFINERのように記述します。

4.3.4.3.3 Oracleインスタンスの引数

-oracleInstance引数および-instanceName引数は主に、createinstanceコマンドで使用されます。Oracleインスタンスを作成すると、ORACLE_INSTANCE/bin/opmnctlディレクトリにデフォルトのOracleインスタンス・ホームが作成されます。Oracleインスタンスの名前は、自動的に決まります。

Oracleインスタンスの引数は次のとおりです。

- -oracleInstance: Oracleインスタンスのルート・ディレクトリ。このディレクトリは、opmnctlコマンドがOracleインスタンス・ホームから実行されなかった場合にのみ必要です。

- -instanceName: このコマンド・オプションは、Oracleインスタンスの作成時にOracleインスタンス名を割り当てたり、Oracleインスタンス名を後から検証する際に使用されます。

createinstanceコマンドは、instanceNameが直接入力されていない場合、-oracleInstanceの最後のディレクトリ名がOracleインスタンス名として使用されます。

4.3.4.3.4 コンポーネント固有の引数

単一コンポーネントを対象にしたコマンドは、コンポーネント・タイプ固有の引数を受け入れることができます。たとえば、-wcAdminPasswordFile引数は、Oracle Web Cacheコンポーネント作成時には受け入れられますが、OHSコンポーネント作成時には受け入れられません。

これらの引数は、構文的にはオプションですが、適切な構成のためには理解する必要があります。

これらの特定の引数およびその使用法の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

システム・コンポーネントに適用できる引数の一覧は、opmnctl usageコマンドの実行時にコンポーネント・タイプを入力すると表示されます。

次に例を示します。

opmnctl usage createcomponent -componentType OHS

4.3.4.4 コマンド

この項では、一連のcreateコマンドについて説明します。次の項で構成されています。

- createinstance

- createcomponent

- deleteinstance

- deletecomponent

- registerinstance

- unregisterinstance

- updateinstanceregistration

- updatecomponentregistration

4.3.4.4.1 createinstance

createinstanceコマンドは、Oracleインスタンスを作成して登録します。次の引数が使用されます。

- 管理サーバー

- ロギング

- Oracleインスタンス

- -adminRegistration: 作成されたOracleインスタンスの登録ステータス。サポートされる値は、ON（登録済）およびOFF（未登録）です。デフォルト値はONです。

- -opmnRemoteHost: OPMNのリモート・ホスト。デフォルト値は、コンピュータの正規ホスト名です。

- -opmnLocalPort: OPMNのローカル・ポート値。デフォルト・ポート値は6700です（ポートが使用可能な場合）。

- -opmnRemotePort: OPMNのリモート・ポート値。デフォルト・ポート値は6701です（ポートが使用可能な場合）。

次に例を示します。

opmnctl createinstance -oracleInstance /foo/bar/inst1 -adminHost myadminserver -adminPort 7001

または

opmnctl createinstance -oracleInstance /foo/bar/inst1 -adminRegistration OFF

4.3.4.4.2 createcomponent

createcomponentコマンドは、Oracleインスタンス内にコンポーネントを作成します。作成されたコンポーネントは、登録状態についてはOracleインスタンスと一致します。

createcomponentコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

- コンポーネント固有の引数

- -componentType: システム・コンポーネント・タイプ

- -componentName: システム・コンポーネント名

次に例を示します。

opmnctl createcomponent -componentType OHS -componentName ohs1 -proxyPort 8888

それぞれのシステム・コンポーネントで、構成に使用できる別々の引数のセットが用意されている点に注意してください。上のコマンド例では、-proxyPortの使用はOHSコンポーネント固有です。コンポーネント固有の引数の詳細は、第4.3.4.3.4項を参照してください。

4.3.4.4.3 deleteinstance

deleteinstanceコマンドは、Oracleインスタンスを削除し、Oracleインスタンスと関連のシステム・コンポーネントの登録を解除します。Oracleインスタンスが正常に削除されると、デフォルトのprovision.logファイルを除く、すべてのOracleインスタンスのファイルが削除されます。

次に例を示します。

opmnctl deleteinstance

deleteinstanceコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

- -force: -force引数は、Oracleインスタンス内の矛盾とは関係なく、強制的にopmnctl deleteinstanceコマンドを続行します。このコマンドは、値がtrueの場合のみ有効です。デフォルト値はfalseです。
-forceオプションは、大半の検証前のチェックを回避することに注意してください。したがって、-forceオプションは注意して使用するようにお薦めします。「deleteinstanceの-forceオプション」に例を示します。

deleteinstanceの-forceオプション

deleteinstanceコマンドは、オプション-force trueがコマンドに含まれている場合、強制モードで動作します。このオプションを使用すると、Oracleインスタンスで検出された警告やエラーとは関係なく、opmnctlに操作を続行するように指示します。Oracleインスタンスが不適切かつ応答不能な状態である可能性があるため、Oracleインスタンスに関連付けられている適切な（-instanceName、-adminHost、-adminPortなどの）オプション値を明示的に入力し、正しい値が使用されていることを確認することをお薦めします。

クリーンアップ実行時、forceオプションを使用したdeleteinstanceコマンドにより、Oracleインスタンスの破損状態に応じた警告や例外が表示されます。これらの警告や例外は、検出された不一致に対する視覚的なフィードバックとして表示されるものであり、さらに修正処置が必要であることを必ずしも示しているわけではありません。

次に例を示します。

opmnctl deleteinstance -force true -instanceName instance1 -adminHost myadminserver -adminPort 7001

または

opmnctl deleteinstance -force true -instanceName instance1

4.3.4.4.4 deletecomponent

deletecomponentコマンドは、システム・コンポーネントを削除します。

deletecomponentコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

- -componentName: システム・コンポーネント名

次に例を示します。

opmnctl deletecomponent -componentName ohs1

4.3.4.4.5 registerinstance

registerinstanceコマンドは、Oracleインスタンスを登録済の状態に切替え、管理サーバーの値を更新します。

registerinstanceコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

次に例を示します。

opmnctl registerinstance -adminHost myhostname -adminPort 8000

4.3.4.4.6 unregisterinstance

unregisterinstanceコマンドは、Oracleインスタンスを未登録状態に切替え、管理サーバーの値を更新します。

次に例を示します。

opmnctl unregisterinstance

unregisterinstanceコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

- -force: Oracleインスタンス内の矛盾とは関係なく、opmnctlのunregisterinstanceコマンドに続行するように指示します。このオプションは、値がtrueの場合のみ有効です。デフォルト値はfalseです。
-forceオプションは、大半の検証前のチェックを回避することに注意してください。したがって、-forceオプションは注意して使用するようにお薦めします。「unregisterinstanceの-forceオプション」に例を示します。

unregisterinstanceの-forceオプション

unregisterinstanceコマンドは、オプション-force trueが含まれている場合、強制モードで動作できます。

このオプションは、Oracleインスタンスを登録解除するようにopmnctlのunregisterinstanceに指示しますが、変更の範囲を管理サーバーに限定します。つまり、評価したりOracleインスタンスとやり取りしたりせず（オプションでprovision.logファイルに書き込む場合を除いて）、Oracleインスタンス名を管理サーバーから登録解除します。

このモードにより、簡単に登録の関連付けを解除できます。たとえば、このコマンドを登録されている運用Oracleインスタンスの名前で実行すると、管理サーバーとOracleインスタンスが同期しなくなります。その後、管理サーバーがOracleインスタンスや関連のシステム・コンポーネントを一覧表示しなくなります。ただし、この例では、Oracleインスタンスはこの時点でも登録済として構成されていますが、大半のプロビジョニング・コマンドは失敗します。したがって、-forceオプションは注意して使用するようにお薦めします。

次に例を示します。

opmnctl unregisterinstance -force true -instanceName instance1 -adminHost myadminserver -adminPort 7001

4.3.4.4.7 updateinstanceregistration

updateinstanceregistrationコマンドは、管理サーバーに登録された、Oracleインスタンスの情報を更新します。特に、updateinstanceregistrationコマンドは、登録されたOPMNリモート・ポート、OPMNリモート・ホストおよびOPMNウォレットを現在のOPMN設定から更新します。

updateinstanceregistrationコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

次に例を示します。

opmnctl updateinstanceregistration

4.3.4.4.8 updatecomponentregistration

updatecomponentregistrationコマンドは、管理サーバーに登録された、サブジェクト・システム・コンポーネントの設定を更新します。これらの設定には、コンポーネント・プロキシ・ポート、コンポーネント・プロキシ・ウォレット、コンポーネントmbeanプロパティおよびFusion Middleware Controlコンソールのコンポーネント・プロパティ、さらにコンポーネントのタイプに固有のその他の値が含まれています。

updatecomponentregistrationコマンドは、次の引数を使用します。

- 管理サーバー

- ロギング

- Oracleインスタンス

- コンポーネント固有の引数

- -componentName: システム・コンポーネント名

次に例を示します。

opmnctl updatecomponentregistration -componentName ohs1 -proxyPort 8889 ....

4.3.5 ステータス・コマンド

opmnctl statusコマンドを実行すると、システム・コンポーネント・プロセスのステータスを確認できます。

この項では、opmnctlコマンドで使用できるコマンド・オプションについて説明します。次の項で構成されています。

- opmnctl status

- opmnctl metric

- opmnctl dmsdump

- opmnctl ping

- opmnctl set

- opmnctl query

関連項目:

- 属性の詳細は、第4.3.1.2項を参照してください。

- opmnctlのstatusコマンドのオプションの詳細は、第4.3.5.1.1章を参照してください。

- opmnctl status -portコマンドの詳細は、第4.3.5.1.2項を参照してください。

4.3.5.1 opmnctl status

構文: opmnctl status [<options>]

statusコマンドを使用すると、OPMNが管理するシステム・プロセスに関する情報を取得できます。

出力はテキストの表で表示されます。表の各行が1つのシステム・プロセスを表します。

次のようにステータス・コマンドをカスタマイズできます。

- 各システム・プロセスについて表示される情報を変更する。

- 出力から表のヘッダーを削除する。

- フィールド区切り値を変更する。

- レコード区切り値を変更する。

- 各列の幅を変更する。

- 各列のデータの位置揃えを変更する。

opmnctl usage statusコマンドを実行すると、ステータス・コマンドの使用方法の詳細を取得できます。

例4-3「opmctl statusの出力」に、ドメインyourcompany.comのホストcomp1のAppSrv1インスタンスに対してopmnctl statusコマンドを実行した場合の出力を示します。

例4-3 opmctl statusの出力

opmnctl status

Processes in Instance: Instance1
-------------------------+-----------------+--------+---------
Monitor                  | MONITOR         |   6720 | Alive
webcache1                | WebCache-admin  |    N/A | Down
webcache1                | WebCache        |    N/A | Down
ohs1                     | OHS             |   5106 | Alive

4.3.5.1.1 opmnctlのステータス・コマンドのオプション

<options>パラメータには、次のオプションを指定できます。

- -l: uniqueid （uid）値と他の特定のプロセス・パラメータ情報を取得する場合は、このオプションを使用します。

opmnctl status -l

たとえば、このコマンドは例4-4に示す情報を出力します（読みやすくするため、一部の列は省略している）。

例4-4 opmnctl status -lの出力

Processes in Instance: instance1
--------------------+---------------+---------+---------+------------+----------+-----------+------
ias-component       | process-type  |     pid | status  |        uid |  memused |   uptime  | ports
------------------------------------+---------+---------+------------+----------+-----------|------
webcache1           | WebCache-admin|    1544 | Alive   | 1133202830 |   44216  |   0:04:39 | http_
admin:7779
webcache1           | WebCache      |    1545 | Alive   | 1133202829 |   64056  |   0:04:39 | http_
stat:7780,http_invalidation:7781,https_listen:7782,http_listen:7778
ohs1                | OHS           |    1543 | Alive   | 1133202828 |   348664 |   0:04:39 | https
:8889,https:4443,http:8888

uidの情報を基に、個々のOracle Fusion Middlewareプロセスを停止または再起動できます。

たとえば、次のコマンドを実行すると、OHS process-typeが停止します。

opmnctl stopproc uniqueid=1792746301

- -fsep <string>: opmnctl statusの出力にフィールド区切り値を割り当てる場合は、このオプションを使用します。デフォルト値は|です。

- -rsep <string>: opmnctl statusの出力にレコード区切り値を割り当てる場合は、このオプションを使用します。デフォルト値は\nです。

- -noheaders: opmnctl statusコマンドを実行した後にヘッダーを表示しない場合は、このオプションを使用します。

- -fmt <fmtlist>: 次の書式で指定する1つ以上の統計識別子を連結した単一の文字列です。<statname>[<width>{<justification>]。デフォルト値は%cmp18%prt18%pid5R%sta8です。
表4-3に、<fmtlist>オプションで使用する書式指定文字列の構文を示します。

表4-3 書式指定文字列の構文

書式指定文字列の構文

説明

<statname>

次のいずれかを指定します。

- clu: システム・ファーム名

- ins: Oracleインスタンス名

- cmp: システム・コンポーネントID

- prt: process-type ID

- prs: process-set ID

- idx: process-set内のプロセスの索引

- pid: オペレーティング・システムのプロセスID

- uid: OPMN uniqueid

- typ: このプロセスの種類の名前

- sta: プロセスのステータス

- stm: 開始時間（ミリ秒）

- utm: 稼働時間（ミリ秒）

- cpu: CPU時間（ミリ秒）

- mem: 使用メモリー（KB）

- por: ポートのリスト

- fpr: 詳細なポートのリスト

<width>

フィールドのサイズを指定します。出力がこの値より短い場合は、指定した<justification>に従ってパディングが行われます。出力がこの値より長い場合は省略され、末尾に「〜」が表示されます。

デフォルト値: 各データの幅

<justification>

フィールドの行揃えを指定します。出力がフィールド幅より短い場合に出力位置を揃えることができます。L、RまたはC（左揃え、右揃えまたは中央揃え）を指定します。

デフォルト値: L

たとえば、次のコマンドは例4-5に示す出力を表示します。

prompt> opmnctl status -noheaders -fsep @ -fmt %cmp%prt%pid%sta

例4-5 opmnctl status -noheadersの出力

webcache1@WebCache-admin@1544@Alive
webcache1@WebCache@1545@Alive
ohs1@OHS@1543@Alive

関連項目:
コマンドの定義は、第4.3.1項を参照してください。

さらに詳細な情報を取得するには、次のコマンドを入力します。

opmnctl usage status

4.3.5.1.2 opmnctl status -port

opmnctl status -portコマンドでは、OPMNデーモンへの接続に使用されるリクエスト接続文字列を表示できます。たとえば、次のコマンドを実行します。

opmnctl status -port

次の文字列が表示されます。

123.your_company.com:6200

opmnctl status -portコマンドを使用すると、opmn.xmlファイルでリクエスト・アクセス・ポートを確認する必要がなくなるため便利です。

4.3.5.2 opmnctl metric

opmnctl metricコマンドを使用すると、システム・コンポーネント・プロセスのDMS統計を出力できます。opmnctlメトリックには、次のコマンドと引数の構造があります。

opmnctl metric op=<op> [<identifier>=<value>] dmsarg=<dmsargs>]

opmnctlメトリック・コマンドは、次のコマンド引数を使用します。

- op=<op>: <op>がlistまたはqueryのいずれかになる操作を指定します。
list操作では、その他の引数は使用されません。ターゲットOPMNは、DMSメトリックがメトリック・リクエストを介して使用できる管理対象のシステム・プロセスのリストを返します。

query操作では、<identifier>=<value>引数によって修飾された管理対象のプロセスのメトリック・ツリーが返されます（すべての使用可能なプロセスは、識別子の引数が指定されていないことが前提となっています）。

- local=<bool>: trueに設定すると、このオプションではコマンドがローカルのOracleインスタンス内で動作するように限定されます。これは、OPMNが他のOracleインスタンスを検出するように構成されている場合に有用です。

- <identifer>=<value>: どの管理対象のプロセスがDMSメトリックを問い合せるかを指定します。複数の識別子を指定でき、各識別子は、アドレス・プロパティ（リストを含む）を持つ管理対象のプロセスと一致させます。
5つの標準的なプロパティは、次のとおりです。

- PROCESS_UID=<uid>: <uid>はターゲット・プロセスの一意のIDです。この値は、メトリックlist操作、opmnctl statusコマンド、またはOPMN DMSメトリックを表示する際に使用される任意の類似した方法で取得されます。

- PROCESS_UID=0: このプロパティは、常にOPMN自身を指定します。

- INSTANCE_UID=<instance>@<uid>: <instance>はターゲットOracleインスタンスのOracleインスタンス名で、<uid>はOracleインスタンスのターゲット・プロセスに対する一意のIDです。この識別子は、<instance>がローカルのOracleインスタンス名であるか、ファーム内のすべてのOPMNサーバーが相互接続するように構成されている場合にのみ有効です。

- COMPONENT_NAME=<component-name>: <component-name>は、opmn.xmlファイルにおける<ias-component>のidの値です。COMPONENT_NAME=opmnは、常にOPMN自身を指定します。

- COMPONENT_TYPE=<component-type>: <component-type>は、opmn.xmlファイルにおける<ias-component>のタイプの値です。それが定義されていない場合、<process-type>要素のidの値です。COMPONENT_TYPE=OPMNは、常にOPMN自身を指定します。

- dmsarg=<dmsargs>: メトリックの問合せにDMS固有のオプションを指定します。<dmsargs>は単一の引数で、これにはDMS層に対する複数のオプションが含まれます。各オプションは<attr>=<value>形式で、&で区切られています。
たとえば、format=raw、format=xml&name=/ProcessInfoのように記述します。

メトリック・オプションの詳細は、Oracle Fusion Middlewareパフォーマンス・ガイドを参照してください。

4.3.5.3 opmnctl dmsdump

構文: opmnctl dmsdump [<attr>=<value>[&<attr>=<val>...]]

opmnctl dmsdumpコマンドを使用すると、OPMNのOracle Dynamic Monitoring Service（DMS）統計を出力できます。特定のシステム・コンポーネントに対するプロセス制御操作の出力を取得できます。属性を指定しない場合は、システム・コンポーネントに対するすべてのシステム・コンポーネント・プロセスのパフォーマンス・データが出力されます。

DMSでは、1つのパフォーマンス・メトリック、複数のパフォーマンス・メトリックまたはすべてのパフォーマンス・メトリックを監視できます。オプションを使用すると、リクエストしたメトリックをレポートするレポート間隔を指定できます。

複数の<attr>=<value>ペアは、&で区切る必要があります。たとえば、次のopmnctlコマンドを実行します。

opmnctl dmsdump "table=opmn_ons&format=xml"

この場合、ONSに対して収集された統計セットが出力されます。出力には、ONSがリスニングするポートと、ONSが処理した通知数が含まれます。出力は、テキストではなく.xml形式です。テキスト形式で出力を参照する場合は、コマンドラインで&format=xmlを指定しないでください。

DMSパフォーマンス・メトリックの属性と値の詳細は、Oracle Fusion Middlewareパフォーマンス・ガイドを参照してください。

4.3.5.4 opmnctl ping

構文: opmnctl ping [<max_retry>]

opmnctl pingコマンドでは、ローカルのOPMNサーバーに接続してサーバーの操作を検証できます。<max_retry>には、最大再試行回数を指定します。<max_retry>を指定すると、コマンドが正常に終了するか<max_retry>で指定した回数に達するまで、1秒ごとにローカルのOPMNに対してpingが実行されます。

たとえば、次のコマンドを実行します。

opmnctl ping 10

この場合、pingコマンドが正常に終了するまで、OPMNにpingが10回実行されます。

4.3.5.5 opmnctl set

構文: opmnctl set [<attr>=<value> ...]

opmnctl setコマンドでは、OPMNのロギング構成を設定できます。

属性名は、属性値とともに指定する必要があります。このコマンドでは、OPMNに必要な次の属性名を指定する必要があります。

- target: targetの値には、standard.logを表すlog、またはdebug.logを表すdebugを指定します。標準ログは、デフォルトですべての考えられるログ・メッセージが含まれるように構成されているため、その設定を変更しないことをお薦めします。OPMNのトラブルシューティングの詳細は、付録Bを参照してください。

注意:
debug.logファイルの使用は、Oracleサポート・サービスに問い合せた後にのみ有効化してください。Oracleサポート・サービスでは、debug.logファイルを使用して、OPMNの問題のデバッグおよび診断を実行します。debug.logファイル内のメッセージは通常、ユーザーに簡単に理解できるものではありません。

- comp: OPMNの内部コンポーネントおよびサブコンポーネントを指定します。

4.3.5.5.1 comp属性

comp属性の値には、onsまたはpmのいずれかを指定します。また、この属性値として、ons属性またはpm属性の特定のサブコンポーネント・セットを指定することもできます。

compの次の値は、OPMNの内部コンポーネントおよびサブコンポーネントを表します。

- internal: OPMNの共通内部情報を表します。

- ons: OPMNのONSコンポーネント情報を表します。

- pm: OPMNのPMコンポーネント情報を表します。

onsコンポーネントとpmコンポーネントはどちらもサブコンポーネントで構成されます。これらのサブコンポーネントは、構文component[subcomponents]（componentはonsまたはpm）を使用して指定できます。onsとpmを両方とも指定する場合は、opmn.xmlファイル内でそれぞれをセミコロンで区切る必要があります。サブコンポーネントを複数指定する場合は、それぞれのサブコンポーネントをカンマで区切ります。

表4-4 ONSコンポーネントのコード

ONS要素

定義

all

すべてのサブコンポーネント

local

ローカル情報

listener

リスナー情報

discover

検出（サーバーまたはマルチキャスト）情報

servers

ファームに接続されていて現在稼働中のリモート・サーバー

topology

現在のファーム全体のサーバー接続トポロジ

server

リモート・サーバー接続情報

client

クライアント接続情報

connect

全般的な接続情報

subscribe

クライアント・サブスクリプション情報

message

通知の受信および処理情報

deliver

通知配信情報

special

特殊な通知処理

internal

内部リソース情報

secure

SSL操作情報

workers

ワーカー・スレッド

表4-5 PMコンポーネントのコード

PM要素

定義

all

すべてのサブコンポーネント

requests

HTTP（ユーザー）リクエスト

remote

リモートHTTPリクエスト

scheduler

スケジューラ・スレッドおよびリソース情報

monitor

モニター・スレッド情報

workers

ワーカー・スレッド

process

管理対象プロセス

depend

依存性処理

rmd

RMDディレクティブ

fos

サービス・フェイルオーバー情報

internal

内部リソース

schedjobs

周期的にスケジューリングされるジョブ

procjobs

プロセスごとにスケジューリングされるジョブ

fos

サービス・フェイルオーバー処理

dms

DMS処理

modules

process module情報。出力が得られるのは、modLog()（デバッグ・ログの場合はmodDebug）関数をコールするモジュールのみです。modules(module-id)を使用すると、特定のモジュールまたはそのリストを指定できます。複数のmodule-idを指定する場合は、表示するそれぞれのmodule-idをコロンで区切って、modules (module1-id:module2-id)のように指定します。構成され、有効になっているモジュールと一致しないmodule-idは処理されません。

onsおよびpmの各サブコンポーネントには、先頭に否定文字「!」を付けることができます。これにより、そのサブコンポーネントの選択が解除されます。allと指定した後に、特定のサブコンポーネントを否定することによって、そのサブコンポーネントを表示対象から簡単に除外できます。

コンポーネントおよびサブコンポーネントは、検出される順序に従って設定または否定されます。たとえば、次のように指定します。

ons[all,!topology]

この場合、topologyを除く、onsのすべてのサブコンポーネントが設定されます。

ons[!topology,all]

この場合、topologyを含む、onsのすべてのサブコンポーネントが設定されます。

4.3.5.6 opmnctl query

構文: opmnctl query [<attr>=<value> ...]

opmnctl queryコマンドでは、OPMNのロギング構成の問合せを実行できます。

属性名targetは、属性値とともに指定する必要があります。targetの値には、opmn.logファイルを表すlogまたはopmn.dbgファイルを表すdebugのいずれかを指定します。詳細は、第B.2.1項「OPMNログ・ファイル」を参照してください。

4.3.6 ヘルプ・コマンド

opmnctl helpコマンドを使用すると、OPMNに関する追加情報を取得できます。

この項では、opmnctlコマンドで使用できるヘルプ・コマンド・オプションについて説明します。次の項で構成されています。

- 第4.3.6.1項「opmnctl help」

- 第4.3.6.2項「opmnctl usage」

- 第4.3.6.3項「opmnctl validate」

4.3.6.1 opmnctl help

構文: opmnctl help

opmnctlコマンドの構文に関する簡単な説明を出力する場合は、このコマンドを使用します。

例4-6に、opmnctl helpコマンドの出力を示します。

例4-6 opmnctl helpの出力

opmnctl help

usage: opmnctl [verbose] [<scope>] <command> [<options>]

verbose: print detailed execution message if available

Permitted <scope>/<command>/<options> combinations are:

scope      command      options
_________   __________   __________
start                         - Start opmn
startall                      - Start opmn & all managed processes
stopall                       - Stop opmn & all managed processes
shutdown                      - Shutdown opmn & all managed processes
[<scope>]   startproc   [<attr>=<val>..]  - Start system managed processes
[<scope>]   restartproc [<attr>=<val>..]  - Restart managed processes
[<scope>]   stopproc    [<attr>=<val>..]  - Stop managed processes
[<scope>]   reload                        - Trigger opmn to reread opmn.xml
[<scope>]   status      [<options>]       - Get managed process status
[<scope>]   dmsdump     [<attr>=<val>&..] - Get DMS stats
[<scope>}   set         [<attr>=<val> ..] - Set opmn log parameters
[<scope>]   query       [<attr>=<val> ..] - Query opmn log parameters
launch      [<attr>=<val> ..] - Launch a configured target process
phantom     [<attr>=<val> ..] - Register phantom processes
ping        [<max_retry>]     - Ping local opmn
validate    [<filename>]      - Validate the given xml file
config      [<options>]       - Modify the opmn xml file
help                          - Print brief usage description
usage       [<command>]       - Print detailed usage description
createinstance                - Create an Oracle Instance
createcomponent               - Create a specified component
deleteinstance                - Delete an instance and components
deletecomponent               - Delete a specified component
registerinstance              - Register with admin server
unregisterinstance            - Unregister with admin server
updateinstanceregistration    - Update instance registration
updatecomponentregistration   - Update component registration

4.3.6.2 opmnctl usage

構文: opmnctl usage [<command>]

usageコマンドを実行すると、任意の指定されたopmnctlコマンドのヘルプが表示されます。引数のないopmnctl usageコマンドでは、opmnctl helpと同じ情報が表示されます。

次のいずれかのコマンドを指定できます。

- start

- startall

- startproc

- stopall

- stopproc

- restartproc

- reload

- shutdown

- ping

- status

- metric

- dmsdump

- debug

- set

- query

- launch

- phantom

- ping

- validate

- help

- usage

- createinstance

- createcomponent

- deleteinstance

- deletecomponent

- registerinstance

- unregisterinstance

- updateinstanceregistration

- updatecomponentregistration

- help

たとえば、次のコマンドを入力すると、例4-7に示す出力が表示されます。

opmnctl usage stopall

例4-7 opmnctl usage stopallの出力

opmnctl stopall [sequential=true] [report=true]

Stop opmn daemon and managed processes for local Oracle instance.

This request first tries to stop all managed processes gracefully.
Processes which will not stop gracefully will be forcefully shutdown.  After
stopping all managed processes, the opmn daemon will shutdown itself.

This request should only be performed when it is necessary to stop the opmn
daemon.  Once started, the opmn daemon should remain up until it is necessary to
restart the computer or some other rare administrative event occurs.

To stop all managed processes without stopping the opmn daemon, consider
using the stopproc command without any target arguments.

If the value of the sequential attribute is "true", each process will be stopped
upon sequentially (one at a time).

If the value of the report attribute is "true", opmn will report the results of
the attempt to stop each processes as it completes.
The default behavior is for opmn to wait until the entire request has completed
before sending all of the results at once.

To restart the opmn daemon without restarting any managed processes, consider
using the reload command.  The reload command is the appropriate command to
use when the only goal is to restart the opmn daemon with a new configuration.

This request operates synchronously and will wait for the operation to complete
before returning.

4.3.6.3 opmnctl validate

構文: opmnctl validate [<filename>]

opmnctl validateコマンドを実行すると、opmn.xmlファイルのXML構文が検証されます。ORACLE_INSTANCE/bin/opmnctlを使用する場合は、デフォルトのORACLE_INSTANCE/config/OPMN/opmn/opmn.xmlが検証されます。<filename>は、相対パスと絶対パスのどちらでも指定できます。

5 OPMNの使用

この章では、Oracle Fusion Middlewareに対してOPMNを使用する場合のコマンドラインの例を示します。次のトピックで構成されています。

- OPMNの起動

- すべてのシステム・コンポーネントの起動と停止

- 1つのシステム・コンポーネントの起動と停止

- 同じタイプのすべてのシステム・コンポーネントの起動と停止

5.1 OPMNの起動

OPMNは、起動および使用時に、実行中のその他のシステム・コンポーネントに依存しません。ホストの電源投入後可能なかぎり早くOPMNサーバーを起動してください。

他のシステム・コンポーネントを起動せずにOPMNを起動する場合は、次のコマンドを実行します。

opmnctl start

5.2 すべてのシステム・コンポーネントの起動と停止

Oracleインスタンスのすべてのシステム・コンポーネントを起動する場合は、次のコマンドを実行します。

opmnctl startproc

Oracleインスタンスのすべてのシステム・コンポーネントを停止する場合は、次のコマンドを実行します。

opmnctl stopproc

5.3 1つのシステム・コンポーネントの起動と停止

ohs1という名前のシステム・コンポーネントを起動する場合は、次のコマンドを使用します。

opmnctl startproc ias-component=ohs1

ohs1という名前のシステム・コンポーネントを停止する場合は、次のコマンドを使用します。

opmnctl stopproc ias-component=ohs1

5.4 同じタイプのすべてのシステム・コンポーネントの起動と停止

OracleインスタンスのOIDタイプのすべてのシステム・コンポーネントを起動する場合は、次のコマンドを実行します。

opmnctl startproc process-type=OID

OracleインスタンスのOIDタイプのすべてのシステム・コンポーネントを停止する場合は、次のコマンドを実行します。

opmnctl stopproc process-type=OID

6 opmn.xmlの一般的な構成

この章では、OPMN opmn.xmlファイルの要素および属性の一般的な構成例を示し、またそれらの要素および属性について説明します。

この章は、次の項で構成されています。

- opmn.xmlの要素および属性の例

- opmn.xmlの要素および属性の説明

6.1 opmn.xmlの要素および属性の例

例6-1に、opmn.xmlファイル内に記述できる要素と属性のうち、システム・コンポーネントに固有ではないものをすべて示します。

6.1.1 グローバル定義および構文

すべてのパス、モジュール・データ値および環境変数値は、次のグローバル変数を参照できます。これらのグローバル変数は、それぞれのプラットフォーム固有値に展開されます。

表6-1 グローバル変数および定義

グローバル変数

定義

ORACLE_HOME

ORACLE_HOMEへのフルパス

ORACLE_INSTANCE

ORACLE_INSTANCEへのフルパス

:

ライブラリ・パス（またはクラス・パス）の区切り文字（例: Linuxでは:、Microsoft Windowsでは;）

EXE_EXT

実行可能ファイルの拡張子（例: Linuxではなし、Microsoft Windowsでは.exe）

SO_EXT

共有ライブラリの拡張子（例: Linuxでは.so、Microsoft Windowsでは.dll）

SHELL_EXT

シェル・ファイルの拡張子（例: Linuxでは.sh、Microsoft Windowsでは.bat）

上で定義している変数はそれぞれ、LinuxやWindowsの環境変数と同じ構文を使用して参照される必要があります。たとえば、ORACLE_HOME、{ORACLE_HOME}または%ORACLE_HOME%という参照はいずれも、ORACLE_HOMEへのフルパスに変換されます。

OPMNはまた、OPMNが実行されているプラットフォームに基づいて、すべてのパス内、モジュール・データ値内または環境変数値内のパス区切り文字を自動的に変換します。たとえば、/oracle/instances/ias1はLinux上ではこのまま変更されませんが、Microsoft Windows上ではOPMNによって\oracle\instances\ias1に変換されます。

OPMNは、^文字をエスケープ文字として使用して、その後ろに配置された文字のパス区切り文字変換を無効にします。したがって、^/は、解析後の文字列では常に/に変換されます。2つの^文字は1つの^に変換されます。

例6-1 一般的な構成の要素および属性

<opmn>
<log path="path" comp="comp-codes" rotation=-size="kBytes" rotation-hour="HOD"/>
<debug="path" comp="comp-codes" rotation-size="kBytes" rotation-hour="HOD"/>
<notification-server interface="type">
<ipaddr remote="ip; ip" request="ip; ip"/>
<port local="port" remote="port" reqest="port"/>
<ssl enabled="boolean" wallet-file="path" wallet-password="password" openssl-certfile="path"
openssl-keyfile="path open" openssl-password="password" openssl-lib="path"/>

<tune io-timeout="timeout" io-idle="interval" timeout="timeout"/>
</notification-server>
<process-manager insecure-remote-requests="boolean">
<process-modules>
<module path="path" tag="tag-id" status="state" cron="interval">
<module-data>
<category id="id">
<data id="id" value="value" process-conversion="boolean"/>
</category>
</module-data>
<module-id id="module-id"/>
</module>
</process-modules>
<ias-instance="id="ias-instance-name"" name="ias-instance-name"ORACLE_HOME="path">
<environment>
<variable id="id" value="value" append="boolean" process-conversion="boolean"/>
</environment>
<!-- module-data-->
<ias-component id="component-id" id-matching="boolean" status="state">
<!-- environment-->
<!-- module-data-->
<dependencies>
<database db-connect-info="connect" infrastructure-key="key"timeout="depend-timeout"
cache-timeout="cache-timeout"/>
<OID address="address" infrastructure="boolean" timeout="depend-timeout"
cache-timeout="cache-timeout">
<ssl enabled="boolean" wallet-file="path" wallet-password="password">
</OID>
<OSSO host="hostname" port="port" URI="uri" timeout="depend-timeout"
cache-timeout="cache-timeout">
<ssl enabled="boolean" wallet-file="path" wallet-password="password">
</OSSO>
<managed-process ias-instance="ias-instance-id" ias-component="ias-component-id"
process-type="process-type-id" process-set="process-set-id" autostart="boolean"
autostop="boolean" timeout="depend-timeout"cache-timeout="cache-timeout"/>
</dependencies>
<process-type="process-type-id" module-id="module-id" status="state" working-dir="path">
<!-- environment-->
<!-- module-data-->
<!-- dependencies-->
<event-scripts>
<pre-start path="path">
<pre-stop path="path">
<post-crash path="path">
</event-scripts>
<start timeout="timeout" retry="num"/>
<stop timeout="timeout"/>
<restart timeout="timeout" retry="num"/>
<ping timeout="timeout" retry="num" interval="interval"/>
<port id="id" range="range"/>
<process-set id="process-set-id" restart-on-death="boolean" numprocs="num" minprocs="min"
maxprocs="max" status="state" working-dir="path" parallel-requests="boolean">
<!-- environment-->
<!-- module-data-->
<!-- dependencies-->
<!-- event-scripts-->
<!-- start:-->
<!-- stop-->
<!-- restart-->
<!-- ping-->
<!-- port-->
</process-set>
</process-type>
</ias-component>
</ias-instance>
<launch-targets>
<launch-target id="id">
<exec path="path"/>
<argument value="argument"/>
<timeout value="seconds"/>
<max-concurrency value="number"/>
</launch-target>
</launch-targets>
</process-manager>
</opmn>

6.2 opmn.xmlの要素および属性の説明

この項では、システム・コンポーネントに固有ではない、opmn.xmlファイル内の要素と属性について説明します。この項では、さらに、それぞれの要素の属性についても説明します。

opmn

必須: ◎
デフォルト値: なし
親要素: なし
属性: なし

<opmn>は、opmn.xmlファイル内に記述される最上位の要素です。

log

必須: ×
デフォルト値: 「属性」を参照
親属性: <opmn>
属性: path、comp、rotation-size、rotation-hour

OPMNのログ・メカニズムの構成を定義します。

path="path"

必須: ◎
デフォルト値: ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.log
有効値: OPMNログ・ファイルのパス名

comp="comp-codes"

必須: ◎
デフォルト値: internal、ons、pm
有効値: comp-codesのリスト。comp-codesリストの項目は、セミコロンを使用して区切る必要があります。

comp属性では、ロギング対象イベントのコンポーネント・コードを指定します。それらのコードは、次のコマンドを使用して、OPMNのランタイム時に動的に表示したり、変更したりできます。

> opmnctl query target=log
> opmnctl set target=log comp=<comp-codes>

ログのデフォルトcomp-codesにはすでに、すべての考えられるログ・メッセージが含まれているため、その値を変更しないことをお薦めします。

次のcomp-codesが、opmn.xmlファイルのログ要素およびデバッグ要素に表示されます。

- internal: OPMNの共通内部情報のログ

- ons: OPMNのONSコンポーネント情報のログ

- pm: OPMNのPMコンポーネント情報のログ

onsコンポーネントもpmコンポーネントも、component[subcomponents]の構文を使用して指定できるサブコンポーネントから構成されています。指定できるコンポーネントは、onsまたはpm（両方とも指定する場合はセミコロンで区切る）です。コンポーネントの有効なサブコンポーネントのリストは、それぞれカンマで区切ります。たとえば、comp="ons[local,listener];pm"のように指定します。

表6-2に、ONSコンポーネントのコードの一覧を示します。

表6-2 ONSコンポーネントのコード

ONS属性

定義

all

すべてのサブコンポーネント

local

ローカル情報

listener

リスナー情報

discover

検出（サーバーまたはマルチキャスト）情報

servers

ファームに接続されていて現在稼働中のリモート・サーバー

topology

現在のファーム全体のサーバー接続トポロジ

server

リモート・サーバー接続情報

client

クライアント接続情報

connect

全般的な接続情報

subscribe

クライアント・サブスクリプション情報

message

通知の受信および処理情報

deliver

通知配信情報

special

特殊な通知処理

internal

内部リソース情報

secure

SSL操作情報

workers

ワーカー・スレッド

表6-3に、PMコンポーネントのコードの一覧を示します。

表6-3 PMコンポーネントのコード

PM属性

定義

all

すべてのサブコンポーネント

requests

HTTP（ユーザー）リクエスト

remote

リモートHTTPリクエスト

scheduler

スケジューラ・スレッドおよびリソース情報

monitor

モニター・スレッド情報

workers

ワーカー・スレッド

process

管理対象プロセス

depend

依存性処理

internal

内部リソース

schedjobs

周期的にスケジューリングされるジョブ

procjobs

プロセスごとにスケジューリングされるジョブ

dms

DMS処理

modules

process module情報。出力が得られるのは、modLog()（デバッグ・ログの場合はmodDebug）関数をコールするモジュールのみです。modules(module-id)を使用すると、特定のモジュールまたはそのリストを指定できます。複数のmodule-idを指定する場合は、表示するそれぞれのmodule-idをコロンで区切って、modules (module1-id:module2-id)のように指定します。構成され、有効になっているモジュールと一致しないmodule-idは処理されません。

onsまたはpmの各サブコンポーネントには、先頭に否定文字!を付けることができます。これにより、そのサブコンポーネントの選択が解除されます。allと指定した後に、特定のサブコンポーネントを否定することによって、そのサブコンポーネントを表示対象から除外できます。

コンポーネントおよびサブコンポーネントは、検出される順序に従って設定または否定されます。ons[all,!topology]と指定すると、topologyを除くonsのすべてのサブコンポーネントが設定されます。一方、ons[!topology,all]と指定すると、topologyを含むonsのすべてのサブコンポーネントが設定されます。

rotation-size="kBytes"

必須: ×
デフォルト値: なし
有効値: 整数

rotation-sizeは、ログ・ファイルの最大サイズ（KB単位）です。ログ・ファイルのサイズが構成された値に達すると、OPMNのロギング・メカニズムによりログが閉じられ、そのログの名前がタイムスタンプを接尾辞とする名前に変更されて、新しいログ・ファイルが作成されます。この属性は、rotation-hourとともに使用できます。

rotation-hour="HOD"

必須: ×
デフォルト値: なし
有効値: 0〜23の整数値

指定した時刻になると、OPMNのロギング・メカニズムによりログが閉じられ、そのログの名前がタイムスタンプを接尾辞とする名前に変更されて、新しいログ・ファイルが作成されます。この属性は、rotation-sizeとともに使用できます。

debug

必須: ×
デフォルト値: 「属性」を参照
親属性: <opmn>
属性: path、comp、rotation-size、rotation-hour

debug要素には、OPMNデバッグ・ログ・メカニズムの構成定義が入ります。

注意:
opmn.debugファイルの使用を有効化する前に、Oracleサポート・サービスにお問い合せください。Oracleサポート・サービスでは、opmn.debugファイルを使用してOPMNの問題のデバッグおよび診断を実行します。opmn.debugファイル内のメッセージは通常、ユーザーに簡単に理解できるものではありません。

path="path"

必須: ◎
デフォルト値: ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.log
有効値: OPMNデバッグ・ログ・ファイルのパス名

comp="comp-codes"

必須: ◎
デフォルト値: なし
有効値: comp-codesのリスト。comp-codesリストの項目は、セミコロンを使用して区切る必要があります。

comp属性では、ロギング対象イベントのコンポーネント・コードを指定します。それらのコードは、次のコマンドを使用して、OPMNのランタイム時に動的に表示したり、変更したりできます。

> opmnctl query target=log
> opmnctl set target=log comp=<comp-codes>

OPMNをリロードすると、opmn.xmlファイル内の構成値に戻されます。

次のcomp-codesが、opmn.xmlファイルのログ要素およびデバッグ要素に表示されます。

- internal: OPMNの共通内部情報のログ

- ons: OPMNのONSコンポーネント情報のログ

- pm: OPMNのPMコンポーネント情報のログ

onsコンポーネントもpmコンポーネントも、component[subcomponents]の構文を使用して指定できるサブコンポーネントから構成されています。指定できるコンポーネントは、onsまたはpm（両方とも指定する場合はセミコロンで区切る）です。コンポーネントの有効なサブコンポーネントのリストは、それぞれカンマで区切ります。たとえば、comp="ons[local,listener];pm"のように指定します。

表6-4に、ONSコンポーネントのコードの一覧を示します。

表6-4 ONSコンポーネントのコード

ONS属性

定義

all

すべてのサブコンポーネント

local

ローカル情報

listener

リスナー情報

discover

検出（サーバーまたはマルチキャスト）情報

servers

ファームに接続されていて現在稼働中のリモート・サーバー

topology

現在のファーム全体のサーバー接続トポロジ

server

リモート・サーバー接続情報

client

クライアント接続情報

connect

全般的な接続情報

subscribe

クライアント・サブスクリプション情報

message

通知の受信および処理情報

deliver

通知配信情報

special

特殊な通知処理

internal

内部リソース情報

secure

SSL操作情報

workers

ワーカー・スレッド

表6-5に、PMコンポーネントのコードの一覧を示します。

表6-5 PMコンポーネントのコード

PM属性

定義

all

すべてのサブコンポーネント

requests

HTTP（ユーザー）リクエスト

remote

リモートHTTPリクエスト

scheduler

スケジューラ・スレッドおよびリソース情報

monitor

モニター・スレッド情報

workers

ワーカー・スレッド

process

管理対象プロセス

depend

依存性処理

internal

内部リソース

schedjobs

周期的にスケジューリングされるジョブ

procjobs

プロセスごとにスケジューリングされるジョブ

dms

DMS処理

modules

process module情報。出力が得られるのは、modLog()（デバッグ・ログの場合はmodDebug）関数をコールするモジュールのみです。modules(module-id)を使用すると、特定のモジュールまたはそのリストを指定できます。複数のmodule-idを指定する場合は、表示するそれぞれのmodule-idをコロンで区切って、modules (module1-id:module2-id)のように指定します。構成され、有効になっているモジュールと一致しないmodule-idは処理されません。

onsまたはpmの各サブコンポーネントには、先頭に否定文字!を付けることができます。これにより、そのサブコンポーネントの選択が解除されます。allと指定した後に、特定のサブコンポーネントを否定することによって、そのサブコンポーネントを表示対象から除外できます。

コンポーネントおよびサブコンポーネントは、検出される順序に従って設定または否定されます。ons[all,!topology]と指定すると、topologyを除くonsのすべてのサブコンポーネントが設定されます。一方、ons[!topology,all]と指定すると、topologyを含むonsのすべてのサブコンポーネントが設定されます。

rotation-size="kBytes"

必須: ×
デフォルト値: なし
有効値: 整数

rotation-sizeは、ログ・ファイルの最大サイズ（KB単位）です。ログ・ファイルのサイズが構成された値に達すると、OPMNのロギング・メカニズムによりログが閉じられ、そのログの名前がタイムスタンプを接尾辞とする名前に変更されて、新しいログ・ファイルが作成されます。

rotation-size属性は、rotation-hour属性とともに使用できます。

rotation-hour="HOD"

必須: ×
デフォルト値: なし
有効値: 0〜23の整数値

ログ・ファイルで使用されるrotation-hour属性は、指定した時刻になると、OPMNのロギング・メカニズムによりログ・ファイルが閉じられ、そのログの名前がタイムスタンプを接尾辞とする名前に変更されて、新しいログ・ファイルが作成されます。この属性は、rotation-size属性とともに使用できます。

notification-server

必須: ◎
デフォルト値: なし
親要素: <opmn>
属性: interface

notification-server要素は、OPMNのONS部分を構成する要素を構成するか、またはその要素を含みます。

interface="type"

必須: ×
デフォルト値: 任意
有効値: 任意、IPv6またはIPv4

OPMNは、デフォルトでIPv6とIPv4の両方のネットワーク・インタフェースをサポートしています（IPv6のサポートの詳細は第3.5項を参照）。OPMNは、リスナー・ポートを両方のインタフェースにバインドし、いずれかのインタフェースを使用して接続を試みます。アドレスが使用可能な場合、OPMNは常にIPv6インタフェースを最初に使用することを試みます。これは、Sun社のJava仮想マシン（JVM）のデフォルトの動作と同じです。

他のOPMNサーバーへ接続する場合は、IPv4とIPv6の両方で同じネットワークを使用する必要があります。たとえば、IPv4インタフェースが使用可能であっても、IPv6によってIPv6ネットワーク・インタフェースのみが強制的に使用されます。したがって、OPMNは、同じネットワーク・インタフェースを使用する他のOPMNサーバーとの間でのみ接続が可能です。同じネットワーク・インタフェースのサポートを提供していないシステムにIPv4またはIPv6を構成すると、OPMNは起動しません。

ipaddr

必須: ◎
デフォルト値: なし
親要素: <notification-server>
属性: remote、request

iapddr要素には、ONSリスナー・スレッドおよびホスト・ポートのバインドに使用するホスト情報を指定します。

remote="ip; ip"

必須: ×
デフォルト値: なし
有効値: ONSが自身のリモート・ポートをバインドするIPアドレス（IPv4またはIPv6の形式で指定）またはホスト名。ONSを強制的に特定のIPアドレスのセットにバインドするように、IP値のリストを構成できます。リスト内の各IP値は、セミコロンで区切る必要があります。

remote属性には、ONSが自身のリモート・ポートをバインドするIPアドレスまたはホスト名を指定します。リモート・ポートは、ONS間の通信に使用されます。ONS間の通知の送受信はリモート・ポートを介して行われ、またOPMNは、ONSを使用し、リモート・ポートを介して他のOPMNサーバーにリモート・リクエストをルーティングします。

request="ip; ip"

必須: ×
デフォルト値: デフォルト・システムのホスト名のIPアドレス
有効値: ONSが自身のリクエスト・ポートをバインドするIPアドレス（IPv4またはIPv6の形式で指定）またはホスト名。ONSを強制的に特定のIPアドレスのセットにバインドするように、IP値のリストを構成できます。リスト上の各値は、セミコロンで区切る必要があります。

request属性には、ONSが自身のリモート・ポートをバインドするIPアドレスまたはホスト名を指定します。このポートは、ステータス情報の取得にのみ使用できます。

port

必須: ◎
デフォルト値: なし
親要素: <notification-server>
属性: local、remote、request

port要素には、ONSリスナー・スレッドおよびホストとポートのバインドに使用するホスト情報が含まれます。

local="port"

必須: ◎
デフォルト値: なし
有効値: 有効なポート番号

local属性には、ONSのローカル・ポートの値を指定します。

remote="port"

必須: ×
デフォルト値: なし
有効値: ポート番号

remote属性には、ONSのリモート・ポートの値を指定します。

request="port"

必須: ×
デフォルト値: なし
有効値: ポート番号

request属性には、ONSのリクエストportの値を指定します。

ssl

必須: ×
デフォルト値: なし
親要素: <notification-server>
属性: enabled、wallet-file、wallet-password、openssl-certfile、openssl-keyfile、openssl-passwordおよびopenssl-lib

ssl要素は、ONS間のセキュリティおよび認証構成に使用されます。Oracle SSLレイヤー（wallet-fileおよびwallet-password）またはOpen SSLレイヤー（openssl-certfile、openssl-keyfile、openssl-passwordおよびopenssl-lib）のいずれかを構成できます。両方は使用できません。Oracle SSLレイヤーとOpen SSLレイヤーを同じopmn.xmlファイル内に構成すると、サーバーが起動しません。

Oracle SSLレイヤーは、Oracle Fusion MiddlewareまたはOracle Database製品のいずれかに付属するライブラリを使用します。Oracle SSLレイヤーは、標準のOracleウォレットを使用します。Open SSLレイヤーは、暗号化ハードウェアに対してより優れたパフォーマンス、ドキュメントおよびサポートを提供します。また、Open SSLレイヤーの方が、OPMN内部で使用するハードウェア領域が少なくなります。Open SSLは、セキュリティ・プロトコルを開発するためのオープン・ソースのツール・キットです。詳細は、次を参照してください。

http://www.openssl.org

enabled="boolean"

必須: ◎
デフォルト値: なし
有効値: trueまたはfalse

enabled値がtrueに設定されると、ONSでSSL接続が有効になります。

wallet-file="path"

必須: ×（Oracle SSLでのみ使用）
デフォルト値: なし
有効値: Oracleウォレットのパス名

wallet-password="password"

必須: ×（Oracle SSLでのみ使用）
デフォルト値: なし
有効値: ウォレットのパスワードに使用する文字列

wallet-password属性は、指定されたOracleウォレットのパスワード文字列です。

openssl-certfile="path"

必須: ◎（Open SSLでのみ使用）
デフォルト値: なし
有効値: Open SSLの証明書ファイルのパス名

openssl-keyfile="path"

必須: ◎（Open SSLでのみ使用）
デフォルト値: なし
有効値: Open SSLの鍵ファイルのパス名

openssl-password="password"

必須: ◎（Oracle SSLでのみ使用）
デフォルト値: なし
有効値: openssl-keyfileのパスワードに使用する文字列

openssl-password属性は、指定されたopenssl-keyfileに使用するパスワード文字列です。

openssl-lib="path"

必須: ×（Open SSLでのみ使用）
デフォルト値: なし
有効値: Open SSLライブラリのパス名

tune

必須: ×
デフォルト値: 「属性」を参照
親要素: <notification-server>
属性: io-timeout、io-idle、timeout

tune要素には、Tuneable Notification ServerのONSパラメータに関する情報が含まれます。

io-timeout="timeout"

必須: ×
デフォルト値: 30
有効値: 0または4〜3600の整数

io-timeoutは、ローカル・サーバーに直接接続された各リモートOPMN（またはONS）サーバーで使用される、ソケットの読取りタイムアウト値（秒単位）です。リモート・サーバーがio-timeoutに構成された時間内にローカル・サーバーとの接続を介してデータを受信しないと、リモート・サーバーで接続がタイムアウトになり、ソケットが閉じられます。io-timeout値は、リモートOPMN（またはONS）サーバーでローカル・サーバーに対して使用されるタイムアウト時間です。

io-timeout値は、さらに、ONS接続が切断された後のリソース・クリーンアップのタイムアウトとしても使用されます。タイムアウト前に接続が再確立されると、リソースは新しい接続に転送されます。接続が再確立されない場合、リソースはタイムアウト時間が経過した後に解放されます。

ビジー状態またはオーバーロードしているシステムで実行されているサーバーでは、io-timeoutパラメータの値を大きくする必要があります。

値0を指定すると、ローカル・サーバーに対するリモート・サーバー上のio-timeoutチェックが無効化されます。このio-timeoutにより、フェイルオーバー参加状態、重複したONS通知の検出状態および停止中の接続に対するキューに格納された通知のクリーンアップが無効になります。通知は接続が再確立されるまでキューに格納され続けるため、タイムアウト・チェックが無効化され、接続が再確立されない場合、リモートOPMNまたはONSサーバーのメモリー使用量が増加し続ける可能性があります。io-timeoutパラメータの値は、デバッグ時にのみ0に設定してください。

構成された値が0以外で最小値より小さい場合は、最小値に設定され、最大値より大きい場合は、最大値に設定されます。

io-idle="interval"

必須: ×
デフォルト値: io-timeout - （io-timeout / 3）
有効値: 2〜（io-timeout - 2）の整数

ローカル・サーバーの直接接続先の各リモート・サーバーにメッセージを送信する時間間隔（秒単位）を指定します。構成された時間間隔内にローカル・サーバーから任意のリモート・サーバーへ通常のネットワーク通信が行われなかった場合は、リモート・サーバーにメッセージが送信されます。

io-idleパラメータを設定すると、アイドルであるが応答するOPMNサーバーがリモート・サーバーに接続しているときに、その接続がタイムアウトにならなくなります。ビジー状態のシステムでは、この値をio-timeout値よりもはるかに小さい値に設定する必要があります。これにより、リモート・サーバーがタイムアウトを検出する前に、ローカル・サーバーがアイドル・メッセージをキューに入れ、リモート・サーバーに送信できる十分な時間を確保します。

io-timeoutが0の場合、io-idle属性は無視されます。構成された値が最小値より小さい場合は、最小値に設定され、最大値より大きい場合は、最大値に設定されます。

timeout="timeout"

必須: ×
デフォルト値: 20
有効値: 1〜3600の整数

timeoutパラメータは、接続試行およびクライアント接続書込みのためローカルOPMNサーバーに対して使用されるソケット・タイムアウト値（秒単位）を指定します。ローカルOPMNサーバーへの接続のハンドシェイクが、構成されたタイムアウト値よりも長くかかる場合は、ソケットが閉じられ、接続リソースが使用可能になります。クライアント接続ソケットでの書込みが、構成されたタイムアウト値よりも長くかかる場合は、ソケットが閉じられ、接続リソースが使用可能になります。

process-manager

必須: ◎
デフォルト値: なし
親要素: <opmn>
属性: insecure-remote-requests

process-managerには、OPMNのPM部分に対する構成の定義が含まれます。

insecure-remote-requests="boolean"

必須: ×
デフォルト値: false
有効値: trueまたはfalse

insecure-remote-request属性は、セキュリティ機能が構成されるまでリクエストを無効にする、セキュリティ・チェックを行うかどうかを指定します。デフォルトでは、ONSのSSLがenabledでありウォレット・ファイルが認証用に構成されている場合にのみ、OPMNがリモートOPMNサーバーからルーティングされたリクエストの起動、停止、再起動、シャットダウンおよび再ロードを許可します。

注意:
insecure-remote-request属性をtrueに設定すると、セキュリティ・チェックが無効になるため、セキュリティ機能が構成されていない状態でこれらのリクエストをリモートで発行できるようになります。
insecure-remote-requests属性をtrueに設定することには重大なセキュリティ上のリスクを伴うため、セキュリティを強化したファイア・ウォールを設定するか、外部ネットワークから完全に切断した状態で、接続したOPMNサーバーをテストする場合にのみ使用してください。

process-modules

必須: ◎
デフォルト値: なし
親要素: <process-manager>
属性: なし

各process moduleは、特定のprocess-type要素のセットをサポートするように設計されており、それらのprocess-type要素が構成されている場合にのみ必要となります。PMは、指定したprocess moduleごとにライブラリを動的にロードします。

module

必須: ◎
デフォルト値: なし
親要素: <process-modules>
属性: path、tag、status、cron

module要素は、PMに対してprocess-type固有のサポートを提供するために使用されます。各モジュールは、共有ライブラリとして実装されます。モジュールは、一連の標準機能をエクスポートし、PMのprocess module APIを使用します。モジュールは、このモジュールがサポートするprocess-typesのリストを備える必要があります。1つの構成済process moduleのみ、特定のprocess-typeをリストします。2つのモジュールに同じprocess-typeをリストすることはできません。

path="path"

必須: ◎
デフォルト値: なし
有効値: モジュールの共有ライブラリのパス名

path属性には、共有ライブラリ・ファイルのパス名を指定する必要があります。ライブラリ・ファイルには、Linuxの場合は.so、Microsoft Windowsの場合は.dllというシステム接尾辞が付きます。接尾辞は省略でき、その場合、接尾辞はOPMNによって自動的に追加されます。パスを指定するときには、ORACLE_HOMEを使用できます。

tag="tag-id"

必須: ×
デフォルト値: path要素で指定される値
有効値: モジュールを一意に識別する文字列

このtag属性によってモジュールを識別します。モジュールは、PMのログ・ファイルにエラーを記録する場合に、またはリクエストへのレスポンスの一部として、自身のタグの値をレポートできます。必須ではありませんが、この属性に意味のある値を設定すると、プロセス管理の問題の追跡に役立ちます。

status="state"

必須: ×
デフォルト値: enabled
有効値: critical、enabledまたはdisabled

モジュールをenabledに設定すると、PMは、モジュールの初期化機能を起動してコールするときに自身の共有ライブラリをロードし、disabledに設定すると、モジュール・エントリは完全に無視されます。モジュールのprocess-typesは、opmn.xmlファイル内に構成されている場合、さらにdisabledに設定されている必要があります。critical状態は、モジュールの初期化が失敗した場合にOPMNが致命的なエラー・コードで終了する点を除き、enabled状態と同じです。

cron="interval"

必須: ×
デフォルト値: なし
有効値: 整数

モジュールのcronコールバック機能をコールする時間間隔を秒単位で指定します。cronコールバックをサポートしないモジュールに対してcronの時間間隔を設定することはできません。モジュールを設計した場合以外、この属性の追加も変更も行わないでください。

module-data

必須: ×
デフォルト値: なし
親要素: <module>、<ias-instance>、<ias-component>、<dependencies>、<process-set>
属性: なし

module-dataブロックが使用されるのは、特定のモジュールにのみ意味のある、モジュール固有の名前と値のペアを定義する場合です。各module-dataブロックは、名前と値のデータのペアを含むいくつかのカテゴリにまとめられます。

module-dataブロックは、opmn.xmlファイル内の複数の要素に対して定義でき、OPMNは、process-setレベルに、それ以上のレベルで定義されたすべての値を含む集約的なmodule-dataブロックを作成します。この階層内に同じcategory idとdata idを持つ複数の定義が存在する場合は、最下位レベルに定義された値が使用されます。

表6-5に、階層内の各レベル（一番上が最上位レベル）で定義されたmodule-dataと、すべてのmodule-data定義のprocess-setレベルにおける結果の共用体を示します。

表6-6 module-dataの階層

モジュール

定義

ias-instance

<category id="CatA">
<data id= "DataAA" value="aaaa"/>
</category>

ias-component

<category id="CatA">
<data id= "DataAB" value="abab"/>
</category>
<category id="CatB">
<data id= "DataBA" value="baba"/>
</category>

module

<category id="CatA">
<data id= "DataAC" value="acac"/>
</category>

process-type

<category id="CatA">
<data id= "DataAA" value="XXXX"/>
</category>

process-set

<category id="CatB">
<data id= "DataBB" value="bbbb"/>
</category>

RESULT

<category id="CatA">
<data id= "DataAA" value="XXXX"/>
<data id= "DataAB" value="abab"/>
<data id= "DataAC" value="acac"/>
</category>
<category id="CatB">
<data id= "DataBA" value="baba"/>
<data id= "DataBB" value="bbbb"/>
</category>

category

必須: ◎
デフォルト値: なし
親要素:
module-data
属性: id

category要素は、module-dataブロック内の編成レベルを表します。

id="id"

必須: ◎
デフォルト値: なし
有効値: 文字列

このid文字列によってデータ・カテゴリを識別します。単一のmodule-dataブロック内の各category idは、一意にする必要がありますが、複数のmodule-dataブロックに、同じdata category idを含めることができ、その場合カテゴリは、関連していると見なされます。

data

必須: ◎
デフォルト値: なし
親要素: <category>
属性: id、value、process-conversion

module-dataカテゴリ内のデータ名の値を定義します。

id="id"

必須: ◎
デフォルト値: なし
有効値: 文字列

この文字列によってデータ属性を識別します。1つのカテゴリ内の各data idは一意にする必要がありますが、複数のカテゴリに同じデータIDを含めることができます。同じIDを持つ異なるカテゴリ内に定義されている、他のデータ要素と同じIDを持つデータ要素は互いに関連します。

value="value"

必須: ◎
デフォルト値: なし
有効値: 文字列

データ要素のidに関連付けられた値文字列です。data値が（process-set以上の任意のレベルで）定義されているprocess-set内（process-set以上の任意のレベル）で定義された環境変数のうち、この値文字列内で$variableまたは%variable%として参照されているものは、変数値に展開されます。

process-conversion="boolean"

必須: ×
デフォルト値: true
有効値: trueまたはfalse

process-conversion属性を使用することで、区切り文字を設定できます。OPMNは、デフォルトで、data値文字列に含まれるスラッシュを、OPMNが稼働しているシステムに応じたディレクトリ・パスの区切り文字に変換します。UNIXでは\文字が/文字に、Windowsでは/文字が\文字に変換されます。この変換を無効にするには、この属性をfalseに設定します。

process-conversionがtrueの場合、OPMNでは、^文字をエスケープ文字として使用し、その後に続く文字の変換を無効にすることに注意してください。したがって、Windowsシステムでは、文字列中の^/は/となります。結果として生成される文字列内に^文字を指定する必要がある場合は、^文字を2つ並べて指定します。つまり、^^は^となります。

module-id

必須: ◎
デフォルト値: なし
親要素: <module>
属性: id

module-id名は、プロセスのタイプを定義し、この構成をprocess moduleに関連付けます。

この識別子は、各process-typeで使用され、そのprocess-typeをサポートするモジュールを指定します。複数のmodule-idsを持つモジュールを構成できます。

id="module-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

ias-instance

必須: ◎
デフォルト値: なし
親要素: <process-manager>
属性: id

Oracleインスタンスの構成を定義します。各OPMNに対してサポートされるias-instanceは1つのみです。

id = ias-instance-id; name = ias-instance-name

id="ias-instance-name"

必須: ◎
デフォルト値: なし
有効値: 文字列

この文字列には、ias-instanceのIDを指定します。

name="ias-instance-name"

必須: ×
デフォルト値: ias-instance-id
有効値: 文字列

name文字列には、ias-instanceの名前を指定します。この値を使用して、Oracleインスタンスが識別されます。

environment

必須: ◎
デフォルト値: 次の段落を参照
親要素: <ias-instance>、<ias-component>、<process-type>、<process-set>
属性: なし

module-dataブロックと同様に、environmentブロックはopmn.xmlファイル内の複数の要素に対して定義でき、OPMNは、process-setレベルに、それ以上のレベルで定義されたすべての値を含む集約的なenvironmentブロックを作成します。この階層内に同じidを持つ複数の定義が存在する場合は、最下位レベルに定義された値が使用されます。

OPMNは、それぞれの管理対象プロセスについて一連のデフォルトの環境変数を提供するとともに、管理対象Javaプロセスについて一連のJavaシステム・プロパティを提供します。

表6-7では、環境変数について説明します。

表6-7 環境変数

環境変数

定義

ORACLE_HOME

Oracleホームへのフルパス

ORACLE_INSTANCE

Oracleインスタンス・ホームへのフルパス

INSTANCE_NAME

Oracleインスタンスの名前

PROCESS_UID

一意のプロセスID

OPMN_UID

PROCESS_UIDのシノニム

PROCESS_INDEX

プロセスのインデックス

OPMN_INDEX

PROCESS_INDEXのシノニム

COMPONENT_NAME

コンポーネントの名前

COMPONENT_TYPE

コンポーネントのタイプ

COMPONENT_CONFIG_PATH

コンポーネントに関する、ディスク上の構成ファイルへの絶対パス

COMPONENT_LOG_PATH

コンポーネントに関する、ディスク上のログ・ファイルへの絶対パス

ORACLE_NLS

デフォルト値はOPMN環境のORACLE_NLS

OPMN_ENV_LC_ALL

デフォルト値はOPMN環境のOPMN_ENV_LC_ALL

OPMN_ENV_LANG

デフォルト値はOPMN環境のOPMN_ENV_LANG

OPMN_ENV_NLS_LANG

デフォルト値はOPMN環境のOPMN_ENV_NLS_LANG

LD_LIBRARY_PATH

デフォルト値はORACLE_HOME/lib（Microsoft Windows以外）

SHELL

デフォルト値は/bin/sh（Microsoft Windows以外）

PATH

Linuxのデフォルト値:

ORACLE_HOME/bin:ORACLE_HOME/jdk/bin:/bin:/usr/bin:/usr/local/bin

Microsoft Windowsのデフォルト値:

%ORACLE_HOME%\lib;%ORACLE_HOME%\bin;%ORACLE_HOME%\jdk\bin;%SystemRoot%;%SystemRoot%\system32

COMSPEC

デフォルト値はシステムの%ComSpec%値（Microsoft Windowsのみ）

SystemRoot

デフォルト値はシステムの%SystemRoot%値（Microsoft Windowsのみ）

SystemDrive

デフォルト値はシステムの%SystemDrive%値（Microsoft Windowsのみ）

ORACLE_ADMIN_REGISTERED

Oracleインスタンスが管理サーバーに登録されている場合はtrue

ORACLE_ADMIN_HOST

関連付けられている管理ホスト（使用できない場合はN/A）

ORACLE_ADMIN_PORT

関連付けられている管理ポート（使用できない場合はN/A）

ORACLE_ADMIN_PROTOCOL

関連付けられている管理プロトコル（使用できない場合はN/A）

ORACLE_ADMIN_USERNAME

関連付けられている管理ユーザー名（使用できない場合はN/A）

表6-8では、すべての管理対象Javaプロセスに設定されるシステム・プロパティ（プロセスモジュールによってOPMNに対してそのようにフラグ付けされたもの）について説明します。

表6-8 システム・プロパティ

環境変数

定義

oracle.process.uid

一意のプロセスID

oracle.opmn.uid

oracle.process.uidのシノニム

oracle.process.index

プロセスのインデックス

oracle.opmn.index

oracle.process.indexのシノニム

oracle.home

Oracleホームへのフルパス

oracle.instance

Oracleインスタンス・ホームへのフルパス

oracle.instance.name

Oracleインスタンスの名前

oracle.component.name

コンポーネントの名前

oracle.component.type

コンポーネントのタイプ

oracle.component.configpath

コンポーネントに関する、ディスク上の構成ファイルへの絶対パス

oracle.component.logpath

コンポーネントに関する、ディスク上のログ・ファイルへの絶対パス

oracle.admin.registered

Oracleインスタンスが管理サーバーに登録されている場合はtrue

oracle.admin.host

関連付けられている管理ホスト（使用できない場合はN/A）

oracle.admin.port

関連付けられている管理ポート（使用できない場合はN/A）

oracle.admin.protocol

関連付けられている管理プロトコル（使用できない場合はN/A）

oracle.admin.username

関連付けられている管理ユーザー名（使用できない場合はN/A）

variable

必須: ◎
デフォルト値: なし
親要素: <environment>
属性: id、value、append、process-conversion

variable要素は、環境変数の名前と値を定義します。

id="id"

必須: ◎
デフォルト値: なし
有効値: 文字列

idには、環境変数の名前を指定します。environment idは、environmentブロック内で重複してもかまいませんが、最後に定義した値が前に定義した値よりも優先されます。異なる要素のenvironmentブロック内で、同じenvironment idを定義できますが、最下位レベルに定義した値が、それより上のレベルで定義した値よりも優先されます。

value="value"

必須: ◎
デフォルト値: なし
有効値: 文字列

環境変数の値を指定します。値文字列内で$variableまたは%variable%として参照されている環境変数は、変数値に展開されます。同じ環境変数が自身を参照して、上位レベルの定義を使用したり、これと同じenvironmentブロック内の前の位置にある定義やOPMN環境内の定義を使用したりできます。

環境変数を参照する場合は、Linuxシェル構文の$variableまたは${variable}、あるいはMicrosoft Windows形式の%variable%を使用できます。何も定義されていない変数を参照した場合、変数はそのまま維持されるので、value="_notdefined_"は何も変更されません。

たとえば、次のenvironmentブロックでは、accumulateに"foobar"という値を指定しています。

<environment>
<variable id="accumulate" value="foo">
<variable id="accumulate" value="${accumulate}bar">
</environment>

append="boolean"

必須: ×
デフォルト値: false
有効値: trueまたはfalse

この属性に対して値trueを指定することにより、新しい環境変数値を以前に定義した値に追加するようOPMNに強制できます。値と値との間はシステム・ライブラリ・デリミタ（Linuxの場合は:（コロン）、Microsoft Windowsの場合は;（セミコロン））で区切られます。これは、CLASSPATHなどの変数に使用する値をまとめる際に役立ちます。

たとえば、次のenvironmentブロックでは、LinuxシステムのCLASSPATHに/foo:/barという値を指定しています。

<environment>
<variable id="CLASSPATH" value="/foo">
<variable id="CLASSPATH" value="/bar" append="true">
</environment>

process-conversion="boolean"

必須: ×
デフォルト値: true
有効値: trueまたはfalse

ias-component

必須: ◎
デフォルト値: なし
親要素:<ias-instance>
属性: id、id-matching、status、type

ias-componentは、管理を目的としてprocess-typeを論理グループにまとめたものです。

id="component-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

id属性は、ias-instance内のias-componentを一意に識別します。

id-matching="boolean"

必須: ×
デフォルト値: false
有効値: trueまたはfalse

OPMNはデフォルトで、コンポーネントのid-matching属性がtrueに設定されている場合を除いて、すべての構成済ias-componentと一致するias-componentを指定しないようリクエストします。この属性がtrueに設定されている場合は、ias-componentやそのias-componentに対して構成された任意のprocess-typeまたはprocess-setに反映されるためには、OPMNリクエストにias-component idが明示的に含まれている必要があります。

status="state"

必須: ×
デフォルト値: enabled
有効値: enabledまたはdisabled

ias-componentをenabledに設定すると、OPMNは構成されたすべての属性および要素を解析して、OPMNに対する操作のリクエストを許可し、disabledに設定すると、ias-componentエントリは完全に無視されます。

type="component-type"

必須: ×
デフォルト値: なし
有効値: 文字列

type属性を使用すると、同じias-instance内のias-component間の関係を指定できます。

この属性を構成した場合、component-typeは、プロセスごとのCOMPONENT_TYPE環境変数（またはJavaプロセスのoracle.component.typeシステム・プロパティ）の値に使用されるとともに、COMPONENT_CONFIG_PATHおよびCOMPONENT_LOG_PATH（oracle.component.configpathおよびoracle.component.logpath）によって指定されたパスのtype要素に使用されます。component-typeが構成されていない場合は、process-type id属性がこれらの文字列の構成で使用されます。

dependencies

必須: ×
デフォルト値: なし
親要素: <ias-component>、<process-type>、<process-set>
属性: なし

OPMNは、dependenciesを使用して、プロセスを起動するかどうかを決定します。module-dataおよびenvironmentブロックと同様に、dependenciesブロックは、opmn.xmlファイル内の複数の要素に対し定義でき、OPMNは、process-setレベルに、それ以上のレベルで定義されたすべての依存性が含まれた集約的な依存性リストを作成します。重複する依存性が異なるレベルで定義されている場合、プロセスを起動する前にその依存性に対する重複チェックが実行されます。OPMNは、process-setレベルに、それ以上のレベルで定義されたすべての依存性が含まれた集約的な依存性リストを作成します。重複する依存性が異なるレベルで定義されている場合、プロセスを起動する前にその依存性に対する重複チェックが実行されます。

依存性のタイプは、主に外部と内部の2つに分けられます。外部依存性は、OPMNが管理しないリソースに使用されます。たとえば、Fusion Middleware Controlコンソールです。

外部プログラムは、リソースのチェックを行うためにOPMNによって実行されます。内部依存性は、システム・コンポーネント・プロセス（ユニット）に使用され、リモートのOPMN上で管理されるプロセスもこれに含まれます。

OPMNは、各依存性の既知の最後の状態を含む依存性の状態および最後にチェックを実行した時間のキャッシュを維持します。各依存性について、cache-timeoutパラメータを使用すると、キャッシュ内に維持している状態を使用する期間、またはその状態を使用するかどうかを指定できます。同様に、各依存性に対する一般的なタイムアウト・パラメータを使用して、その依存性からのステータス更新をOPMNが待つ時間（この時間を超えると、依存性のチェックおよびプロセスの起動が中止されます）を指定できます。

OPMNは、依存性が宣言されている順序で依存性をチェックします。依存性一覧のトラバースは、チェックがすべて成功する（依存性が有効）、最初のチェックが失敗する（依存性が無効）、あるいは依存性チェックがタイムアウトになるかのいずれかによって終了します。

database

必須: ×
デフォルト値: なし
親要素: <dependencies>
属性: db-connect-info、infrastructure-key、timeout、cache-timeout

database要素には、チェックするデータベースを指定します。db-connect-infoまたはinfrastructure-keyのいずれかを使用して、データベースを識別します。

db-connect-info="connect"

必須: ◎（infrastructure-keyが指定されない場合）
デフォルト値: なし
有効値: 文字列

db-connect-info属性には、データベースへの接続に必要な文字列を指定します。この文字列は、次のいずれかの形式で指定できます。

- <host>:<port>/<service name>

- (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=<host>) (PORT=<port>)) (CONNECT_DATA=(SERVICE_NAME=<service name>)))

次に例を示します。

pdsundev7:1521/asdb.us.oracle.com

infrastructure-key="key"

必須: ◎（db-connectが指定されない場合）
デフォルト値: なし
有効値: 文字列

infrastructure key属性は、データベースの識別に必要です。

timeout="depend-timeout"

必須: ×
デフォルト値: 1200
有効値: 整数

timeout属性には、依存性のチェックが完了するまでOPMNが待機する時間を秒単位で指定します。チェックが構成されたタイムアウトよりも長くかかっていると、OPMNはチェックが失敗したと見なします。

cache-timeout="cache-timeout"

必須: ×
デフォルト値: 600
有効値: 整数

cache-timeout属性には、キャッシュ内の依存性のエントリに対してOPMNが現在の稼働中ステータスを使用する時間を秒単位で指定します。最後に成功した依存性のチェックが、現在のチェックからさかのぼって指定した秒数内に実行されたものであれば、即座に依存性のチェックに成功のフラグが付き、指定した秒数よりも前の場合は、新たに依存性のチェックが実行されます。cache-timeoutは最後に成功した依存性チェックのみを対象としており、前のチェックが失敗した場合は、別の方法で依存性チェックが実行されることに注意してください。値が0の場合、OPMNはチェックを常に実行します。

OID

必須: ×
デフォルト値: なし
親要素:<dependencies>
属性: address、infrastructure、timeout、cache-timeout

<OID>要素は、特定のOracle Internet Directoryのアドレス文字列をチェックするOracle Internet Directoryサービスを指定します。この値をtrueに設定すると、デフォルトのOracle Internet Directoryが使用されます。

address="address"

必須: ◎
デフォルト値: なし
有効値: 文字列

address要素には、Oracle Internet Directoryへの接続に必要なアドレス文字列を指定します。

infrastructure="boolean"

必須: ◎（addressが設定されていない場合）
デフォルト値: なし
有効値: trueまたはfalse

Oracleインスタンスに、デフォルトのインフラストラクチャのOracle Internet Directoryを使用するかどうかを指定します。

ssl

必須: ×
デフォルト値: なし
親要素: <OID>
属性: enabled、wallet-file、wallet-password

Oracle Internet Directory接続用のSSL情報を指定します。

enabled="boolean"

必須: ◎
デフォルト値: なし
有効値: trueまたはfalse

Oracle Internet Directory接続でSSLを有効にするには、enabled属性をtrueに設定します。

wallet-file="path"

必須: ◎
デフォルト値: なし
有効値: 有効なパス名

Oracle Internet Directory接続の認証に使用するウォレット・ファイルのパス名を指定します。

wallet-password="password"

必須: ×
デフォルト値: なし
有効値: 文字列

wallet-password属性には、指定されたウォレット・ファイルに使用するパスワードを指定します。

timeout="depend-timeout"

必須: ×
デフォルト値: 1200
有効値: 整数

timeout属性には、依存性のチェックが完了するまでOPMNが待機する時間を秒単位で指定します。チェックが構成されたタイムアウトよりも長くかかっていると、OPMNはチェックが失敗したと見なします。

cache-timeout="cache-timeout"

必須: ×
デフォルト値: 600
有効値: 整数

cache-timeout属性には、キャッシュ内の依存性のエントリに対してOPMNが現在の稼働中ステータスを使用する時間を秒単位で指定します。最後に成功した依存性のチェックが、現在のチェックからさかのぼって指定した秒数内に実行されたものであれば、依存性のチェックに成功のフラグが付きます。そうでない場合、OPMNは別の依存性チェックを実行します。cache-timeoutは、最後に成功した依存性チェックに対するものです。前のチェックが失敗した場合、OPMNは別の方法で依存性のチェックを実行します。値が0の場合、OPMNはチェックを常に実行します。

OSSO

必須: ×
デフォルト値: なし
親要素: <dependencies>
属性: host、port、URI、timeout、cache-timeout

OSSO要素には、チェックするOracle Single Sign-Onサービスを指定します。

host="hostname"

必須: ◎
デフォルト値: なし
有効値: 文字列

host属性には、Oracle Single Sign-On接続用のホスト名を指定します。

port="port"

必須: ◎
デフォルト値: なし
有効値: ポート番号

port属性には、Oracle Single Sign-On接続用のポートを指定します。

URI="uri"

必須: ◎
デフォルト値: なし
有効値: 文字列

URI属性には、Oracle Single Sign-On接続用のURIを指定します。

ssl

必須: ×
デフォルト値: なし
親要素: <OSSO>
属性: enabled、wallet-file、wallet-password

ssl要素には、Oracle Single Sign-On接続用のSSL情報を指定します。

enabled="boolean"

必須: ◎
デフォルト値: なし
有効値: trueまたはfalse

enabled属性は、Oracle Single Sign-OnのSSL接続を有効にします。接続を有効にするには、この属性をtrueに設定します。

wallet-file="path"

必須: ◎
デフォルト値: なし
有効値: パス名

wallet-file属性には、Oracle Single Sign-On接続の認証に使用するウォレット・ファイルのパス名を指定します。ORACLE_HOMEの値を使用できます。

wallet-password="password"

必須: ×
デフォルト値: なし
有効値: 文字列

wallet-passwordには、指定されたwallet-fileのパスワードを指定します。

timeout="depend-timeout"

必須: ×
デフォルト値: 1200
有効値: 整数

timeout属性には、依存性のチェックが完了するまでOPMNが待機する時間を秒単位で指定します。チェックが構成されたタイムアウトよりも長くかかっていると、OPMNはチェックが失敗したと見なします。

cache-timeout="cache-timeout"

必須: ×
デフォルト値: 600
有効値: 整数

cache-timeout属性には、キャッシュ内の依存性のエントリに対してOPMNが現在の稼働中ステータスを使用する時間を秒単位で指定します。最後に成功した依存性のチェックが、現在のチェックからさかのぼって指定した秒数内に実行されたものであれば、依存性のチェックに成功のフラグが付きます。そうでない場合、OPMNは別の依存性チェックを実行します。cache-timeoutは、最後に成功した依存性チェックに対するものです。前のチェックが失敗した場合、OPMNは別の依存性チェックを実行します。値が0の場合、OPMNはチェックを常に実行します。

managed-process

必須: ×
デフォルト値: なし
親要素: <dependencies>
属性: ias-instance、ias-component、process-type、process-set、autostart、autostop、timeout、cache-timeout

managed-process属性には、チェックする管理対象プロセスを指定します。process-typeまたはprocess-setに対応するプロセスは、指定した依存性の管理対象プロセスがアクティブでない場合には、起動しません。循環依存が検出されると、ローカルの管理対象プロセスでは拒否されますが、リモートの管理対象プロセスでは、依存性チェックのデッドロックが生じ、タイムアウトが発生します。

ias-instance="ias-instance-id"

必須: ×
デフォルト値: 現在のprocess-typeまたはprocess-setのias-instance
有効値: 文字列

管理対象プロセスの依存性のias-instanceを指定します。指定したias-instanceは、現在のOPMNで管理されていなければ、リモートの管理対象プロセスの依存性であると見なされます。

ias-component="ias-component-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

管理対象プロセスの依存性のias-componentを指定します。

process-type="process-type-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

管理対象プロセスの依存性のprocess-type-idを指定します。

process-set="process-set-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

管理対象プロセスの依存性のprocess-set-idを指定します。

autostart="boolean"

必須: ×
デフォルト値: false
有効値: trueまたはfalse

autostart属性は、管理対象プロセスの依存性に使用されます。チェックの実行時にプロセスが実行されていない場合、autostart要素に応じて、OPMNがそのプロセスの起動を試みます。

autostop="boolean"

必須: ×
デフォルト値: false
有効値: trueまたはfalse

管理対象プロセスの依存性が停止中である場合に、管理対象プロセスを停止するかどうかを指定します。この属性は、リモートの管理対象プロセスの依存性については常にfalseです。

timeout="depend-timeout"

必須: ×
デフォルト値: 1200
有効値: 整数

timeout属性には、依存性のチェックが完了するまでOPMNが待機する時間を秒単位で指定します。チェックが構成されたタイムアウトよりも長くかかっていると、OPMNはチェックが失敗したと見なします。

cache-timeout="cache-timeout"

必須: ×
デフォルト値: 600
有効値: 整数

cache-timeout属性は、リモートのOPMNが管理するプロセスにのみ使用されます。cache-timeout属性には、キャッシュ内の依存性のエントリに対してOPMNが現在の稼働中ステータスを使用する時間を秒単位で指定します。最後のタイムアウト依存性のチェックが、現在のチェックからさかのぼって指定した秒数内に実行されたものであれば、即座に依存性のチェックに成功のフラグが付き、指定した秒数よりも前の場合は、OPMNが新たに依存性のチェックを実行します。cache-timeoutは最後に成功した依存性チェックのみを対象としており、前のチェックが失敗した場合は、OPMNにより依存性チェックが実行されることに注意してください。値が0の場合、OPMNはチェックを常に実行します。

注意:
cache-timeoutは最後に成功した依存性チェックのみを対象としており、前のチェックが失敗した場合は、OPMNにより別の依存性チェックが実行されます。

process-type

必須: ◎
デフォルト値: なし
親要素: <ias-component>
属性: id、module-id、status、working-dir

process-typeは、同じモジュールがサポートするprocess-setをグループ化したものです。

id="process-type-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

id属性は、ias-component内のprocess-typeを一意に識別します。

module-id="module-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

module-id属性は、process-typeをサポートするmodule-id属性に直接マップする必要があります。

status="state"

必須: ×
デフォルト値: enabled
有効値: enabledまたはdisabled

process-typeをenabledに設定すると、OPMNは構成されたすべての属性および要素を解析して、OPMNに対する操作のリクエストを許可し、disabledに設定すると、process-typeエントリは完全に無視され、opmn.xmlファイルの一覧にないエントリと同様に処理されます。

working-dir="path"

必須: ×
デフォルト値: なし
有効値: パス名

working-dirパス名には、process-type要素により作成される管理対象プロセス用に設定された作業ディレクトリを指定します。process-setでworking-dir属性も定義している場合、process-setのパス名はprocess-typeのパス名よりも優先されます。

event-scripts

必須: ×
デフォルト値: なし
親要素: <process-type>、<process-set>
属性: なし

特定のプロセス関連イベントが発生すると、構成されたevent scriptが実行されます。OPMNはスクリプトの実行が完了するか、またはタイムアウトが起こるまで待機してから、次のactionを実行します。

表6-9に、イベント・スクリプトの引数を示します。

表6-9 イベント・スクリプトの引数

オプション名

オプションの引数

説明

-timeStamp

<time>

システムの現在のtimeを示す整数値（秒単位）。

-instanceName

<instance-name>

管理対象プロセスのinstance-name。

-componentId

<component-id>

管理対象プロセスのcomponent-id。

-processType

<process-type-id>

管理対象プロセスのprocess-type。

-processSet

<process-set-id>

管理対象プロセスのprocess-set。

-processIndex

<index>

管理対象プロセスのprocess-index。

-stderr脚注1

<path>

プロセスのstderrファイル・ポインタのパス名。

-stdout脚注参照1

<path>

プロセスのstdoutファイル・ポインタのパス名。注意: この引数は、startがプロセスの再起動リクエストの一部である場合に、pre-startスクリプトについてのみ指定されます。

-reason

<reason>

スクリプトが実行された理由を示す文字列。http_requestは、プロセスactionが、OPMNに対してユーザーがHTTPリクエストを実行した結果であることを示します。non_http_requestは、プロセスactionがOPMNそれ自体により開始されたことを示します。

-pid脚注2

<process-id>

process-idに設定されたオペレーティング・システムの整数値。

-startTime脚注参照2

<time>

システムでのプロセスの開始時間を示す整数値（秒単位）。

脚注1 この引数は、startがプロセスの再起動リクエストの一部である場合に、pre-startスクリプトについてのみ指定されます。pre-startイベントは、startの実行前でのみトリガーされます。restart操作は、stop操作とそれに続くstart操作から構成される場合があります。start操作は単独で実行することも、restart操作の一部として実行することもできます。

脚注2 この引数は、pre-stopまたはpost-crashイベント・スクリプトにのみ使用できます。

pre-start

必須: ×
デフォルト値: なし
親要素: <event-scripts>
属性: path

構成した依存性チェックが実行されて（かつ成功して）からプロセスが実際に開始するまでの間に、OPMNが実行するpre-startスクリプトを指定します。pre-startスクリプトのタイムアウトは、プロセス自体の起動に設定されたタイムアウト値になり、このスクリプトの実行に使用した時間は、プロセスの起動のタイムアウト値に向かってカウントされます。スクリプトがタイムアウトした場合、プロセスは起動せず、関連するすべてのHTTPリクエストが失敗します。

イベント・スクリプトを使用してstart、stop、restartなどのOPMNプロセスのリクエストを実行する場合は注意が必要です。これらのリクエストは、process-setレベルでシリアライズされます。現在のリクエスト（またはすでにキューに格納されている別のリクエスト）の対象となっているprocess-set上でスクリプトがリクエストを起動する場合、そのスクリプトはタイムアウトになるまでハングします。

path="path"

必須: ◎
デフォルト値: なし
有効値: 実行可能スクリプトのパス名

このパス名で、OPMNが実行権限を持つ実行可能プログラム、またはOPMNが読取り権限と実行権限の両方を持つスクリプト・ファイルを指定する必要があります。

pre-stop

必須: ×
デフォルト値: なし
親要素: <event-scripts>
属性: path

OPMNは、関連付けられたプロセスを停止する前に、指定されたスクリプトを実行します。このスクリプトのタイムアウトは、プロセス自体の停止に設定された値です。このスクリプトの実行に使用した時間は、プロセスの停止のタイムアウト値に向かってカウントされます。スクリプトがタイムアウトした場合は、関連するHTTPリクエストは失敗します。ただし、OPMNはプロセスの停止操作を続行します。

start、stop、restartなどのOPMNプロセスのリクエストを実行する場合は注意が必要です。これらのリクエストは、process-setレベルでシリアライズされます。現在のリクエスト（またはすでにキューに格納されている別のリクエスト）の対象となっているprocess-set上でスクリプトがリクエストを起動する場合、そのスクリプトはタイムアウトになるまでハングします。

path="path"

必須: ◎
デフォルト値: なし
有効値: 実行可能スクリプトのパス名

path属性で、OPMNが実行権限を持つ実行可能プログラム、またはOPMNが読取り権限と実行権限の両方を持つスクリプト・ファイルを指定する必要があります。

post-crash

必須: ×
デフォルト値: なし
親要素: <event-scripts>
属性: path

OPMNは、関連付けられたプロセスが予期せず中断した後に、指定されたスクリプトを実行します。このスクリプトのタイムアウトは、プロセス自体の停止に設定されたタイムアウト値です。スクリプトが終了すると、OPMNは中断したプロセスの置換をスケジュールします。

start、stop、restartなどのOPMNプロセスのリクエストを実行する場合は注意が必要です。これらのリクエストは、process-setレベルでシリアライズされます。現在のリクエスト（またはすでにキューに格納されている別のリクエスト）の対象となっているprocess-set上でスクリプトがリクエストを起動する場合、そのスクリプトはタイムアウトになるまでハングします。

path="path"

必須: ◎
デフォルト値: なし
有効値: 実行可能スクリプトのパス名

path属性で、OPMNが実行権限を持つ実行可能プログラム、またはOPMNが読取り権限と実行権限の両方を持つスクリプト・ファイルを指定する必要があります。

start

必須: ×
デフォルト値: 次の段落の値を参照
親要素: <process-type>、<process-set>
属性: timeout、retry

start属性には、管理対象プロセスの起動パラメータが含まれます。

timeout="timeout"

必須: ×
デフォルト値: 60
有効値: 整数

timeout属性には、管理対象プロセスの起動に対するタイムアウト値（秒単位）を指定します。

retry="num"

必須: ×
デフォルト値: 0
有効値: 整数

retry属性には、1つのリクエストに対するプロセス起動の連続試行回数を指定します。

stop

必須: ×
デフォルト値: 次の段落の値を参照
親要素: <process-type>、<process-set>
属性: timeout

stop属性には、管理対象プロセスの停止パラメータを指定します。

timeout="timeout"

必須: ×
デフォルト値: 30
有効値: 整数

管理対象プロセスの停止に対するtimeout値（秒単位）を指定します。

restart

必須: ×
デフォルト値: 次の段落の値を参照
親要素: <process-type>、<process-set>
属性: timeout、retry

管理対象プロセスのrestartパラメータを指定します。

timeout="timeout"

必須: ×
デフォルト値: 90
有効値: 整数

管理対象プロセスの再起動に対するtimeout値（秒単位）を指定します。

retry="num"

必須: ×
デフォルト値: 0
有効値: 整数

retry属性には、1つのリクエストに対するプロセス再起動の連続試行回数を指定します。

ping

必須: ×
デフォルト値: 次の段落の値を参照
親要素: <process-type>,<process-set>
属性: timeout、retry

ping要素には、管理対象プロセスのpingパラメータを指定します。

timeout="timeout"

必須: ×
デフォルト値: 20
有効値: 整数

管理対象プロセスのpingに対するtimeout値（秒単位）を指定します。モジュールごとにpingのタイムアウトを指定します。

retry="num"

必須: ×
デフォルト値: 0
有効値: 整数

retry属性には、pingの許容される連続失敗回数（この回数を超えると、モジュールはプロセスがアクセス不能と宣言してこのプロセスを再起動します）を指定します。モジュールごとにpingのリトライ回数を指定します。

interval="interval"

必須: ×
デフォルト値: 20
有効値: 整数

interval属性には、管理対象プロセスのpingを実行する時間間隔（秒単位）を指定します。

port

必須: ×
デフォルト値: なし
親要素: <process-type>
属性: id、range

port要素では、使用するモジュールに対するポート管理メカニズムを指定します。各モジュールは、idに設定されたポートを使用します。

id="id"

必須: ◎
デフォルト値: なし
有効値: 文字列

id属性で、process-typeに使用するポートの範囲を指定します。どのモジュールにも、独自の必須またはオプションのport id一覧があります。

range="range"

必須: ◎
デフォルト値: なし
有効値: ポート範囲

port rangeは、idに割り当てるポートを指定します。

モジュールがid内のポート番号をリクエストすると、OPMNは、その範囲内のポートがローカル・システムにバインドされているかどうかをチェックし、バインドされていない場合はモジュールにそのポート番号を返します。port rangeの構文は、個々のポートの番号または下限-上限の範囲指定をカンマで区切って並べたリストです。

次に例を示します。

ポート5555、6666、7777、8888および9999を指定する構文は次のとおりです。

range="5555,6666,7777,8888,9999"

ポート4000〜4250を指定する構文は次のとおりです。

range="4000-4250"

ポート7000〜7049、7775、7785および8050〜8099を指定する構文は次のとおりです。

range="7000-7049,7775,7785,8050-8099"

process-set

必須: ×
デフォルト値: id="component-id" numprocs="1"
親要素: <process-type>
属性: id、restart-on-death、numprocs、minprocs、maxprocs、status、working-dir、parallel-requests

process-setは、OPMN内のプロセスを抽象化したものです。すべてのmodule-data、環境変数およびその他の構成パラメータが、process-setレベルで最終的な値に解決されます。

process-setが構成されていない場合は、ias-componentと同じidと、1というnumprocsを使用して、この属性が自動的に作成されます。

id="process-set-id"

必須: ◎
デフォルト値: なし
有効値: 文字列

id属性は、process-type内のprocess-setを一意に識別します。

restart-on-death="boolean"

必須: ×
デフォルト値: true
有効値: trueまたはfalse

管理対象プロセスが、リクエストによる停止ではなく予期せず中断した場合、OPMNはそのプロセスの自動再起動を行いません。終了された管理対象プロセスの自動再起動を無効にするには、この属性をfalseに設定します。

numprocs="num"

必須: ◎（minprocsが構成されない場合。構成される場合は×）
デフォルト値: なし
有効値: 整数

OPMNがprocess-setに対して起動するプロセスの数を指定します。

minprocs="min"

必須: ◎（numprocsが構成されない場合。構成される場合は×）
デフォルト値: なし
有効値: 整数

OPMNがprocess-setに対して起動するプロセスのデフォルトの個数を指定します。minprocsが構成されている場合、maxprocsには、minprocsの値以上の値を設定する必要があります。minprocsおよびmaxprocsが構成されている場合、このプロセス・セットに対するOPMNリクエストに、特定のプロセス数が指定されます。この属性は、numprocsが構成されている場合は指定できません。

maxprocs="max"

必須: ◎（minprocsが構成される場合。構成されない場合は×）
デフォルト値: なし
有効値: 整数

maxprocs属性は、minprocsが構成されている場合は指定する必要がありますが、numprocsが構成されている場合は指定できません。

status="state"

必須: ×
デフォルト値: enabled
有効値: enabledまたはdisabled

process-setをenabledに設定すると、OPMNは構成されたすべての属性および要素を解析して、OPMNに対する操作のリクエストを許可します。disabledに設定すると、process-setエントリは完全に無視され、opmn.xmlファイルの一覧にないエントリと同様に処理されます。

working-dir="path"

必須: ×
デフォルト値: ORACLE_INSTANCE
有効値: パス名
working-dirパス名には、process-set要素に属す作成済の管理対象プロセス用に設定された作業ディレクトリを指定します。

parallel-requests="boolean"

必須: ×
デフォルト値: false
有効値: trueまたはfalse

OPMNは、特定のprocess-setで一度に1つのリクエストのみが実行できるように、process-setレベルでリクエストをシリアライズします。後続のリクエストはそれぞれ、実行前に前のリクエストが完了するまで待機する必要があります。このデフォルトの動作は、parallel-requestsがtrueに設定されている場合、process-setに対して無効化されます。

注意:
parallel-requests属性が有効になっている場合は、OPMNはprocess-setに対するリクエストのシリアライズをまったく実行しません。つまり、競合するリクエストが事実上同時に発行および実行される可能性があり、その結果としてprocess-set内のプロセスが予測不可能な状態になります。したがって、parallel-requestsがtrueに設定されている場合は、process-setに対して競合するリクエストが同時に発行されていないことを確認する必要があります（これには、一致するprocess-setの暗黙的なワイルドカードを使用したリクエストも含みます）。

launch-targets

必須: ×
デフォルト値: なし
親要素: <process-manager>
属性: なし

launch-targetsブロックは、launch-target定義のリストで構成されます。1つのlaunch-targetsブロックのみが存在できます。

launch-target

必須: ×
デフォルト値: なし
親要素: <launch-target>
属性: id

OPMNによって起動リクエストを通じて起動されるプロセスの定義を指定します。

id="id"
必須: ◎
デフォルト値: なし
有効値: 文字列。このlaunch-targetの識別子。それぞれのlaunch-targetには一意のIDを割り当てる必要があります。この識別子は、起動リクエストのtarget引数で指定します。

exec

必須: ◎
デフォルト値: なし
親要素: <launch-target>
属性: path

launch-targetの実行可能ファイルへのパスを指定します。1つのlaunch-targetについて1つのexec要素のみを構成できます。

path="path"

必須: ◎
デフォルト値: なし
有効値: 実行可能ファイルへのパス
実行可能ファイルへのフルパスを指定します。

argument

必須: ×
デフォルト値: なし
親要素: <launch-target>
属性: value

構成された実行可能プロセスに常に渡される引数を指定します。1つのlaunch-targetについて複数のargument要素を構成でき、これらの引数は構成された順序で実行可能ファイルに渡されます。

起動リクエストを通じて渡される追加の引数は、構成された引数の後に渡されます。

value="argument"

必須: ◎
デフォルト値: なし
有効値: 文字列

実行可能ファイルに対する単一の引数を指定します。スペースは引数の区切り文字ではありません。複数の引数を定義するには、複数のargument要素を使用します。

timeout

必須: ×
デフォルト値: 120
親要素: <launch-target>
属性: value

起動リクエスト・スレッドによって行われる各入出力で使用されるタイムアウトを指定します。1つのlaunch-targetについて1つのtimeout要素のみを構成できます。

value="seconds"

必須: ◎
デフォルト値: なし
有効値: 5〜3600の整数値

入出力タイムアウト値を秒単位で指定します。

max-concurrency

必須: ×
デフォルト値: 5
親要素: launch-target
属性: value

このlaunch-targetに対する同時プロセスの最大数。1つのlaunch-targetについて1つのmax-concurrency要素のみを構成できます。

value="maximum"

必須: ◎
デフォルト値: なし
有効値: 1〜250の整数値

このlaunch-targetに対する同時プロセスの最大数。

A カスタム・プロセスの構成

この章では、OPMN opmn.xmlファイルのカスタム・プロセス構成について説明します。

次のトピックで構成されています。

- カスタム・プロセス・モジュールの構成

- カスタム・プロセスの最小構成

- カスタム・プロセスの完全構成

- カスタム・プロセスの属性の説明

A.1 カスタム・プロセス・モジュールの構成

次の行は、カスタム・プロセス・モジュールのロードと識別を行います。プロセス・モジュールによるカスタム・プロセスの管理は、module idによって識別されます。

<module path="ORACLE_HOME/opmn/lib/libopmncustom.so">
<module-id id="CUSTOM" />
</module>

A.2 カスタム・プロセスの最小構成

次の行は、カスタム・プロセスの最小限の構成を表します。カスタム・プロセスの他のすべての構成要素と属性にはデフォルト値が割り当てられます。

<ias-component id="Custom">
<process-type id="Custom" module-id="CUSTOM">
<process-set id="Custom" numprocs="1">
<module-data>
<category id="start-parameters">
<data id="start-executable" value="Your start executable here" />
</category>
</module-data>
</process-set>
</process-type>
</ias-component>

A.3 カスタム・プロセスの完全構成

例A-1に、カスタム・プロセスの完全な構成を示します。これには、カスタム・プロセスに使用できるすべての構成要素および属性が含まれています。

カスタム・プロセスは、他の任意のシステム・コンポーネントの一部とすることができます。このような場合には、例A-1のprocess-type要素は、コンポーネント構成の一部である必要があります。

A.3.1 ping

カスタム・モジュールは、次の2つのいずれかの方法で、カスタム・プロセスのpingを実行するフレームワークを提供します。

- HTTP ping

- スクリプトping

pingのタイプは、ping-parametersカテゴリ内に適切なデータを指定することによって構成できます。サンプルの構成である例A-1に、HTTP pingを使用したカスタム・プロセスを示します。例A-1は、コンポーネント構成に代替挿入可能なスクリプトpingの例です。

例A-1 カスタム・プロセスの完全構成

<ias-component id="Custom" status="enabled" id-matching="false">
<environment>
<variable id="TEST_ENV_VARIABLE" value="/your/test/value"
append="false"/>
</environment>
<process-type id="Custom" module-id="CUSTOM">
<process-set id="Custom" restart-on-death="true" numprocs="1">
<module-data>
<category id="start-parameters">
<data id="start-executable" value="Your start executable here" />
<data id="start-args" value="Your start args here" />
<data id="append-req-args" value="Arguments appended to the end of the
start command"/>
<data id="java-proc" value="true"/>
</category>
<category id="stop-parameters">
<data id="stop-executable" value="Your stop executable here" />
<data id="stop-args" value="Your stop args here" />
<data id="append-req-args" value="Arguments appended to the end of the
stop command"/>
</category>
<category id="restart-parameters">
<data id="restart-executable" value="Your restart executable here"/>
<data id="restart-args" value="Your restart args here" />
<data id="append-req-args" value="Arguments appended to the end of the
restart command"/>
</category>
<category id="ping-parameters">
<data id="ping-type" value="http" />
<data id="ping-url" value="/your/ping/url" />
<data id="ping-host" value="abc.company.com" />
<data id="ping-port" value="7777" />
<data id="ping-limit" value="3" />
<data id="ping-timeout" value="300" />
</category>
<category id="ready-parameters">
<data id="use-ping-for-ready" value="false" />
</category>
</module-data>
</process-set>
</process-type>
</ias-component>

例A-2に、スクリプトを使用したpingの構成を示します。

例A-2 pingタイプ・スクリプト

<category id="ping-parameters">
<data id="ping-type" value="script" />
<data id="script-executable" value="Ping executable here" />
<data id="script-args" value="Ping arguments here " />
</category>

pingを実行することで（使用できる場合）、プロセスが動作可能であるかどうかを判断できます。これは、OPMNが、プロセスの作成後、管理対象プロセスが正常に起動したことの確認を必要としていることを示しています。プロセスは、様々な方法でOPMNに準備ができていることを伝えます。カスタム・モジュールを使用すると、それらのプロセスは、pingを使用して動作可能であることを伝えることができます。カスタム・プロセスに対してping機能を構成する場合、このメカニズムを使用して、そのプロセスの準備ができているかどうかを判断することもできます。プロセスが正常に起動していることのみをカスタム・モジュール側で仮定している場合は、動作可能かどうかを判断するメカニズムを構成しないこともできます。

注意:
pingが構成されている場合、プロセスの作成後すぐにpingが実行されます。プロセスの初期化およびpingへの応答にしばらくかかる場合は、pingを使用して動作可能かどうかを判断することは適切ではありません。その理由は、プロセスがready pingに応答しない場合は、OPMNはそのプロセスが正常に起動しなかったと判断してそのプロセスを停止するからです。

A.4 カスタム・プロセスの属性の説明

この項では、カスタム・プロセスに固有の属性について説明します。この項では、さらに、それぞれの属性についても説明します。

カスタム・プロセスの属性は、次の形式で記述されます。

- タイトル: 定義対象の属性名と値です。たとえば、id="Custom"のように記述します。

- 必須: このフィールドでは、コンポーネントの定義に該当属性が必要か否かを定義します。

- デフォルト値: 属性に割り当てられるデフォルト値を定義します。デフォルト値は、インストールされているバージョンのopmn.xmlファイルに格納されるか、該当属性が存在しない場合は内部的に割り当てられます。

- 有効値: このフィールドでは、必要に応じ、属性の有効値を定義します。たとえば、customのように記述します。

- パス: このフィールドでは、該当属性が現れる要素を定義します。たとえば、ias-componentのように記述します。

id="Custom"

必須: ◎
デフォルト値: なし
有効値: 選択した任意のid
パス: ias-component
パス: ias-component/process-type
パス: ias-component/process-type/process-set

このidは必須であり、任意の名前を指定できます。ただし、idは、既存の名前と重複しないようにしてください。

module-id="CUSTOM"

必須: ◎
デフォルト値: なし
有効値: カスタム・プロセスを構成するために付録Aで指定されたmodule-idと同じ。
パス: ias-component/process-type

module-idは、プロセスをモジュールに関連付けます。カスタム・プロセスでは、このidは、カスタム・モジュールのプロセス・モジュール構成で指定されるmodule-idと一致している必要があります。

id="start-parameters"

必須: ◎
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/
category

start-parametersカテゴリには、起動実行可能ファイルおよび起動引数を指定する子要素が含まれます。

id="java-proc"

必須: ×
デフォルト値: false
有効値: trueまたはfalse
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素は、プロセスがJavaプロセスかどうかを指定します。trueに設定した場合は、OPMNは管理対象プロセスのデフォルトのシステム・プロパティをstart-argsに追加します。

id="start-executable"

必須: ◎
デフォルト値: なし
有効値: 実行する有効な実行可能ファイル
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素は、起動する実行可能ファイルの名前を指定します。

id="start-args"

必須: ×
デフォルト値: なし
有効値: 起動実行可能ファイルのデータ要素によって指定される実行可能ファイルへの有効な引数
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素の値は、起動実行可能ファイルへのすべての引数を含む文字列である必要があります。このidに複数のデータ要素を指定しないでください。

id="append-req-args"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/
category

append-req-argsの値は、構成された起動コマンドの末尾に付加されます。

id="stop-parameters"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/
category

stop-parametersカテゴリには、停止実行可能ファイルおよび停止引数を指定する子要素が含まれます。このカテゴリが構成されていない場合、OPMNは、killコマンドを使用してプロセスを停止します。

id="stop-executable"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素は、プロセスの停止に使用される実行可能ファイルの名前を指定します。

id="stop-args"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素の値は、停止実行可能ファイルへのすべての引数を含む文字列である必要があります。このidに複数のデータ要素を指定しないでください。

id="restart-parameters"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/
category

restart-parametersカテゴリには、再起動実行可能ファイルおよび再起動引数を指定する子要素が含まれます。プロセスに明示的な再起動コマンドがある場合、このカテゴリを構成する必要があります。再起動コマンドがない場合、プロセスの再起動が必要なときは、停止コマンドに続いて起動コマンドが実行されます。

再起動データが指定されると、OPMNは、そのプロセスのプロセスIDを再起動後も同じであると見なします。プロセスに使用できる明示的な再起動コマンドがない場合、停止コマンドに続いて起動コマンドが発行されます。この場合はプロセスIDの変更が許容されます。

id="restart-executable"

必須: ×
デフォルト値: なし
有効値: 有効な再起動実行可能ファイル名
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素は、プロセスの再起動に使用される実行可能ファイルの名前を指定します。

id="restart-args"

必須: ×
デフォルト値: なし
有効値: 再起動実行可能ファイルへの有効な引数
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素の値は、再起動実行可能ファイルへのすべての引数を含む文字列である必要があります。このidに複数のデータ要素を指定しないでください。

id="append-req-args"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/category

append-req-argsの値は、構成された再起動コマンドの末尾に付加されます。

id="ping-parameters"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/
category

HTTPプロトコルを介してpingが実行されるカスタム・プロセスでは、このカテゴリを指定する必要があります。このmodule dataカテゴリは、そのようなpingの実行に必要なすべてのデータで構成されています。

id="ping-type"

必須: ×
デフォルト値: なし
有効値: http、script、integrator
パス: ias-component/process-type/process-set/module-data/category/
data

pingを実行するカスタム・プロセスでは、このmodule dataを指定する必要があります。

関連項目:

- カスタム・プロセスの完全な構成の詳細は、例A-1を参照してください。

- pingタイプ・スクリプトの詳細は、例A-2を参照してください。

id="ping-url"

必須: ×
デフォルト値: /
有効値: 任意の有効なURL
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素を使用して、プロセスに対しpingを実行する際のURLを指定します。指定されたパラメータは、HTTP pingで使用されます。

id="ping-host"

必須: ×
デフォルト値: なし
有効値: カスタム・プロセスがバインドされる有効なホスト名
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素を使用して、カスタム・プロセスがバインドされるホスト名を指定します。このデータを指定しないと、pingが実行されません。無効なホスト名が指定された場合、process-setはdisabled（使用不可）になります。

id="ping-port"

必須: ×
デフォルト値: なし
有効値: カスタム・プロセスがHTTPリクエストをリスニングする有効なポート
パス: ias-component/process-type/process-set/module-data/category/
data

カスタム・プロセスがリスニングするポートです。このデータを指定しないと、pingが実行されません。無効なポートが指定された場合、process-setはdisabled（使用不可）になります。

id="ping-limit"

必須: ×
デフォルト値: 3
有効値: pingの失敗に対してOPMNが持つトレランスを示す任意の適切な値。OPMNは、このトレランスを使用して、プロセスを応答なしと宣言して再起動するタイミングを決定します。
パス: ias-component/process-type/process-set/module-data/
category/data

このmodule data要素は、pingの失敗に対するトレランスを定義します。pingが失敗した回数がこの上限値に達すると、プロセスは応答なしと見なされ、OPMNによって再起動されます。

id="ping-timeout"

必須: ×
デフォルト値: 300（秒）
有効値: 適切なタイムアウト値
パス: ias-component/process-type/process-set/module-data/category/
data

このデータ要素で指定されたタイムアウト値は、OPMNがpingのレスポンスが届くのを待つ最大時間として使用されます。タイムアウト時間内にレスポンスがない場合、pingの試行は失敗したと見なされます。

id="script-executable"

必須: ×
デフォルト値: なし
有効値: 有効なスクリプト実行可能ファイル
パス: ias-component/process-type/process-set/module-data/
category/data

このデータ要素は、プロセスのpingに使用される実行可能ファイルの名前を指定します。この実行可能ファイルからの終了値が0の場合、pingは正常に実行されたと見なされます。その他のすべての値は、pingが失敗したことを示します。

id="script-args"

必須: ×
デフォルト値: なし
有効値: ping実行可能ファイルへの有効な引数
パス: ias-component/process-type/process-set/module-data/
category/data

このデータ要素の値は、ping実行可能ファイルへのすべての引数を含む文字列である必要があります。このidに複数のデータ要素を指定しないでください。

id="ready-parameters"

必須: ×
デフォルト値: なし
パス: ias-component/process-type/process-set/module-data/
category

module dataカテゴリは、カスタム・プロセスが正常に起動しているかどうかを判断するためにpingを使用することを示します。

id="use-ping-for-ready"

必須: ×
デフォルト値: false
有効値: trueまたはfalse
パス: ias-component/process-type/process-set/module-data/
category/data

このデータ要素の値により、プロセスが使用可能であるかどうかを判断するためにpingを使用するかどうかが決まります。

B OPMNのトラブルシューティング

この付録では、OPMNのトラブルシューティングのヒントを説明します。次のトピックで構成されています。

- 問題点とソリューション

- OPMNの問題の診断

- その他のヘルプ情報

B.1 問題点とソリューション

この項では、OPMNの使用に際して発生する共通の問題をいくつか説明します。次のトピックで構成されています。

- システム・プロセスが起動しない

- システム・プロセスに障害が発生または応答なしの状態になっているかどうかを判断する

- opmnctlコマンド実行のタイムアウト

- システム・コンポーネントがOPMNによって自動的に再起動される

- opmnctl startの予想外の動作

- opmn.xmlファイル内の無効な要素

- OHSを起動できない

- コンポーネントを停止できない

- globalInitNLSエラー

- OPMNの起動時にCPU使用率が増加する

- OPMN起動時にエラー・メッセージが表示される

- opmn.logファイルのサイズが増える

- 不適切な状態にあるOracleインスタンスまたはコンポーネントのクリーンアップ

B.1.1 システム・プロセスが起動しない

問題点

OPMNを使用してシステム・プロセスを起動することができません。

ソリューション

OPMNを使用してシステム・プロセスを起動できない場合は、次のことを実行してみてください。

- コマンド入力を検証し、必要に応じて修正します。入力しているコマンドのスペルと選択したオプションについて確認してください。

注意:
OPMNまたはシステム・コンポーネントを起動するために、旧バージョンのOracle Application ServerやOracle Fusion Middlewareのコマンドライン・スクリプトまたはユーティリティを使用しないでください。

- 現在ではほとんどの管理対象プロセスには独自のログ・ディレクトリがあり、そのディレクトリがプロセス・ログ・ファイルの場所である場合は、OPMNはそのディレクトリを使用します。

ORACLE_INSTANCE/diagnostic/logs/<type>/<ias-component>/

管理対象プロセスのデフォルトのディレクトリが存在しない場合は、OPMNは次の独自のログ・ディレクトリにコンソール・ログを格納します。

ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/

たとえば、Oracle HTTP Serverの標準出力ログは、ORACLE_INSTANCE/diagnostics/logs/OHS/ohs1/console~OHS~1.logのようになります。

- 起動しようとしているシステム・プロセスの依存性要件を検証します。

- opmn.xmlファイル内のシステム・コンポーネントの要素値を検証します。opmnctl validateコマンドを使用して、opmn.xmlファイルの構成を検証してください。起動しようとしているシステム・コンポーネントのopmn.xmlが正しく構成されていない場合もあります。

B.1.2 システム・プロセスに障害が発生または応答なしの状態になっているかどうかを判断する

問題点

システム・プロセスが障害でダウンしているか、接続不能になっています。

ソリューション

システム・プロセスが障害でダウンしているか、接続不能になっている場合は、次のことを実行してみてください。

- ORACLE_INSTANCE/diagnostics/logs/OPMN/opmnにあるシステム・コンポーネント固有の出力を確認します。
ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.logを参照してシステム・プロセスを探します。process crashedまたはprocess unreachableメッセージを探します。OPMNは、障害が発生または応答なしの状態になっているシステム・プロセスを自動的に再起動します。

関連項目:
OPMNログ・ファイルの詳細は、第B.2.1項を参照してください。

- 停止前またはクラッシュ後のイベントのイベント・スクリプトを作成します。イベント・スクリプトを使用すれば、特定のログ・ファイルを作成したり、障害に関する情報を電子メールで送信したりすることができます。

関連項目:
イベント・スクリプトを使用したトラブルシューティングの詳細は、第B.2.4項を参照してください。

B.1.3 opmnctlコマンド実行のタイムアウト

問題点

opmnctlコマンドの実行にかかる時間は、システム・プロセスのタイプおよび使用可能なコンピュータ・ハードウェアによって異なります。そのため、opmnctlコマンドの実行にかかる時間は、簡単には判断できません。

ソリューション

opmnctlコマンドが正常に実行されていることを検証するには、次のことを実行してみてください。

1. 起動していないコンポーネントのstart要素のtimeout属性値を大きくします。opmn.xmlファイルに記述されているタイムアウトを、プロセスが起動するまでOPMNが待機できるレベルに設定します。この機能は、startprocコマンドで使用できます。このコマンドは、opmn.xml内に構成されているすべての関連プロセスを起動するものです。

2. opmn.xmlファイル内のstart要素をチェックして、retry属性をより大きな時間増分値に変更します。

3. ORACLE_INSTANCE/diagnostics/logs/を参照して、起動していないシステム・プロセスがないか確認します。

4. 起動していないシステム・コンポーネントのコンポーネント固有のログ・ファイルを確認します。たとえば、ORACLE_INSTANCE/diagnostics/logs/OHS/ohs1/console~OHS~1.logを確認します。

関連項目:
opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。

B.1.4 システム・コンポーネントがOPMNによって自動的に再起動される

問題点

システム・コンポーネントがOPMNによって自動的に再起動されます。

ソリューション

システム・コンポーネントがOPMNによって自動的に再起動される場合は、次のことを実行してみてください。

- ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.logファイルに記録されているシステム・コンポーネントのメッセージを確認します。

- システム・コンポーネントのpingタイムアウト時間が十分な長さであることを確認します。多くのアクティビティを受け取るシステム・コンポーネントについては、タイムアウトの時間を長くする必要がある場合もあります。システム・コンポーネントのopmn.xmlファイルで、pingタイムアウト要素値を大きくします。

B.1.5 opmnctl startの予想外の動作

問題点

場合によっては、opmnctl startコマンドを使用してOPMNを起動すると予想外の動作が発生します。たとえば、OPMNだけが起動されたり、OPMNがシステム・プロセスを起動しようとしたりします。通常、この予想外の動作は、まずOPMNを停止しないでコンピュータの電源を切ったり再起動したりすることに起因します。コンピュータを再起動すると、すべてのシステム・コンポーネント・プロセスが起動されます。

ソリューション

OPMNを停止してから、コンピュータをシャットダウンすることをお薦めします。OPMNおよびシステム・コンポーネント・プロセスを停止するには、opmnctl stopallコマンドを使用します。

Microsoft Windowsオペレーティング・システムでは、Windowsサービスのコントロール パネルを使用して、OPMNとシステム・コンポーネントを停止できます。

注意:
OPMNは、管理されるプロセスの予想ステータスをディスクに記録します。OPMNの稼働中にコンピュータが停止した場合、再起動時にOPMNは、ディスクにキャッシュされていた情報を使用して、システムの停止時に実行されていたプロセスをすべて自動的に再起動しようとします。そのため、OPMNのみを起動するつもりで、OPMNが管理するプロセスを起動する明示的なリクエストを発行していなくても、それらのプロセスも起動されてしまっている場合があります。
この自動プロセス・リカバリを無効にするには、opmn.xmlファイルでprocess-manager要素の次の属性を設定します。

restore-procs-on-reboot="true"

B.1.6 opmn.xmlファイル内の無効な要素

問題点

システム・プロセスを起動することができません。

ソリューション

システム・プロセスを起動できない場合は、システムのopmn.xmlファイル内の要素がdisabledになっているかどうかを確認してください。opmn.xmlファイルの要素がdisabledである場合、OPMNは、"Missing"または"Disabled"という出力メッセージを生成します。

B.1.7 OHSを起動できない

問題点

1台のホストに複数のOracle Fusion Middlewareをインストールしており、それらを同時に起動しようとすると（たとえばファームを起動するために）、OPMNが応答しなくなる場合があります。この場合、次のようなエラー・メッセージが表示されます。

"failed to restart a managed process after the maximum retry limit"

この問題は、同一ホスト上の2つのOracleインスタンスが同じポートを使用する場合に発生することがあります。一方のOracleインスタンス内のOHSコンポーネントが、他方のOracleインスタンス内のOHSコンポーネントと同じポートを使用しようとするためです。同一ホスト上の2つのOPMNプロセスが同時に起動された場合、これらのプロセスの間でポートの使用に関する調整は行われません。Oracle Fusion Middleware内のすべてのOHSインスタンスに対するポートの割当てはOPMNによって制御されるため、単一のopmn.xmlファイル内で重複するポート範囲が存在する可能性があります。しかし、1つのホスト上で2つのOPMNプロセスが同時に起動された場合、そのプロセス間でポートの使用に関する調整は行われません。

ソリューション

各Oracleインスタンス内のOHSに割り当てられるポートが重複しておらず、コンピュータ上の他のどのプロセスによっても使用されていないことを確認してください。

また、Oracleインスタンス起動の最大再試行回数を増やすこともお薦めします。2つのOracleホームで同一のポート範囲を割り当てている場合に、OPMNによるプロセス再起動の試行回数を大きくすることで、OPMNでは最終的に空きポートが選択されます。ただし、opmn.xmlファイルで指定したポート接続試行回数ではOPMNが空きポートを見つけられない可能性もあるため、この方法で問題が完全に解決されるわけではありません。

B.1.8 コンポーネントを停止できない

問題点

opmnctl stopコマンドまたはopmnctl stopallコマンドを使用してシステム・コンポーネントを停止できない場合は、そのコンポーネントまたはプロセスは、OPMNを使用して起動されていない可能性が高いと考えられます。そのコンポーネントまたはプロセスは、起動スクリプトまたはユーティリティを使用して起動された可能性があります。

ソリューション

どのような場合でも、システム・コンポーネントを手動で起動したり停止したりしないでください。システム・コンポーネントを起動および停止するために、旧バージョンのOracle Application ServerやOracle Fusion Middlewareのコマンドライン・スクリプトまたはユーティリティを使用しないでください。

システム・コンポーネントを起動および停止するには、Fusion Middleware Controlコンソールとopmnctlコマンドライン・ユーティリティを使用します。

関連項目:
OPMNコマンドラインの例は、第5章を参照してください。

B.1.9 globalInitNLSエラー

問題点

opmnctlコマンドを実行すると、globalInitNLSエラーが発生する場合があります。次のエラー・メッセージが表示されます。

"globalInitNLS: NLS boot file not found or invalid -- default linked-in boot block used XML parser init: error 201."

ソリューション

このエラーは、ORA_NLS33環境変数が設定されている場合に発生します。この環境変数は、設定しないでください。

B.1.10 OPMNの起動時にCPU使用率が増加する

問題点

一部のコンピュータでは、OPMNの起動時にCPU使用率が大幅に上昇します。コンピュータのCPU使用率は約50〜60%に変化することがあります。対象となるコンピュータでは、OPMNが停止されるまでCPU使用率は上昇し続けます。

ソリューション

CPU使用率が大幅に上昇する原因の1つとしては、インストール環境で日本語などのマルチバイト・テキスト文字セットが使用されていることが考えられます。

B.1.11 OPMN起動時にエラー・メッセージが表示される

問題点

opmnctl startまたはopmnctl startallコマンドを使用してOPMNを起動しようとすると、次のエラー・メッセージが表示されます。

pingwait exits with 1220384

または

pingwait exits with 1220396

これらのエラー・メッセージは、ORACLE_INSTANCE/config/OPMN/opmn/opmn.xml内に修正が必要な構文エラーがあると生成されます。

ソリューション

これらのエラー・メッセージが表示された場合は、次の操作を行います。

- 次のコマンドを実行します（opmn.xmlファイルへの完全なディレクトリ・パスを使用する）。

opmnctl validate opmn.xml

- opmn.xmlファイルから、空のタグをすべて削除します。

B.1.12 opmn.logファイルのサイズが増える

問題点

すでにOracle DatabaseまたはOracle Fusion MiddlewareがインストールされているコンピュータにOracle Fusion Middlewareをインストールすると、ロギングが継続的に実行されるために、ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/opmn.logファイルのサイズが増加して4100000KBを超えます。このファイルには、次のエラー・メッセージが記録されます。

"[ons-connect] Local connection 127.0.0.1,6100 invalid form factor "

ソリューション

opmn.xmlファイルのリクエスト・ポートを6100よりも大きな値に変更してください。次に例を示します。

<port local ="6202" remote="6302" request="6105"/>

このエラーの原因は、ほとんどの場合、同一コンピュータ上にすでにインストールされているOracle DatabaseまたはOracle Fusion Middlewareとの競合です。このエラーの発生は、Oracle DatabaseまたはOracle Fusion Middlewareの既存のインストールまたは以前のインストールのoraInventoryディレクトリ内のエントリに起因します。

B.1.13 不適切な状態にあるOracleインスタンスまたはコンポーネントのクリーンアップ

問題点

Oracleインスタンスまたはコンポーネントによって、opmnctlコマンドの間違ったデフォルト値がいくつか割り当てられています。

ソリューション

opmnctl deleteinstanceコマンドを-force trueオプションで実行して、Oracleインスタンスまたはコンポーネントをクリーンアップしてください。

次に例を示します。

opmnctl deleteinstance -oracleInstance /scratch/bsong/demo1/inst1 -instanceName inst1 \ -adminHost myhost -adminPort myport -force true

-forceオプションは注意して使用してください。opmnctl deleteinstanceコマンドでこのオプションを使用すると、Oracleインスタンスまたはコンポーネントの整合性を保護するためのいくつかの安全上の仕組みが無効化されます。このオプションを不適切に使用すると、問題が発生することがあります。

すべての適用可能な引数（oracleInstance、instanceName、adminHost、adminPortなど）をopmnctl deleteinstanceコマンドで明示的に指定すると、望ましい結果が得られる可能性があります。

クリーンアップの実行時、forceオプションを使用したコマンドにより、Oracleインスタンスまたはコンポーネントの破損状態に応じた警告や例外が表示されます。これらの警告は、検出された不一致に対する視覚的なフィードバックとして表示されるものであり、さらに修正処置が必要であることを必ずしも示しているわけではありません。

B.1.14 引用符を含むパス引数をWindowsオペレーティング・システムで使用する場合

問題点

opmnctlに指定されたパス引数に引用符（"）が含まれていると、最初の引用符の後に続くすべての部分（opmn用のその他のフラグも含む）がORACLE_INSTANCEの名前になります。この問題は、Windowsオペレーティング・システムの場合にのみ発生します。

次に例を示します。

opmnctl createinstance -oracleInstance %T_WORK%\"inst1" -adminRegistrationOFF

この例では、ORACLE_INSTANCEの名前は次のようになります。

inst1-adminRegistration OFF

ソリューション

引数またはコマンド全体を引用符で囲んでください。

次に例を示します。

opmnctl createinstance "%T_WORK%\inst1" -adminRegistration OFF

修正された例では、ORACLE_INSTANCEの名前は次のようになります。

inst1

B.2 OPMNの問題の診断

OPMNの使用に際して発生する可能性のある問題のトラブルシューティングには、いくつかの方法があります。

- OPMNログ・ファイル

- opmnctl debug

- Oracle Enterprise Manager Fusion Middleware Controlコンソール

- イベント・スクリプトを使用したトラブルシューティング

- opmn.xmlの環境変数

B.2.1 OPMNログ・ファイル

OPMNログ・ファイルにより、OPMNおよびシステム・コンポーネント・プロセスの実行と使用に際して発生する可能性のある問題のトラブルシューティングを行うことができます。OPMNおよびシステム・コンポーネント・プロセスは、処理時にログ・ファイルを生成します。生成される次のログ・ファイルを確認して、OPMNコマンドの実行に成功したか、または失敗したかを検証できます。

- ORACLE_INSTANCE/diagnostics/OPMN/opmn/opmn.out: OPMNの標準出力（stdout）および標準エラー（stderr）のログが記録されています。OPMNのコンソール・ログとも呼ばれます。OPMNの特定の初期化ポイント以降は、このファイルには他に何も書き込まれません。少数のメッセージ群のみがこのファイルに書き込まれます。したがって、ログ・ファイルのディレクトリに対して検索を実行した場合、このファイルが存在しないこともあります。

- ORACLE_INSTANCE/opmn/logs/opmn.log: コマンドの実行と動作の進行状況を追跡します。OPMNサーバーの動作を監視するうえで有益なメッセージが収められています。opmn.logファイルに書き込まれた出力には、OPMNの子プロセスの終了ステータスが含まれます。ステータス・コードが4の場合は、OPMNが正常に再ロードされたことを示します。他のステータス・コードはすべて、OPMNの子プロセスが異常終了したことを示します。opmn.logファイルは、opmn.xmlファイルに記述されている<log>属性を使用して構成されます。opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。

- ORACLE_INSTANCE/diagnostics/logs/OPMN/opmn/debug.log: 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ファイル内のメッセージは通常、ユーザーに簡単に理解できるものではありません。

B.2.1.1 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が初期化ポイントを超えた後は、出力はコンソールの出力ファイルに書き込まれなくなるため、このファイルに記録されるメッセージ群は少なくなります。

B.2.1.2 プロセス・コンソールのログ・ファイル・ローテーション

プロセスが起動すると、コンソールの既存のログ・ファイルが管理対象プロセスに渡される前に、OPMNが、構成された制限（<log>タグのrotation-size属性）と突き合せてサイズをチェックします。ファイル・サイズがこの制限を超えると、OPMNによって既存ファイルの名前がタイムスタンプ付きの名前に変更されてから、その管理対象プロセスの新しいファイルが作成されます。rotation-size属性が構成されていない場合、OPMNは、プロセス・コンソールのログ・ファイルのローテーションを行うことができません。

B.2.2 opmnctl debug

システム・プロセスのステータスおよび保留中の操作の有無を確認するには、opmnctl debugコマンドを使用します。このコマンドは、最寄りのOracleサポート・サービスに問い合せる際に使用できる、OPMNの問題の診断に役立つ出力を生成します。

opmnctl debugコマンドの構文は、次のとおりです。

opmnctl debug [comp=pm|ons] [interval=<secs> count=<num>]

出力は、opmnctl debugコマンドの実行後に生成されます。生成された出力を問題の診断に役立てる際に、Oracleサポート・サービスに問い合せることをお薦めします。

このコマンドの属性（<attr>）名は、comp、intervalまたはcountのいずれかです。compの値は、onsまたはpmのいずれかで、それぞれONSとPMを表します。compが指定されていない場合、onsとpmの両方のデバッグ情報がレポートされます。たとえば、次のコマンドでは、ONSのデバッグ情報が出力されます。

opmnctl debug comp=ons

OPMNに送信されるリクエストの間隔（秒単位）と数を指定して、デバッグ・プロセスを支援できます。<interval>および<count>の値は、常に両方とも指定する必要があります。それらの値は0よりも大きな整数にしてください。たとえば、次のコマンドでは、5秒間隔で3回デバッグ情報が出力されます。

opmnctl debug comp=pm interval=5 count=3

最寄りのOracleサポート・サービスに問い合せ、opmnctl debugコマンドを使用してOPMNの問題の診断に役立てください。

B.2.3 Oracle Enterprise Manager Fusion Middleware Controlコンソール

Fusion Middleware Controlコンソールのグラフィカル・インタフェースを使用して、ネットワークや企業内のシステム・コンポーネントを診断できます。Fusion Middleware Controlコンソールでは、ログ・ページが用意されています。ログ・ページでは、1つの場所にすべてのシステム・ログ・ファイルを表示し、複数のログ・ファイルにわたって問題をトレースすることが可能です。Fusion Middleware Controlコンソールは、OPMNと通信するAPIを使用します。

関連項目:
『Oracle Fusion Middleware管理者ガイド』

B.2.4 イベント・スクリプトを使用したトラブルシューティング

システム・プロセスのイベント・アクティビティを記録する、ユーザー独自のイベント・スクリプトを作成できます。システム・プロセスの起動または停止の前のイベントや、予定外のシステム・クラッシュを記録するスクリプトを作成できます。

第6章のevent-scripts要素の説明を参照してください。

例B-1は、起動前のイベント・スクリプトを示しています。

例B-1 起動前のイベント・スクリプト

#!/bin/sh
echo
echo =---===----======---=-----=-----=------======----===---=
echo =---===----===== PRE-START EVENT SCRIPT =====----===---=
echo =---===----======---=-----=-----=------======----===---=

timeStamp="N/A"
instanceName="N/A"
componentId="N/A"
processType="N/A"
processSet="N/A"
processIndex="N/A"
stderrPath="N/A"  # not available w/pre-start unless part of restart
stdoutPath="N/A"  # not available w/pre-start unless part of restart
reason="N/A"
pid="N/A"         # only available with pre-stop, post-crash
startTime="N/A"   # only available with pre-stop, post-crash

while [ $# -gt 0 ]; do
case $1 in
-timeStamp)    timeStamp=$2; shift;;
-instanceName) instanceName=$2; shift;;
-componentId)  componentId=$2; shift;;
-processType)  processType=$2; shift;;
-processSet)   processSet=$2; shift;;
-processIndex) processIndex=$2; shift;;
-stderr)       stderrPath=$2; shift;;
-stdout)       stdoutPath=$2; shift;;
-reason)       reason=$2; shift;;
-pid)          pid=$2; shift;;
-startTime)    startTime=$2; shift;;
*) echo "Option Not Recognized: [$1]"; shift;;
esac
shift
done

echo timeStamp=$timeStamp
echo instanceName=$instanceName
echo componentId=$componentId
echo processType=$processType
echo processSet=$processSet
echo processIndex=$processIndex
echo stderr=$stderrPath
echo stdout=$stdoutPath
echo reason=$reason
echo pid=$pid
echo startTime=$startTime

注意:
起動前のイベント・スクリプト例である例B-1は、Microsoft Windowsオペレーティング・システムでは機能しません。ただし、同様の機能を持つ.bat拡張子付きのスクリプトを作成できます。
必要な構成情報をopmn.xmlファイルに追加するときには、.batファイルへのフルパスを使用します。

B.2.5 opmn.xmlの環境変数

OPMNサーバーの起動に使用される環境変数は、OPMNサーバーによって起動されるシステム・プロセスによって継承されません。OPMNは、ias-instanceレベルにこの環境変数を設定しますが、その際に、値はias-instance構成またはOPMNランタイム環境から抽出されます。

関連項目:
opmn.xmlファイルの一般的な構成の詳細は、第6章を参照してください。

B.3 その他のヘルプ情報

さらに多くのソリューションが、Oracle MetaLink（http://metalink.oracle.com）にあります。問題点に対するソリューションが見つからない場合は、サービス・リクエストをログに記録してください。

関連項目:

- Oracle Fusion Middlewareのリリース・ノート（次のOracle Technology NetworkのWebサイトで入手できます）
http://www.oracle.com/technology/documentation/

索引

A  C  D  E  F  H  I  J  L  M  N  O  P  Q  R  S  T  U  V  W

A

Application Server Control, 2.1, 4.3.2.1, B.2.3

async, 4.3.1.2, 4.3.3.1

属性名, 4.3.3.1

属性の構文, 4.3.1.2

C

cache-timeout, 6.2

cache-timeout属性, 6.2

category要素, 6.2

clu, 4.3.5.1.1

cmp, 4.3.5.1.1

command, 4.1.1

コマンド定義

opmnctl, 4.3.1

comp属性, 4.3.5.5.1 comp-codes, 6.2 完全構成

カスタム・プロセス, A.3

コンポーネントのコード、ONS, 6.2 コンポーネントのコード、PM, 6.2 component-id, 6.2 count, B.2.2 cpu, 4.3.5.1.1 cron, 6.2 custom id, A.4 カスタム・モジュール

ping, A.3.1

CUSTOM module-id, A.4 カスタム・プロセス

完全構成, A.3

最小構成, A.2

カスタム・プロセス・モジュール, A.1

D

data要素, 6.2

database element, 6.2

db-connect-info, 6.2

debug, 6.2

dependencies要素, 6.2

dmsdump

opmnctl, 4.3.5.3

E

enabled, 6.2

environment要素, 6.2

イベント・スクリプトの引数, 6.2

イベント・スクリプト, B.2.4

event-scripts要素, 6.2

要素の例, 6.1

F

-fmtオプション, 4.3.5.1.1

fmtlist, 4.3.5.1.1

-fmtlist構文, 4.3.5.1.1

フォーム・ファクタ鍵, 3.4

.formfactorファイル, 3.4

fpr, 4.3.5.1.1

-fsepオプション, 4.3.5.1.1

H

help

opmnctl, 4.2, 4.3.6.1

HTTP ping, A.3.1

I

ias-component, 4.3.3, 4.3.3.1

ias-component要素, 6.2

ias-component-id, 6.2

ias-instance属性, 6.2

ias-instance要素, 6.2

ias-instance-id, 6.2

idx, 4.3.5.1.1

infrastructure, 6.2

infrastructure-key, 6.2

ins, 4.3.5.1.1

insecure-remote-requests, 6.2

interface, 6.2

interval, B.2.2

io-idle, 6.2

io-timeout, 6.2

ipaddr要素, 6.2

IPv4, 3.5

IPv6, 3.5

J

justification, 4.3.5.1.1

L

-lオプション, 4.3.5.1.1

log, 6.2

ログ・ファイル

OPMN, B.2.1

ログ・ページ, B.2.3

M

managed-process要素, 6.2

max_retry, 4.3.5.4

maxprocs, 6.2

mem, 4.3.5.1.1

最小構成

カスタム・プロセス, A.2

minprocs, 6.2 mode, 4.3.3.1 module, 6.2 module要素, 6.2 module-data要素, 6.2 module-id要素, 6.2 modules

PM, 2.2.3

N

-noheadersオプション, 4.3.5.1.1

notification-server要素, 6.2

numprocs, 6.2

O

OID要素, 6.2

ONS, 6.2, 6.2

ONS（Oracle Notification Server）, 2.2.1

ONSコンポーネントのコード, 6.2

openssl-certfile, 6.2

openssl-keyfile, 6.2

openssl-lib, 6.2

openssl-password, 6.2

OPMN, 2.1, 2.2, 2.3

機能, 2.1

ログ・ファイル, B.2.1

OPMNデーモン, 4.3.2.2, 4.3.3.1 OPMNローカル・リスナー・ポート, 3.4 OPMNログ・ファイル, 3.3 opmnctl, 2.1, 4.1, 4.3, 4.3.2.1

help, 4.2, 4.3.6.1

options, 4.3.5.1.1

ping, 4.3.5.4

プロセス制御コマンド, 4.3.3

クイック・リファレンス, 4.2

stopall, 4.3.2.4

構文, 4.1.1

usage, 4.3.2.4, 4.3.2.5

validate, 4.3.6.3

opmnctlの属性, 4.3.1.2 opmnctlコマンド定義, 4.3.1 opmnctlコマンド, 4.2 opmnctl debug, B.2.2 opmnctl dmsdump, 4.3.5.3 opmnctl metric, 4.3.5.2 opmnctl query, 4.3.5.6 opmnctl reload, 4.3.2.4, 4.3.2.5, 4.3.2.6 opmnctl restartproc, 4.3.3.1 opmnctl set, 4.3.5.5 opmnctl shutdown, 4.3.2.5 opmnctl start, 4.3.2.2 opmnctl startall, 4.3.2.3 opmnctl startproc, 4.3.3.1 opmnctl statusの構文, 4.3.5.1 opmnctl stopproc, 4.3.2.4, 4.3.2.5, 4.3.3.1 opmnctl usage status, 4.3.5.1 opmnctl usageの構文, 4.3.6.2 opmnctl validate, B.1.1 opmnctl verboseの構文, 4.3.1.3 opmn.xmlファイル, 2.2.2, 3.1, 3.1 オプション

-fmt, 4.3.5.1.1

-fsep, 4.3.5.1.1

-l, 4.3.5.1.1

-noheaders, 4.3.5.1.1

-rsep, 4.3.5.1.1

options, 4.1.1

opmnctl, 4.3.5.1.1

Oracle Enterprise Manager Application Server Control, 2.3.1 Oracle Identity Managementのインストール, 2.1 Oracleインスタンス, 2.1 Oracle Notification Server、「ONS」を参照 Oracle Portal、Forms、Reports、およびDiscovererのインストール, 2.1 Oracle Process Manager Modules、「PMモジュール」を参照, 2.2.3 Oracle Process Manager、「PM」を参照, 2.2.2 OSSO要素, 6.2

P

path, 6.2, 6.2

pid, 4.3.5.1.1

ping

カスタム・モジュール, A.3.1

opmnctl, 4.3.5.4

ping要素, 6.2 pingのタイムアウト, B.1.4 ping-host id, A.4 ping-limit id, A.4 ping-parameters id, A.4 ping-port id, A.4 ping-timeout id, A.4 ping-type id, A.4 ping-url id, A.4 PM, 2.2.2 PMコンポーネントのコード, 6.2 PMモジュール, 2.2.3 PMモジュール, 3.1 por, 4.3.5.1.1 port要素, 6.2, 6.2 post-crash要素, 6.2 pre-stop要素, 6.2 プロセス制御コマンド

opmnctl, 4.3.3

process crashed, B.1.2 プロセス・モジュール

カスタム, A.1

process unreachable, B.1.2 process-conversion, 6.2 process-manager要素, 6.2 process-modules要素, 6.2 process-set, 4.3.3, 4.3.3.1 process-set要素, 6.2 process-set-id, 6.2, 6.2 process-set-id属性, 6.2 process-type, 4.3.3, 4.3.3.1 process-type id属性, 6.2 process-type-id, 6.2 漸進的なリクエスト・レポート, 4.3.3.2 prs, 4.3.5.1.1 prt, 4.3.5.1.1 パブリッシュ・サブスクライブ・モデル, 2.2.1

Q

query

opmnctl, 4.3.5.6

クイック・リファレンス

opmnctl, 4.2

R

ready-parameters id, A.4

reload

opmnctl, 4.3.2.4, 4.3.2.5, 4.3.2.6

remote, 6.2 request, 6.2 restart要素, 6.2 restart-args id, A.4 restart-executable id, A.4 restartproc

opmnctl, 4.3.3.1

rotation-hour, 6.2 rotation-size, 6.2 -rsepオプション, 4.3.5.1.1

S

スクリプトping, A.3.1

script-args id, A.4

script-executable id, A.4

順次リクエスト, 4.3.3.3

set

opmnctl, 4.3.5.5

shutdown

opmnctl, 4.3.2.5

SSL, 3.4, 6.2 SSL要素, 6.2, 6.2 sta, 4.3.5.1.1 start

opmnctl, 4.3.2.2

start要素, 6.2, B.1.3 startall

opmnctl, 4.3.2.3

start-args id, A.4 start-executable id, A.4 OPMNの起動, 5.1 startproc

opmnctl, 4.3.3.1

statname, 4.3.5.1.1 status

opmnctl, 4.3.5.1

stm, 4.3.5.1.1 stop要素, 6.2 stopall

opmnctl, 4.3.2.4

stop-args id, A.4 stop-executable id, A.4 stopproc

opmnctl, 4.3.2.4, 4.3.2.5, 4.3.3.1

sync, 4.3.1.2, 4.3.3.1 構文

opmnctl ping, 4.3.5.4

構文, 4.3.1.2

属性, 4.3.1.2

-fmtlist, 4.3.5.1.1

opmnctl, 4.1.1

opmnctl help, 4.3.6.1

opmnctlのオプション, 4.3.5.1.1

opmnctl reload, 4.3.2.6

opmnctl restartproc, 4.3.3.1

opmnctl shutdown, 4.3.2.5

opmnctl start, 4.3.2.2

opmnctl startall, 4.3.2.3

opmnctl startproc, 4.3.3.1

opmnctl status, 4.3.5.1

opmnctl stopall, 4.3.2.4

opmnctl stopproc, 4.3.3.1

opmnctl usage, 4.3.6.2

opmnctl validate, 4.3.6.3

opmnctl verbose, 4.3.1.3

構文と値, 4.3.1.2

T

tag-id, 6.2

timeout, 4.3.1.2, 4.3.3.1

timeout属性, 6.2, B.1.3

timeout値, 4.3.2.3

timeout="depend-timeout", 6.2

tune, 6.2

typ, 4.3.5.1.1

U

uid, 4.3.5.1.1, 4.3.5.1.1

uniqueid, 4.3.1.2, 4.3.3.1, 4.3.5.1.1

usage

opmnctl, 4.3.2.4, 4.3.2.5, 4.3.6.2

use-ping-for-ready id, A.4 utm, 4.3.5.1.1

V

validate

opmnctl, 4.3.6.3

値, 4.3.1.2 値と構文, 4.3.1.2 variable要素, 6.2 verbose, 4.1.1

opmnctl, 4.3.1.3

W

wallet-file, 6.2, 6.2

wallet-password, 6.2, 6.2

Web Tierのインストール, 2.1

width, 4.3.5.1.1

working-dir, 6.2

working-dir属性, 6.2

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.