E Oracle Harvesterを使用したOCMデータの収集
My Oracle Supportでは、カスタマによるOracleサポートの利用を大幅に促進する一連の機能が提供されています。My Oracle Supportでは、カスタマの構成固有のコンテキスト内情報の他、予防的なサポートも提供することで、サービス・リクエストの発行プロセスを合理化しています。My Oracle Supportのこれらの機能を有効にするには、カスタマの構成情報をOracleにアップロードする必要があります。構成データが定期的にアップロードされると、カスタマ・サポート担当者はこのデータを分析してカスタマによりよいサービスを提供できます。
構成データを収集し、Oracleにアップロードするために、次のメカニズムが提供されています。
-
Oracle Enterprise Manager Harvester (Oracle Harvester)
-
Oracle Configuration Manager(OCM)
具体的には、次のとおりです。
-
Oracle Configuration Managerは、Oracle製品のインストール時に自動的にインストールおよび構成されます。
各製品をインストールする際、最初の画面でMy Oracle Supportの資格証明が求められます。これは、インストールにおいてきわめて重要な画面です。指定するユーザー名とパスワードは、構成データがOracleにアップロードされる際に使用される資格証明になります。
-
24時間ごとに構成の収集が実行され、構成データがアップロードされます。
-
データがアップロードされた後は、製品のインストール時に指定した資格証明を使用して、My Oracle Support (
https://support.oracle.com
)にログインしデータを参照できます。
注意: Enterprise Managerを使用してアプリケーションを管理している場合、構成のOracleへのアップロードには、Oracle Harvesterを使用することをお薦めします。それ以外の場合は、OCMを使用してください。
次の項では、次のトピックの情報を提供します。
Oracle Harvester
Oracle Harvesterでは、Enterprise Managerによって管理されているターゲットのデータのみが収集されます。Oracle Harvesterは同じOCM依存性のため、Oracle Harvesterを使用すると、Enterprise Managerの収集メソッドを利用してターゲットの構成データを収集できます。このため、Oracle Harvesterが管理するターゲットのホームにOCMをインストールする必要がありません。次の項目について説明します。
Oracle Harvesterの特徴
Oracle Harvesterの特徴は次のとおりです。
-
すべてのターゲットのデータは、Oracle Management Service (OMS)ホームのOCMが構成されている資格証明と同じ資格証明に対してデフォルトでアップロードされます。Enterprise Manager Cloud Controlで、CSI割当てページからCSIを割り当てて、ターゲットのこのデフォルト値を変更できます。「設定」、「My Oracle Support」の順にクリックして開始します。
-
Enterprise ManagerのOMSホームでOCMが構成済で実行中である必要があります。
-
管理リポジトリからターゲットの構成データを収集します。
-
定期的に自動実行されるため、ユーザーが操作する必要はありません。
Oracle HarvesterとOCM
Enterprise Managerのインストール時、Oracle HarvesterおよびOracle Configuration Manager (OCM)が、必要なサブコンポーネントと同じく自動的にインストールされます。Oracle Harvesterは、OMSホームのOCMが構成および実行されているかぎり実行されます。
OCMがOMSのOracleホームで有効化され、OMSのインスタンス・ホームで構成(および接続モードで実行)されている必要があります。これはORACLE_CONFIG_HOME
が設定されていない場合、Oracle OMSターゲットがOCMコレクタによって検出されないためです。
次のステップを実行して、Oracle OMSターゲットが検出されるようにします。
Oracle Configuration Manager (OCM)の詳細は、『Oracle Configuration Managerインストレーションおよび管理ガイド』を参照してください。
または、OCMドキュメント・ライブラリを参照します。
http://docs.oracle.com/cd/E49269_01/index.htm
Enterprise Managerのサポート
デフォルトでは、すべてのターゲットが、OMSホームのOracle Configuration Managerの登録に使用した資格証明を使用してアップロードされます。Enterprise Managerでは、各ターゲット・ホームにカスタマ・サポートID (CSI)を割り当てるオプションがあります。
Oracle Harvesterは、各Oracleホームのそれぞれ異なるCSIへの構成データのアップロードをサポートしています。
ステップは次のとおりです。
-
Oracle Harvesterが実行されていることを確認します。このジョブは自動的に実行されます。実行のステータスは、「サポートID割当て」ページからモニターできます。Enterprise Managerのホームページからこのページにアクセスするには、「設定」を選択し、次に「My Oracle Support」を選択します。メニューから「サポートID割当て」を選択します。
-
My Oracle Supportの優先資格証明を設定します。Enterprise Managerのホームページで「設定」を選択し、次に「My Oracle Support」を選択します。メニューから「資格証明の設定」を選択し、有効なMy Oracle Supportの資格証明を指定します。
-
サポートIDを割り当てます。
-
Enterprise Managerのホームページで「設定」を選択し、次に「My Oracle Support」を選択します。「サポートID割当て」を選択し、正しいユーザー名とパスワードを指定します。Select Set credentials.
-
「ホーム」を選択します。「割当て」ボタンをクリックします。「CSI」を選択し、「OK」をクリックします。
-
-
割当てが成功したことを示すメッセージが表示されることを確認します。メッセージは次のとおりです。
Support Identifier has been assigned for 1 Oracle homes. The changes in the Customer Support Identifiers will be reflected in My Oracle Support after the next Harvester run.
Enterprise ManagerでのCSIの表示
ターゲットに関連付けられているCSIを確認するには、ターゲットのプロパティを表示するか、または検索条件にCSIを設定して構成検索を行います。特定のOracleホームのすべてのターゲットに対してオペレータ権限を持つユーザーは、そのOracleホームに対するCSIを割り当てることができます。
注意:
スーパー管理者は、任意のOracleホームにCSIを割り当てることができます。管理者は、すべてのターゲットでオペレータ権限を持つOracleホームにCSIを割り当てることができます。
詳細は、Enterprise Managerインタフェース上のヘルプを参照してください。
Enterprise Manager UIには、CSIを表示できる領域は多数あります。
-
Oracleホーム・ターゲット・ホームページ。
-
Enterprise Managerホームページから「ターゲット」を選択し、ターゲットを選択します。
-
「検索の絞込み」領域で、「その他」、選択する「Oracleホーム」の順に選択します。
-
「Oracleホーム」ターゲット・ページで、ターゲットのドロップダウン・メニューから「ターゲット情報」選択します。
-
-
別の方法として、検索するCSIの追加による方法があります。
-
Enterprise Managerホームページから「ターゲット」、構成検索基準へのCSIの追加、「プロパティの追加」の順に選択します。
-
Enterprise ManagerからのHarvesterターゲット・ライフサイクル・プロパティ
Oracle Harvesterには、たとえばデプロイ、テストなどのターゲットの目的を識別できるターゲット・ライフサイクル・プロパティが用意されています。
一度定義されると、Oracle Harvesterはすべてのターゲットに対するターゲット・ライフサイクル・プロパティを収集し、そのプロパティをOracle Configuration Managerサーバーにアップロードします。
ターゲット・ライフサイクル・プロパティは、Enterprise ManagerのUIまたはMy Oracle SupportのUIのいずれかの任意のターゲットに割り当てることができます。
ターゲットのライフサイクル・プロパティの可能な値は、次のとおりです。
-
Mission Critical
-
本番
-
ステージング
-
テスト
-
開発
ハーベスタ・ジョブ・ステータス・メトリック
Enterprise Manager Cloud Control 12cリリース12.1.0.3およびOCM 10.3.8.1.0から、OMSおよびリポジトリのターゲットにハーベスタ・ジョブ・ステータス・メトリックが追加されました。このメトリックでは、ハーベスタのジョブに関連する情報が提供されます。このメトリックの一部として次の情報が収集されます。
-
ハーベスタ・ステータス: 最後に実行したハーベスタ・ジョブのステータスが示されます。可能な値は次のとおりです。
-
SUCCESS: ジョブが正常に実行されたことを示します。
-
ERROR: ジョブが失敗した場合に返されます。
-
NOT CONFIGURED: OCMが構成されていないことを示します。
-
NOT AUTHENTICATE: OCMは構成されていますが、認証モードではありません。
-
-
ハーベスタ・エラー: ハーベスタ・ジョブの実行が失敗した場合にエラー・メッセージを示します。
-
最終ハーベスタ・ジョブ実行: 最後のハーベスタ・ジョブが実行された時間を示します。
-
次のハーベスタ・ジョブ実行: 次に実行するハーベスタ・ジョブの時間を示します。
-
処理されたターゲット合計数: 最後の実行の間にハーベスタ・ジョブにより処理されたターゲットの数を示します。
-
成功したターゲット合計数: 処理されたターゲット合計数からMOSに正常にアップロードされたターゲットの合計数。
-
失敗したターゲット合計数: 最終ハーベスタ・ジョブ実行の処理されたターゲット合計数のうち、MOSへのアップロードに失敗した合計数。
-
OCMバージョン: Enterprise Managerで構成されたOCMのバージョンを示します。
ハーベスタのジョブ・ステータス・メトリック・データは、OMSとリポジトリのターゲット・メトリックのページにあります。ERRORしきい値はハーベスタ・ステータス・フィールドに定義されています。このフィールドの値が「ERROR」となった場合、インシデントが作成されます。これは、OMSとリポジトリのホームページおよびインシデント・マネージャのページの両方に表示されます。
Oracle Harvesterでサポートされているターゲット
Oracle Harvesterが実行されているEnterprise Managerのリリースに従って、様々なターゲット・タイプのセットから構成データが収集されます。表E-1に示されたターゲット・タイプの構成データのみがOracle Harvesterによって収集されます。
表E-1 Enterprise Manager 12.1リリースでサポートされているターゲット
ターゲット | プラグイン・リリース | Enterprise Managerリリース | ||
---|---|---|---|---|
12.1.0.1 | 12.1.0.2 | 12.1.0.3 | ||
BI |
12.1.0.3 |
いいえ |
はい |
はい |
ホスト |
該当なし |
はい |
はい |
はい |
管理エージェント |
該当なし |
はい |
はい |
はい |
管理リポジトリ |
該当なし |
はい |
はい |
はい |
Oracle Application Server |
すべてのバージョン |
はい |
はい |
はい |
Oracle Database |
すべてのバージョン |
はい |
はい |
はい |
Oracle Database Machine |
すべてのバージョン |
はい |
はい |
はい |
Oracle Exadata Storage Server |
すべてのバージョン |
はい |
はい |
はい |
Oracle Exalogic |
12.1.0.2 12.1.0.3 |
いいえ いいえ |
はい いいえ |
はい はい |
Oracle Fusion Applications |
すべてのバージョン |
はい |
はい |
はい |
Oracle Fusion Middleware |
すべてのバージョン |
はい |
はい |
はい |
Oracleホーム |
該当なし |
はい |
はい |
はい |
構成用Oracle Identity Manager: OIF、OID、OVDおよびDIP |
いいえ |
はい |
はい |
|
構成用Oracle Identity Manager: OIM、OAMおよびOAAM |
すべてのバージョン |
はい |
はい |
はい |
Oracle Management Service |
該当なし |
はい |
はい |
はい |
Oracle SOA Suite |
すべてのバージョン |
はい |
はい |
はい |
Oracle Virtual Manager |
すべてのバージョン |
はい |
はい |
はい |
Oracle WebLogic Server |
すべてのバージョン |
はい |
はい |
はい |
Siebel |
12.1.0.3 |
いいえ |
いいえ |
はい |
My Oracle Supportで使用できない構成データ
Enterprise Managerの以前のバージョンでは、構成データがMy Oracle Supportにすでにある場合、スタンドアロンOCMコレクタによるデータの最後のアップロードから30日経過すると、Oracle Harvester構成データがMy Oracle Supportにアップロードされていました。
Enterprise Manager 12c以降、この制限はなくなりました。Enterprise Managerリリース12c以降で実行されているOracle Harvesterから収集されたターゲットの構成データは、スタンドアロンOCMコレクタによる最後のデータのアップロードがいつだったかに関係なく、My Oracle Supportにただちに表示されます。
Enterprise Managerインフラストラクチャの活用
Enterprise Managerのフル・デプロイメントには、次のコンポーネントが含まれています。
-
1つ以上のOracle Management Service (OMS)インスタンス
-
管理リポジトリとして使用されるOracleデータベース
-
Enterprise Managerによって管理されるターゲットを含んでいる各ホストにデプロイされる管理エージェント
定期的に、Enterprise Managerによって管理されるターゲットのために、管理エージェントによって構成データが収集され、OMSにアップロードされます。データはEnterprise Managerリポジトリに格納されます。
Enterprise Managerは、そのデータをOracleに伝達する目的で、収集した構成データをEnterprise Managerリポジトリから抽出または獲得します。獲得すると、構成データは、システム構成情報をそれがOCMインスタンスからアップロードされたかのようにMy Oracle Support内で生成する、繰り返し発生するEnterprise Managerジョブを手段として、My Oracle Supportに自動的にアップロードされます。
これによって、ソフトウェア・デプロイメントがより単純になるという利点がもたらされることにも注目してください。純粋なOCMモデルでは、すべてのOracleホームにOCMソフトウェアのインスタンスが1つ必要になります。一方、Enterprise Managerインフラストラクチャでは、各ホストに1つの管理エージェントが必要になります。そのため、より少ないデプロイメントが多数必要になる可能性があります。
構成データをOracleにアップロードするEnterprise Managerの構成
Enterprise Managerを使用して構成データを収集しOracleサポートにアップロードするための前提条件は、Enterprise Manager OMSがバージョン10.2.0.5以上であり、OMSのOracleホームで構成されている(および接続済モードで実行されている)OCMインスタンスである必要があるということのみです。
Enterprise Managerインフラストラクチャのために複数のOMSインスタンスを使用する場合、各OMSでOCMが構成されており、実行されている必要があります。OCMは、10.2.0.5パッチセットのインストールの一環として簡単に設定されます。または、OCMを後でコマンド・ラインから構成することもできます。詳細は、『Oracle Configuration Managerインストレーションおよび管理ガイド』を参照してください。OMSホームでOCMを構成すると、OracleへのEnterprise Managerによって収集された構成のアップロードが有効になります。
注意:
OMSのOracleホームは、OCMインスタンスが必要になる唯一の場所です(管理対象ターゲット上ではない)。
Oracle Configuration Manager
Oracle Configuration Managerは、Oracle製品のインストール時に自動的にインストールおよび構成されます。OCMは、製品のホームにインストールされ、そのホームにインストールされているすべてのターゲットの構成データを収集します。
OCMの設定で、My Oracle Supportのアカウントとパスワード、またはMy Oracle Supportのアカウントとカスタマ・サポートID (CSI)を指定する必要があります。構成データは、この情報を使用してアップロードされ、その後同じ資格証明を使用してMy Oracle Supportにログインすることで表示できます。
構成データのOracleへのアップロード元となるすべてのOracleホームに、OCMをインストールする必要があります。OCMは、製品のインストールの一部に含まれていますが、My Oracle Supportからダウンロードすることもできます。OCMをデータ・センター全体にデプロイする場合、一括デプロイメント・ツールの使用が便利です。OCMキットは、My Oracle Supportの「コレクタ」タブから入手できます。
OCMのインストール後、必要な追加作業はありません。デフォルトで自動更新が有効になるため、この機能を使用して、常に最新バージョンのOCMが実行されている状態を保てます。この機能は、セキュリティ上の理由などから必要に応じて無効にできます。この機能を無効にした場合、次のコマンドを実行して有効にできます。
<ocm_install_root>/ccr/bin/emCCR automatic_update on
注意: Enterprise ManagerまたはOps Centerを使用してアプリケーションを管理している場合、構成のOracleへのアップロードには、Oracle HarvesterまたはOps Center Harvesterをそれぞれ使用することをお薦めします。それ以外の場合は、OCMを使用してください。
MOSおよびOCMの追加情報
My Oracle Supportの詳細情報は、次のURLを参照してください。
OCMについてより詳細な情報を得るには、次のステップを実行してください。
-
My Oracle Support (
https://support.oracle.com
)にログインします。 -
「コレクタ」タブにアクセスするには、「詳細」をクリックしてドロップダウン・メニューから「コレクタ」を選択します。「コレクタ」ページには役立つ情報が含まれています。
構成データ収集ツールのトラブルシューティング
Enterprise Managerリリース12.1.0.2では、emccr status
コマンドを使用して、収集データがOracleにアップロードされていることを確認します。最後にアップロードされた日付と時刻を参照してください。
注意: このemccr status
コマンドでは、収集されたデータがアップロードされたことは示されますが、Oracle Harvesterによる収集が成功しデータがアップロードされたことは確認されません。
エラー・ログの場所:
-
Oracle Harvesterのエラー・ログ:
-
Harvesterジョブのエラーについては、次を参照してください。
INSTANCE_HOME/sysman/log/emoms_pbs.trc
-
UIエラー(CSI割当てエラーなど)の場合、次を参照してください。
INSTANCE_HOME/sysman/log/emoms.trc
次に例を示します。
/gc_inst/user_projects/domains/GCDomain/servers/EMGC_OMS1/sysman/log/emoms.trc
-
-
Ops Center Harvesterエラー・ログは、次の場所にあります。
/var/opt/sun/xvm/logs/ocharvester.log
-
Oracle Configuration Managerログは、次の場所にあります。
ccr/hosts/<hostname>/log/collector.log
次の項では、構成データの収集に関する問題の解決方法について説明しています。
state/upload/externaディレクトリが存在しない場合、Oracle Harvesterによる収集が失敗します。
Oracle Harvesterによる収集が次のエラーにより失敗すると、externalという名前の必須ディレクトリが存在しなくなります。
[JobWorker 75210:Thread-61] ERROR gcharvester.GcCollectionMgr initOcm.? - GC OCM Harvester: Caught GC Harvester exception from GCInit.init(): The installed version of Oracle Configuration Manager in the ORACLE_HOME (/scratch/aime/work/midlwre8937/oms11g) is prior to 10.3.1. The Grid Control Configuration harvesting requires at a minimum, 10.3.1
この問題を解決するには、externalディレクトリを作成します。
$ORACLE_INSTANCE_HOME/ccr/state/upload/external
(バグ 12795503)
Oracle Configuration Managerが実行されていません。
OCMが実行されていない場合、次のエラーが表示される場合があります。
2012-08-29 16:34:20,709 [JobWorker 97285:Thread-60] WARN gcharvester.HarvesterJobUtils performOCMCollections.? - GC OCM Harvester: OCM was stopped and is not running
この問題を解決するには、OCMが適切なディレクトリにインストールされ、構成されていることを確認します(emCCR status
を実行)。
具体的には、OCMがOMS Oracleホームにインストールされ、OMSインスタンス・ホームで構成(および接続モードで実行)されている必要があります。
My Oracle Supportで使用できない構成データ
My Oracle Supportで構成データが見つからない場合、Oracle Harvesterによる収集が実行されていない可能性があります。
この問題を解決するには、OCMが正しくインストールされ、適切なディレクトリ(emCCR status
を実行)に構成されていることを確認してください。具体的には、OCMがOMS Oracleホームにインストールされ、OMSインスタンス・ホームで構成(および接続モードで実行)されている必要があります。
OCMが実行中であることを確認するには、次のステップを実行します。
ORACLE_CONFIG_HOME
をINSTANCE HOMEに設定します。$ORACLE_HOME/ccr/bin/emCCR status
を実行します。
ターゲットのサブセットしかOracle Harvesterによって収集されません。
多くのターゲットが管理リポジトリにアップロードされているが、ターゲットのサブセットしかOracle Harvesterによって収集されない場合、収集中に同じエラーが10回発生し、Oracle Harvesterによる収集が停止したとが原因である可能性があります。適切なログ・ファイルを参照し、このエラーが発生したことを確認してください。
管理リポジトリに対して次のSQLスクリプトを実行し、問題を解決してください。このスクリプトにより、Oracle Harvesterはこの収集エラーを無視し、残りのターゲット情報の収集を続行します。
sql> insert into mgmt_ocm_upl_props (name,str_value) values('ignore_errors','true'); sql> commit;
SQLスクリプトを実行した後、OMSをバウンスします。
(バグ 11734389)