WMI を使用した Caché の監視

Caché における WMI の構成

WMI 情報を収集する Caché 環境を整えるには、次の 2 つのタスクを完了します。

• 監視と WMI を有効にする

• WMI クラスをコンパイルする

WMI クラスをコンパイルする

IscProc.mof ファイルは、インターシステムズの WMI クラスを定義します。このファイルは、管理者 (マネージャ) のディレクトリ install-dir\Mgr の WMI サブディレクトリにインストールされます ("install-dir" はインスタンスのインストール先ディレクトリです)。以下の例では、C:\MyCache をインストール・ディレクトリとして使用しています。

このテキスト・ファイルは、MOF (Managed Object Format) でインターシステムズ管理クラスを記述したものです。これらのクラスを使用する前に、システムの WMI リポジトリにコンパイルする必要があります。Windows のコマンド・プロンプトから、Microsoft のツールである mofcomp.exe を使って、次の例に示すようにクラスをコンパイルします。

C:\>cd c:\MyCache\mgr\WMI

C:\MyCache\Mgr\WMI>mofcomp IscProv.mof
Microsoft (R) 32-bit MOF Compiler Version 5.1.2600.2180
Copyright (c) Microsoft Corp. 1997-2001. All rights reserved.
Parsing MOF file: IscProv.mof
MOF file has been successfully parsed
Storing data in the repository...
Done!

C:\MyCache\Mgr\WMI>

Caché での WMI の使用法

Caché では、WMI クラスは WMI リポジトリの root\cache ネームスペースに格納されます。これらの WMI クラスをコンパイルし、WMI リポジトリに格納すると、スクリプト、プログラミング言語、または管理ツールを使用してこの管理情報にアクセスできるようになります。

Microsoft の WMI 管理ツールの一部として使用できる WMI CIM Studio などの基本的なツールを使用して、root\cache ネームスペースのすべてのクラスを参照したり、各クラスのプロパティをリストしたり、各プロパティの説明を含む各クラスのヘルプ・テキストを参照することができます。各クラスのすべてのインスタンスに Caché システムのクエリを実行して、実行中のインスタンスの動作中のデータを表示することもできます。

Cache_DatabaseSystem クラスは、(Windows レジストリから) システムにインストールされた Caché のすべてのインスタンスを列挙し、実行中および接続されているインスタンスを表示します (EnabledState=2)。その他のクラスでは、WMI 対応の Caché インスタンスのデータのみ表示されます。

また、Caché は、スクリプト、プログラムまたは管理ツールを使って受け取ることができる WMI イベントも示します。WMI 管理ツールには、基本的な WMI Event Viewer が含まれます。Cache_Event クラスは、__ExtrinsicEvent クラスのサブクラスとして定義されます。このクラスのプロパティを参照するには、WMI CIM Studio を使用して __SystemClass の階層を移動します。WMI イベントは、SNMP 通知として定義されたイベントと同じものです。Caché インストール環境の SNMP ディレクトリにある ISC-CACHE.MIB ファイルを調査すると、このイベントの最新のリストが見つかります。詳細は、このドキュメントの “SNMP を使用した Caché の監視” を参照してください。

Caché で示される現在のイベントは、次のとおりです。

Ensemble を使用する場合は、上記以外にもイベントがあります。詳細は、"Ensemble でのWMI の使用法" を参照してください。

iscprov.dll は、WMI と Caché 間のすべての通信を処理し、Caché WMI インスタンス・プロバイダとイベント・プロバイダの両方を実装します。Caché インストールは、このファイルを登録し、C:\Program Files\Common Files\Intersystems\Cache ディレクトリに格納します。

要求が出されると、WMI サービスはプロバイダの DLL をロードしますが、一定期間アイドル状態になるとアンロードする場合があります。DLL がロードされると、Caché との通信を開始して、Caché で ^WMI サーバのプロセスが開始します。DLL がアンロードされると、このサーバ・プロセスは終了します。スクリプトや管理アプリケーションで情報を収集する頻度によって、わずか 30 秒に設定されている、既定のインスタンス・プロバイダの “終了” 期間を変更する必要があります。\root ネームスペースの WMI CIM Studio を使用して、__SystemClass、__CacheControl、および　__ObjectProviderCacheControl のクラス階層を拡張します。ClearAfter プロパティの値を変更して、Caché インスタンス・プロバイダを長期間ロードしたままにします。

Caché は、cconsole.log ファイルの ^WMI サーバ・プロセスの重要なメッセージを書き込みます。また、\WINDOWS\system32\WBEM\Logs\ ディレクトリにある iscwmi.log ファイル (Caché にWMI インスタンス・プロバイダとイベント・プロバイダを実装するファイル) の、iscprov.dll で発生するすべてのエラーを記録します。

WMI ドキュメント・テキスト・ファイルの生成

Caché の ^WMIMOF　ルーチンの doc エントリ・ポイントを使用すると、インターシステムズが WMI 向けに提供しているクラスとプロパティのテキスト・ファイルを生成できます。次に例を示します。

 
%SYS>Do doc^WMIMOF
 
 
File: <IscProv.txt>

Enter キーを押して、Mgr ディレクトリに IscProv.txt ファイルを作成します。

Creating doc file for WMI Classes ...
 
 ;;DatabaseSystem;;;;Cache;
 
 ;;CommonDatabase;;;;Cache;
 
 ;;SystemStatistics;Abstract;;;Cache;
 
 ;;DatabaseStatistics;;SystemStatistics;;Cache;
 
 ;;ECPClientStatistics;;SystemStatistics;;Cache;
 
 ;;ECPServerStatistics;;SystemStatistics;;Cache;
 
 ;;WriteDemonStatistics;;SystemStatistics;;Cache;
 
 ;;GlobalBufferStatistics;;SystemStatistics;;Cache;
 
 ;;ResourceSeizeStatistics;;SystemStatistics;;Cache;
 
 ;;ECPConnection;Abstract;;;Cache;
 
 ;;ECPServerConnection;;ECPConnection;;Cache;
 
 ;;ECPClientConnection;;ECPConnection;;Cache;
 
 ;;ECPServerConnectionStats;;;;Cache;
 
 ;;ShadowJournal;Abstract;;;Cache;
 
 ;;ShadowSourceConn;;ShadowJournal;;Cache;
 
 ;;ShadowDestServer;;ShadowJournal;;Cache;
 
 ;;Event;;__ExtrinsicEvent;;Cache
 
 ;;LogEvent;;__ExtrinsicEvent;WMIMOF3;Ensemble
 
 ;;Production;;;WMIMOF3;Ensemble;
 
 ;;EventLog;;;WMIMOF3;Ensemble;
 
%SYS>