Sun Microsystems WDR User’s Manual [ja]

Download

WDR 開発ガイド

WBEM

Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A.

ベースのシステム管理アプリケーションの作成

Part No. 816-7273-11 2002 年 12 月, Revision A

コメントの宛先: docfeedback@sun.com

Sun Microsystems, Inc. (

米国所有権を有しています。これら知的所有権には、び米国ならびにその他の国におけるひとつまたは複数の特許または出願中の特許が含まれています。

本書およびそれに付属する製品は著作権法により保護されており、その使用、複製、頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。サン・マイクロシステムズ株式会社の書面による事前の許可なく、本製品および本書のいかなる部分も、いかなる方法によっても複製することが禁じられます。

本製品のフォント技術を含む第三者のソフトウェアは、著作権法により保護されており、提供者からライセンスを受けているものです。本製品の一部は、カリフォルニア大学からライセンスされている

X/Ope n Company Limited

本製品は、株式会社モリサワからライセンス供与されたリュウミンフォント・データを含んでいます。

SPARC

HG 明朝 L と HG

商標は、米国

SPARC

本製品に含まれるスマスタをもとに作成されたものです。平成明朝体ライセンス供与されたタイプフェースマスタをもとに作成されたものです。また、

朝体

Sun、Sun Microsystems、AnswerBook2、docs.sun.com、Sun Fire、Sun4U、SunSwift、Java、JDK

国

Sun Microsystems

すべてのは登録商標です。

以下、米国

が独占的にライセンスしている米国ならびに他の国における登録商標です。

社の商標もしくは登録商標です。サンのロゴマークおよび

SPARC International, Inc.

商標が付いた製品は、米国

OPENLOOK、OpenBoot、JLE ATOK

は、株式会社ジャストシステムの登録商標です。

の他の権利は、すべて株式会社ジャストシステムに帰属します。

ATOK Server/ATOK12

本書で参照されている製品やサービスに関しては、該当する会社または組織に直接お問い合わせください。

OPEN LOOK

ました。米国における米国

Interface Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in the Sun Microsystems, Inc. license agreements and as

provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1) (ii) (Oct. 1998), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable.

本書は、「現状のまま」をベースとして提供され、商品性、特定目的への適合性または第三者の権利の非侵害の黙示の保証を含みそれに限定されない、明示的であるか黙示的であるかを問わない、なんらの保証も行われないものとします。

本書には、技術的な誤りまたは誤植のある可能性があります。また、本書に記載された情報には、定期的に変更が行われ、かかる変更は本書の最新版に反映されます。さらに、米国サンまたは日本サンは、本書に記載された製品またはプログラムを、予告なく改良または変更することがあります。

本製品が、外国為替および外国貿易管理法外へ持ち出す際には、サン・マイクロシステムズ株式会社の事前の書面による承諾を得ることのほか、外為法および関連法規に基づく輸出手続き、また場合によっては、米国商務省または米国所轄官庁の許可を得ることが必要です。

および

Sun Microsystems Xerox

の非独占的ライセンスを取得しており、このライセンスは米国

にかかる著作権その他の権利は、株式会社ジャストシステムおよび各権利者に帰属します。

Sun Graphical User Interface

社の先駆者としての成果を認めるものです。米国

Sun Microsystems

http://www.sun.com/patents

社とします) は、本書に記述されている製品に採用されている技術に関する知的

に掲載されているひとつまたは複数の米国特許、およ

Berkeley BSD システムに基づいていることがあります。UNIX は、

L-KL (Ryumin-Light)

ゴシック

は、株式会社リコーがリョービイマジクス株式会社からライセンス供与されたタイプフェー

は、株式会社リコーが財団法人日本規格協会文字フォント開発・普及センターから

Solaris

のライセンスを受けて使用している同社の米国およびその他の国における商標また

Sun Microsystems

は、サン・マイクロシステムズ株式会社の登録商標です。

ATOK8

Sun Microsystems

社は、コンピュータ産業用のビジュアルまたはグラフィカル・ユーザーインタフェースの概念の研究開発

は、米国

(

外為法) に定められる戦略物資等 (貨物または役務) に該当する場合、本製品を輸出または日本国

社が開発したアーキテクチャーに基づくものです。

は、株式会社ジャストシステムの著作物であり、

ATOK Server/ATOK12

社が自社のユーザーおよびライセンス実施権者向けに開発し

Sun Microsystems

および中ゴシック

HG 明朝 L と HG

Sun Microsystems

は、米国

は、株式会社ジャストシステムの著作物であり、

Xerox

社は米国

社のライセンス実施権者にも適用されます。

BBB (GothicBBB-Medium)

ゴシック

は、米国およびその他の国における米

の補助漢字部分は、平成明

社の登録商標です。

ATOK8

Xerox Graphical User

社から

にかかる著作権そ

の

: WDR Developer’s Guide

原典

Part No: 816-1984-11 Revision A

Please

Recycle

はじめに ix

1. WDR の概要 1

WDR のハードウェア要件 1

Sun Fire 6800/4810/4800/3800 システムでの MSP のハードウェア要件 1

WDR のソフトウェア要件 2

Sun Fire 15K/12K システムでのソフトウェア要件 2

Sun Fire 6800/4810/4800/3800 システムでのソフトウェア要件 2

Web-Based Enterprise Management (WBEM) とは 2

Common Information Model (CIM) 3

プラットフォーム固有および共通の MOF ファイル 4

WDR により実行される操作 4

管理者セキュリティーモデル 5

WDR セキュリティー 5

Solaris WBEM Services 7

CIM Object Manager (CIMOM) 8

WBEM プロバイダ 8

Solaris WBEM ソフトウェア開発キット (SDK) 9

2. WDR での Solaris WBEM Services の使用方法 11

iii

Solaris WBEM Services の概要 11

Solaris WBEM Services の層 12

Solaris WBEM Services のアプリケーション層 12

Sun WBEM User Manager と SMC ユーザーツール 12

Solaris Management Console (SMC) WBEM ログビューア 13

Managed Object Format (MOF) コンパイラ 13

Solaris WBEM Services の管理層 16

CIM Object Managerとは 16

手動による CIM Object Manager の起動と停止 17

▼

CIM Object Manager を起動する 17

▼

CIM Object Manager を停止する 17

Solaris WBEM Services のプロバイダ層 18

Solaris プロバイダ 18

WBEM セキュリティーサービス 19

認証 19

承認 19

iv WDR

Sun WBEM User Manager の使用方法 21

API を使用したアクセス制御の設定 24

開発ガイド

再実行保護 20

デジタル署名 20

セキュリティーの実装 20

▼

Sun WBEM User Manager を起動する 22

▼

ユーザーにデフォルトのアクセス権を与える 22

▼

ユーザーのアクセス権を変更する 23

▼

ユーザーのアクセス権を削除する 23

▼

ネームスペースへのアクセス権を設定する 23

▼

ネームスペースへのアクセス権を削除する 24

Solaris_UserAcl クラス 25

• 2002 年 12

月

▼

ユーザーごとにアクセス制御を設定する 26

Solaris_NamespaceAcl クラス 27

▼

ネームスペースでのアクセス制御を設定する 27

Solaris Management Console (SMC) ユーザーツールの起動 28

▼

SMC ユーザーツールを起動する 28

Solaris WBEM ロギングサービス 29

Solaris WBEM Services のログファイル 30

Solaris WBEM Services のログファイル規則 30

Solaris WBEM Services のログファイル形式 31

Solaris WBEM ログクラス 31

Solaris_LogRecord クラス 32

Solaris_LogService クラス 32

API を使用した Solaris WBEM ロギングの有効化 33

Solaris WBEM ログファイルへのデータの書き込み 33

▼

Solaris_LogRecord のインスタンスを作成してデータを書き込む 34

Solaris WBEM ログファイルからのデータの読み取り 36

▼

Solaris_LogRecord クラスのインスタンスを取得してデータを読み取

る 36

Solaris WBEM ロギングプロパティーの設定 39

▼

Solaris WBEM ロギングプロパティーを設定する 39

Solaris WBEM ログビューア 41

▼

SMC と Solaris ログビューアを起動する 41

3. プロセスインジケーションの使用 43

CIM イベントモデル 43

インジケーションの生成方法 45

サブスクリプションの作成方法 45

CIM リスナーの追加 46

▼

CIM リスナーを追加する 46

イベントフィルタの作成 47

▼

イベントフィルタを作成する 48

イベントハンドラの作成 49

▼

CIM イベントハンドラを作成する 51

イベントフィルタとイベントハンドラのバインド 51

▼

イベントフィルタとイベントハンドラをバインドする 51

4. WDR のクラス、ドメイン、関連、およびインジケーション 53

WDR CIM クラス階層図 54

CIM 接続点クラス 55

CIM Solaris_WDRAttachmentPoint クラス 55

CIM Solaris_CHSystemBoard クラス 60

CIM Solaris_CHCPU クラス 64

CIM Solaris_CHMemory クラス 65

CIM Solaris_CHController クラス 67

CIM スロットクラス 68

vi WDR

CIM Solaris_WDRDomain クラス 76

WDR スキーマの関連と集約 82

開発ガイド

CIM Solaris_WDRSlot クラス 68

CIM Solaris_XCSlot クラス 72

CIM Solaris_SGSlot クラス 74

CIM Solaris_WDRDomain クラス 76

CIM Solaris_XCDomain クラス 77

CIM Solaris_SGDomain クラス 80

CIM Solaris_DomainHasAttachmentPoints 集約 82

CIM Solaris_DomainHasSlots 集約 83

Solaris_SlotHasSystemBoard 関連 84

Solaris_SystemBoardHasProcessors 集約 85

Solaris_SystemBoardHasMemory 集約 85

• 2002 年 12

月

Solaris_SystemBoardHasControllers 集約 86

CIM プロセスインジケーションクラス 87

WDR インジケーションクラス階層図 88

Solaris_WDRIndication クラス 88

Solaris_SGBoardPresenceChange インジケーション 89

Solaris_SGDomainACLChange インジケーション 89

Solaris_SGDomainStateChange インジケーション 90

Solaris_SGSlotAssignmentChange インジケーション 91

Solaris_SGBoardStateChange インジケーション 92

Solaris_SGSlotAvailabilityChange インジケーション 93

Solaris_XCSystemBoardConfigChange インジケーション 94

Solaris_XCEnvironmentalIndication インジケーション 95

Solaris_XCComponentRemove インジケーション 95

Solaris_XCComponentInsert インジケーション 96

Solaris_XCBoardPowerOn インジケーション 96

Solaris_XCBoardPowerOff インジケーション 96

Solaris_XCDomainIndication インジケーション 96

Solaris_XCDomainConfigChange インジケーション 97

Solaris_XCDomainUp インジケーション 97

Solaris_XCDomainDown インジケーション 97

Solaris_XCDomainStop インジケーション 98

Solaris_XCDomainStateChange インジケーション 98

5. WDR のプログラミング手法 99

システムの状態情報のキャッシュ 99

EventProvider の操作 100

▼

WDR インジケーションを選択して読み取る 100

▼

イベントリスナーを実装する 102

▼

イベントフィルタとイベントハンドラをバインドする 102

vii

InstanceProvider の操作 107

AssociatorProvider の操作 108

MethodProvider の操作 109

A. MOF ファイル 111

索引 139

viii WDR

開発ガイド

• 2002 年 12

月

はじめに

WDR

本書

『

使用して、マニュアルです。

開発者は、

Java™

す。

開発ガイド』は、

操作を遠隔で行うアプリケーションを開発するシステム管理者向けの

Sun WBEM SDK

言語などで

WDR

Web

ベースの企業管理では業界標準である

などのソフトウェア開発キット

クライアントアプリケーションを記述することができま

(SDK)

を使用して、

お読みになる前に

このマニュアルは、のシステムでの作業経験を持つ

システムのプラットフォーム管理者を対象としています。このような経験がな

3800

い場合は、まずこのシステムに付属するマニュアルを読み、

UNIX®

UNIX システム管理のトレーニングの受講を検討してください。

システム、特に

Sun Fire™ 15K、12K、6800、4810、4800

Solaris™

Solaris

オペレーティング環境ベース

ユーザーおよびシステム管理者向け

WBEM

、および

を

マニュアルの構成

第

章では、

す。

第

章では、

Services

第 3

章では、プロセスインジケーションについて説明します。プロセスインジケーションとは、各す。

第

章では、開発者向けにントの

)

プロパティーのすべてについても、この章で説明します。

第

章では、管理を簡略化および自動化する役立つプログラミング手法を紹介します。

UNIX

このマニュアルには、ムの起動、デバイスの構成などの基本的な手順の説明は記載されていません。

基本的なコマンドや手順についての説明は、次のマニュアルを参照してください。

■

Sun

『

■

Solaris™

■

本システムに付属している他のソフトウェアマニュアル

WDR

の概要と、

Solaris

のさまざまな層について説明します。

インジケーション、および関連を紹介します。開発者が使用するメソッドと

オペレーティング環境に組み込まれている

WDR

クライアントが申請できるシステムイベントの通知のことで

Sun Fire 15K/12K

WDR

を使用して実行できる作業について説明しま

Solaris WBEM

WDR

で提供されているすべてのクラス、(システムイベ

6800/4810/4800/3800

および

WDR

アプリケーションを作成するときに、開発者に

システム上でシステム

コマンド

UNIX

周辺機器使用の手引き』

オペレーティング環境についてのオンラインマニュアル

の基本的なコマンド、およびシステムの停止、システ

x WDR

開発ガイド

• 2002 年 12

月

書体と記号について

書体または記号意味例

AaBbCc123

またはゴシック

『

』参照する書名を示します。『

コマンド名、ファイル名、ディレクトリ名、画面上のコンピュータ出力、コード例。

ユーザーが入力する文字を、画面上のコンピュータ出力と区別して表します。

コマンド行の可変部分を、実際の名前や値と置き換えてください。

.login ls -a

% You have mail.

マシン名

Password:

rm filename rm

ファイルを編集します。

を実行します。

% su

と入力します。

ファイル名と入力します。

ユーザーマニュアル』

Solaris

」参照する章、節、または、

「

強調する語を示します。

枠で囲まれたコード例で、テキストがページ行幅をこえる場合に、継続を示します。

第

章「データの管理」を参照。

この操作ができるのは「スーパーユーザー」だけです。

% grep ‘^#define \

XV_VERSION_STRING’

シェルプロンプトについて

シェルプロンプト

UNIX の C

UNIX の Bourne

スーパーユーザー (シェルの種類を問わない

シェルマシン名

シェルと

Korn

シェル

)

はじめに

関連マニュアル

用途タイトル

のインストール

WDR

3800

および

、

4810

3800

、

システ

12K

、

システ

Sun Fire 6800、4810

、および

4800

ムでの

Sun Fire 15K

システムでの

Sun Fire 15K

システムでのシステムレベルのセキュリティ

Sun Fire 6800

、および

4800

ムでのシステムレベルのセキュリティ

Solaris WBEM Services

インストールマニュアル

WDR

、

Sun Fire 6800

テム

Dynamic Reconfiguration

ザーマニュアル

Sun Fire 15K/12K Dynamic Reconfiguration (DR)

ル

System Management Services (SMS) 1.2

管理者マニュアルシステム用

Sun Fire 6800/4810/4800/3800

ムプラットフォーム管理ガイド

Solaris WBEM Services

4810、4800、3800

ユー

ユーザーマニュア

(Sun Fire 15K/12K

)

の管理

コメントをお寄せください

シス

システ

Part No.

816-7269

816-3596

816-7250

816-7243

806-7904

806-7119

xii WDR

開発ガイド

弊社では、マニュアルの改善に努力しており、お客様からのコメントおよびご忠告をお受けしております。コメントは下記宛に電子メールでお送りください。

docfeedback@sun.com

電子メールの表題にはマニュアルの

Part No. (816-7273-11)

を記載してください。

なお、現在日本語によるコメントには対応できませんので、英語で記述してください。

• 2002 年 12

月

第 1 章

WDR の概要

WDR (WBEM Dynamic Reconfiguration)

できるアプリケーションプログラムインタフェース

(DR)

ステム上で動的再構成

■

Sun Fire 15K

■

Sun Fire 12K

■

Sun Fire 6800

■

Sun Fire 4810

■

Sun Fire 4800

■

Sun Fire 3800

ソフトウェア開発者とシステム管理者は、重要なシステム管理機能を遠隔実行する独自のアプリケーションを作成することができます。

DR 操作は Sun Fire システムコントローラ (SC) 上と Solaris ドメイン上 (cfgadm シ

ステムライブラリ使用による

WDR

では

操作を遠隔実行できます。

操作を実行する従来の方式に代わる方法を提供しており、

)

のいずれかで実行されます。

は、ソフトウェアアプリケーションで使用

(API)

を提供しており、以下のシ

WDR API

を使用すると、負荷均衡などの

WDR のハードウェア要件

Sun Fire 6800/4810/4800/3800 (MSP)

と呼ばれる外部ホスト上で動作します。

WDR はシステムコントローラ (SC) 上で動作します。

システムでは、

WDR は Midframe Service Processor

Sun Fire 15K と 12K

システムでは、

Sun Fire 6800/4810/4800/3800 システムでの MSP のハードウェア要件

MSP

に必要な最小構成のハードウェア要件は、次のとおりです。

■

Sun4U™

アーキテクチャー

■

8 GB

のハードディスク容量

■

128 MB

■

CD-ROM ドライブ

■

SunSwift™ カード、または QuadFast Ethernet カード (最適)

のメモリー

WDR のソフトウェア要件

WDR は、Solaris 8 2/02 6800/4810/4800/3800

WDR は、Solaris

す。いません。

または

オペレーティング環境などのソフトウェアにはバンドルされて

Solaris 9

または

Sun Fire 15K/12K

ソフトウェアが実行されている、

システムドメイン上で使用できま

Sun Fire

Sun Fire 15K/12K システムでのソフトウェア要件

WDR

を使用するには、

の両方を

Management Services (SMS)

ておく必要があります。

上にインストールしておく必要があります。さらに、

WDR

ソフトウェアと

バージョン

Solaris WBEM Services

1.2

ソフトウェアも

ソフトウェア

System

上にインストールし

Sun Fire 6800/4810/4800/3800 システムでのソフトウェア要件

WDR

を使用するには、

の両方を

MSP

上にインストールしておく必要があります。

WDR

ソフトウェアと

Solaris WBEM Services

ソフトウェア

2 WDR

開発ガイド

Web-Based Enterprise Management (WBEM)

WDR

インタフェースは、業界標準である

(WBEM)

ワーク、およびデバイスをの業界リーダー企業で構成されるンバーにより開発された標準規格です。

• 2002 年 12

に基づいて設計され、さまざまなプラットフォーム上でシステム、ネット

とは

Web-Based Enterprise Management

Web ベースで管理することができます。WBEM は、多数

Distributed Management Task Force (DMTF)

月

のメ

WBEM

■

は、以下の

管理対象オブジェクトのモデル化手法。

Model (CIM)

つの主要コンポーネントで構成されています。

WBEM

Common Information

では、

を使用して管理対象オブジェクトを表すクラスを作成します。これらのクラスには、管理対象オブジェクトの属性と状態を表すプロパティーと、管理対象オブジェクトにおいて実行可能な操作を表すメソッドが含まれます。

■

CIM 情報をネットワークで送信できるようにするコード化方法。WBEM では、 SGML

して、

■

XML

操作をネットワークで伝送するためのカプセル化方法。

XML/HTTP

を強化して拡張性を持たせた

CIM

クラスをコード化します。

RMI

または

を使用して、管理対象オブジェクトからの情報の取得、

Extensible Markup Language (XML)

WBEM

では、

管理対象オブジェクトのプロパティーの設定、および管理対象オブジェクトでの操作を実行するよう送信します。

つまり

WBEM

では、管理対象オブジェクトを

メソッドで表し、

CIM

操作を

XML/HTTP

CIM

または

クラス、プロパティー、および

RMI

メッセージのいずれかで表し

て、これらのメッセージをネットワークを介して送信します。

を使用

このマニュアルでは、

WBEM

の詳細については、

さまざまな情報源から入手可能です。

WBEM

標準規格について全体的な説明はしません。しかし、

DMTF の Web

www.dmtf.org

サイト

をはじめとして、

Common Information Model (CIM)

WDR は Sun Fire

システム専用に

を表すときに使用されます。

■

によって管理可能な

■

に関連するイベントや、

■

AttachmentPoint

ムリソース

■

プラットフォームリソースのコンテナ (ドメイン、スロットなど

■

WDR

スキーマでのオブジェクトの存在や状態、あるいはその両方に影響を与える

クラスとそのサブクラスによって表される

(

接続点など

)

イベント

■

WDR

スキーマでのオブジェクト同士の関連付け

■

操作そのもの

Sun Fire 6800/4810/4800/3800

び

12K

システムのアーキテクチャーとかなり異なっています。

使用する

Sun Fire

テクチャーに反映される

システムが異なっていても、

CIM スキーマが組み込まれています。

CIM

スキーマを拡張したものであり、以下のもの

Sun Fire

システム上のリソース

WDR

モデルの状態に影響を与えるイベント

プラットフォー

システムのアーキテクチャーは、Sun Fire 15K およ

WDR

には、

Sun Fire

システムのすべてのアーキ

)

WDR

を

CIM

スキーマには、すべての

6800/4810/4800/3800 12K

システム専用のオブジェクトがあります。

システム専用のオブジェクト、そして

Sun Fire

システムに共通のオブジェクト、

Sun Fire 15K

1 章WDR

第

Sun Fire

および

の概要

システムアーキテクチャー間のスに取り込まれ、フォーム固有のサブクラスに取り込まれます。

はプラットフォームに依存しないスーパークラスのプラット

相違点

はプラットフォームに依存しないスーパークラ

共通点

プラットフォーム固有および共通の MOF ファイル

WDR で使用される CIM スキーマは、3 つの Managed Object Format (MOF) ファイ

ルに記述されています。これは、ジェクトがすべて定義されている

WDR_core1.0.mof

■

テムに共通の要素が定義されています。

WDR_XC1.0.mof

■

ます。

WDR_SG1.0.mof

■

定義されています。

MOF

ファイルは、スキーマを提供するだけでなく、ソフトウェア開発者やシステム

–

CIM

WDR CIM

の形式定義については、『

管理者に

注

では、

には、

スキーマを構成するオブジェクトの形式定義も提供します。

Sun Fire ASCII

Sun Fire 15K/12K

Sun Fire 6800/4810/4800/3800

Object Model for Enterprise Management Computer Publishing

てください。

、

システム上の管理対象リソースを表すオブ

テキストファイルです。

6800/4810/4800/3800

および

システムに固有の要素が定義されてい

シス

システムに固有の要素が

Common Information Model, Implementing the

(Winston Bumpus

』

他共著、

Wiley

を参照し

4 WDR

開発ガイド

WDR により実行される操作

WDR

では、以下の動的再構成操作を遠隔実行することができます。

■

Solaris ソフトウェアが動作しているドメインに、システムボード (CPU/メモリー

)

ボード

接続された) 状態にします。次に

(

るすべてのアプリケーションで使用可能となるように構成し、れた

■

構成解除を行ってから構成操作を行うことにより、1 つのドメインから別のドメインにシステムボードを移動する。

■

システムボードをドメインから削除し、他のドメインで使用できるようにする。

■

システム上のドメインで現在使用可能な接続点をすべて一覧で表示する。

• 2002 年 12

を追加する。まず

)

状態にします。

月

は、ボードをシステムに電気的に接続し、

は、システムボードをドメインで実行され

configured (

connected

構成さ

■

指定されたシステムボードの現在の状態に関する情報 (システムボードの電源の状

)

態、利用可能かどうか、ドメイン割り当てなど

■

構成されているシステムボードのメモリー構成を取り出す。

■

メモリーに与える影響に関する情報 (メモリードレイン情報など) を取り出す。この情報によっては、構成されているシステムボードを切り離すことになります。

を表示する。

WDR

の機能はれた操作はありません。しかし、ドメインとスロットに関する情報、クラス間の関連、およびイベント通知を提供することによって、ています。

は、パフォーマンスを著しく低下させることなく、

WDR

ることを目的に設計されています。

自体の基本的な機能と同じものであり、

WDR には DR

に追加さ

WDR では DR の機能を向上させ

操作を効率的に実行す

管理者セキュリティーモデル

WDR

キュリティーモデルが適用されます。

Sun Fire 6800/4810/4800/3800

の詳細は、『

(Part No. 806-7904)

ド』

Sun Fire 15K/12K

System Management Services (SMS) 1.2

『テム用

また、

章で説明します。

Sun Fire 15K/12K

では、

Sun Fire 6800/4810/4800/3800

を参照してください。

システムレベルでのセキュリティーの実装についての詳細は、

)』(Part No. 816-7243)

Solaris WBEM Services

6800/4810/4800/3800

および

システムレベルでのセキュリティーの実装について

システムプラットフォーム管理ガイ

管理者マニュアル

を参照してください。

により使用可能となるセキュリティーについては、第

システム上で管理者セ

(Sun Fire 15K/12K

シス

WDR セキュリティー

/etc/group

ループが表示されます。

Sun Fire 6800/4810/4800/3800

Sun Fire 6800/4810/4800/3800 /etc/group

ファイルに、現在ログインしているユーザーが割り当てられているグ

システム上のグループメンバーシップを示す

ファイルは、手動で編集することができます。

システムグループ

1 章WDR

第

の概要

割り当てられているグループメンバーシップに応じて、ユーザーが実行できるすべての操作を以下の表に示します。

表 1-1 グループに応じて実行できるタスク - Sun Fire 6800/4810/4800/3800

グループユーザーが実行できるタスク

(

なし

すべてのユー

)

ザー

spltadm

spltop

sdxadm

sdxop

ドメインとスロットの列挙。

ボードの割り当ておよび割り当て解除。

特別な特権はありません。

はドメインを意味します。

•

ドメイン

•

ユーザーがすべてのドメインでている場合は、すべての接続点の列挙。

•

接続点状態の変更、ドメインボードの割り当て、割り当て解除、電源投入、および電源切断。

はドメインを意味します。

•

ドメイン

•

ユーザーがすべてのドメインでいる場合は、すべての接続点の列挙。

の接続点の列挙。

sdxadm

の使用可能構成要素リストにある

sdxop

グループに割り当てられ

グループに割り当てられて

6 WDR

開発ガイド

Sun Fire 15K

または

および

12K

システムグループ

システム上のグループメンバーシップを示すファイルを変更するには、引数を指定してプトを実行します。詳細は、『

(Sun Fire 15K/12K

アル

• 2002 年 12

月

System Management Services (SMS) 1.2

システム用)』を参照してください。

/etc/group

/opt/SUNWSMS/bin/smsconfig

管理者マニュ

スクリ

割り当てられているグループメンバーシップに応じて、ユーザーが実行できるすべての操作を以下の表に示します。

表 1-2 グループに応じて実行できるタスク - Sun Fire 15K および 12K

グループユーザーが実行できるタスク

platadmn

platoper

dmnxadm

dmnxrcfg

ボードの割り当て、割り当て解除、電源投入、および電源切断。

特別な特権はありません。

はドメインを意味します。

•

ドメイン

•

ユーザーがすべてのドメインでれている場合は、すべての接続点の列挙。

•

接続点状態の変更、ドメインボードの割り当て、割り当て解除、電源投入、および電源切断。

はドメインを意味します。

•

ドメイン

•

ユーザーがすべてのドメインでれている場合は、すべての接続点の列挙。

•

接続点状態の変更、ドメインボードの割り当て、割り当て解除、電源投入、および電源切断。

の接続点の列挙。

dmnxadm

の使用可能構成要素リストにある

dmnxrcfg

の使用可能構成要素リストにある

グループに割り当てら

Solaris WBEM Services

WDR は、Solaris 8 2/02 Solaris WBEM Services

ソフトウェアを拡張したものです。ソフトウェアを使用すると、管理データに安全にアクセスして操作することができるため、ソフトウェア開発者はトアプリケーションを作成することができます。

Solaris WBEM Services

ソフトウェアは、以下のントから構成されています。

アプリケーション層。この層では、

■

ソースのデータが処理および表示されます。アプリケーション層のサービスには、

WBEM Workshop、WBEM User Manager

す。管理者は、と削除、および管理層。この層では、管理者は

■

)

成する

を使用して、

WBEM User Manager を使用すると、承認 WBEM ユーザーの追加 WBEM ユーザーのアクセス権の設定を行うことができます。

CIMOM

示や作成などの操作を実行できます。ダインタフェースはすべて管理層に存在しています。

Solaris 9

および

オペレーティング環境に搭載されている

Solaris WBEM Services

Solaris 環境でシステムリソースを管理するクライアン

つのレベルで機能するコンポーネ

WBEM

CIM API (

クライアントによって、管理対象リ

、および

MOF

コンパイラがありま

アプリケーション層と管理層の境界を形

から管理対象リソースのクラスとインスタンスの表

CIMOM、CIM Repository

、およびプロバイ

1 章WDR

第

の概要

■

プロバイダ層。この層には

Solaris

では、を提供し、管理対象リソースに関する情報を取得します。

オペレーティング環境の管理対象リソースの

Solaris

プロバイダが常駐しています。このプロバイダ

CIMOM

Solaris プロバイダが、

CIMOM と管理対象システムリソース間のインタフェースを形成します。

インスタンス

Solaris WBEM Services

ドウェアとも対話します。

コンポーネントは、

Solaris WBEM Services

Solaris

ソフトウェアとも、システムハー

ソフトウェアについての詳細は、

Solaris WBEM Web サイト www.sun.com/software/solaris/wbem を参照して

ください。

負荷均衡などのシステム管理アプリケーションの開発者は、ソフトウェアを使用すると、ソースの使用率レベル情報を入手することができます。システムパフォーマンスデータは、

WDR 自体からは提供されません。

Sun Fire

システムドメイン上での現在使用されているリ

Solaris WBEM Services

CIM Object Manager (CIMOM)

WBEM

は、ソースの情報をプロバイダ経由で転送します。て管理アプリケーションからの接続を受け付け、接続されているクライアントに以下のサービスを提供します。

■

システム上では、

WBEM

管理サービス。ション間、セキュリティーサービス。管理者は、きます。ロギングサービス。このサービスは、ログに動的に録し、ログからそのデータを取り出すアプリケーションを作成するのに使用できるクラスからなります。

XML

スの

クライアント間の情報、

CIMOM が CIM

CIM Repository

サービス。このサービスは

WBEM

クライアントが

CIMOM が CIM

データの意味と構文をチェックし、アプリケー

、および管理対象リソースのデータを配布します。

オブジェクトの管理を行います。

CIMOM Repository

の情報、および管理対象リ

CIMOM は RMI

CIM

情報にアクセスするユーザーを制御で

CIMOM

プロトコルを使用し

イベントデータを記

XML

CIMOM

データを

と通信できるようにします。

CIM

クラスに変換し、

CIMOM

XML

ベー

8 WDR

開発ガイド

WBEM プロバイダ

WDR

にはいくつかのプロバイダクラスがあり、これはいます。間の仲介を行うクラスです。得と設定を行い、さらに操作を実行することもあります。

Solaris WBEM Services

送して、要求側クライアントに配布します。

WBEM プロバイダは、システム上の CIMOM と管理対象オブジェクトとの

WBEM

ソフトウェアに含まれている

プロバイダは、管理対象デバイス上で情報の取

• 2002 年 12

月

MOF

CIMOM

ファイルに記述されて

WBEM

プロバイダでは、

に取り出した情報を転

CIMOM が CIMOM Repository

は、その要求をプロバイダに転送します。プロバイダではその情報に対する要求を受け取ると、

API を使ってその情報を返します。

で取得できない情報に関する要求を受け取った場合

Solaris WBEM ソフトウェア開発キット (SDK)

WDR

アプリケーションの開発者は、

WDR

す。ただし、

WBEM SDK

細は、以下の

www.sun.com/solaris/wbem

では標準のプロトコルセットが使用されているので、

を使用するための要件はありません。

Sun Developer Connection の Web

Solaris WBEM SDK

サイトをご覧ください。

を使用することができま

Solaris

についての詳

1 章WDR

第

の概要

10 WDR

開発ガイド

• 2002 年 12

月

第 2 章

WDR での Solaris WBEM Services の使用方法

Solaris WBEM Services の概要

Solaris WBEM Services 2/02

でさまざまなソフトウェアに含まれており、いるシステムを管理するアプリケーションを簡単に作成できるようになります。

この開発者向けマニュアルには、ればならない

WBEM Services

http://www.sun.com/solaris/wbem

Solaris WBEM Services

るので、ムリソースの管理を行えるようになります。管理対象リソース情報とは、ハードウェアおよびソフトウェアの状態情報、パフォーマンスメトリクス、または負荷均衡の実行やデバイスのフェイルオーバーに対する応答を行うときに管理アプリケーションで必要となるその他のデータなどのことです。この管理対象リソース情報にアクセスできるようにするプログラムが、プロバイダです。

Solaris WBEM Services では、Common Information Model (CIM) を使用して、 Solaris

スキーマを作成します。ルに指定されています。このファイルはにコンパイルされます。

Solaris 9

または

WBEM

Solaris WBEM Services

WDR を使用するアプリケーションでシステムリソース情報の取得とシステ

ソフトウェアが実行されているシステムにある管理対象オブジェクトを表す

オペレーティング環境のいずれかが実行されているドメイン上

サービスを提供しています。

についての詳細は、以下の

WDR

では、

を使用すれば、管理対象リソース情報に安全にアクセスでき

CIM

オブジェクトは

アプリケーション開発者に対して、

Solaris WBEM Services は Solaris

WBEM

Solaris WBEM Services

を使用して

WDR

アプリケーション開発者が理解しておかなけ

に関する情報のみを記載しています。

WDR で提供され、WDR のインストール時

Solaris

Web

サイトを参照してください。

Managed Object Format (MOF)

ソフトウェアが実行されて

に組み込まれている

Solaris 8

Solaris

ファイ

Solaris WBEM Services の層

Solaris WBEM Services

す。各層には、ネントが存在しています。

■

アプリケーション層

■

管理層

■

プロバイダ層

WDR

は、以下の

アプリケーション開発者にとって重要なソフトウェアコンポー

つの層に存在するソフトウェアパッケージで

Solaris WBEM Services のアプリケー

ション層

WDR

アプリケーション開発者にとって特に役立つ、以下のアプリケーション層のソフトウェアプログラムについて、この章で詳しく説明します。

■

ページの「ページの「ページの「ページの「

Solaris Management Console (SMC) WBEM

Managed Object Format (MOF)

Sun WBEM User Manager

コンパイラ」

の使用方法」

Solaris Management Console (SMC)

Solaris WBEM Services

ログビューア」

ユーザーツールの起動」

12 WDR

Sun WBEM User Manager と SMC ユーザーツー

ル

Sun WBEM User Manager

と、システム管理者は、承認ユーザーの追加と削除、管理対象リソースに対する承認ユーザーのアクセス権の設定を行うことができます。

Solaris

ズムには、

(RBAC)

ユーザーを既存のり・書き込みアクセス権のいずれかを与えるときには、します。

RBAC

ソフトウェアが実行されているドメインでセキュリティーを管理するメカニ

WBEM

という異なる

アクセス制御リスト

つのメカニズムがあります。

ACL

に追加し、そのユーザーに読み取りアクセス権または読み取

を使ってユーザーを追加して、そのユーザーの役割と特権を与えるときには、

Solaris Management Console (SMC)

開発ガイド

• 2002 年 12

月

および

SMC

ユーザーツールアプリケーションを使用する

(ACL) と Solaris

役割によるアクセス制御

WBEM User Manager を使用

のユーザーツールを使用します。

ACL と RBAC

ティーの管理方法についての詳細は、ス」を参照してください。

によるシステムセキュリティーの詳細を含めた、

ページの「

WBEM

セキュリティーサービ

セキュリ

Solaris Management Console (SMC) WBEM ログビューア

SMC WBEM ログビューアには、コマンドを発行したユーザー名、コマンドが発行さ

れたクライアントコンピュータなどの情報が記録されているログファイルが表示されます。

Solaris WBEM Services

含まれています。ログファイル、ログファイルに関連する規則、ログファイル形式、開発者がシステムイベントの記録に使用するクラス、およびログサービスを使用可能にする API サービス」

の使用方法についての詳細は、

(

およびそれ以降の節) を参照してください。

には、システムイベントのロギングを使用可能にする

ページの「

Solaris WBEM

API

ロギング

が

Managed Object Format (MOF) コンパイラ

MOF

ファイルのコンパイルには

Solaris

ルは、すオブジェクトが

WDR

にはスを表すオブジェクトから構成されるスキーマを定義します。は、すべての

Fire 15K

3800

または

MOF

コンパイラは、クラスとインスタンスが定義されている

テートメントを読み取ってから、そのステートメントを

Repository

領域です。

ソフトウェアが実行されているシステムの管理対象オブジェクトを表

CIM

スキーマで指定されている

MOF

ファイルが

Sun Fire

12K

および

システム用です。

に追加します。これは、管理データに関する情報が集められている記憶

システムに対して使用されます。もう

システム用で、3 つめのファイルは

MOF

コンパイラを使用します。この

ASCII

つ含まれており、これらファイルで、管理対象リソー

テキストファイルです。

MOF

ファイ

ファイルの

つのファイルは

Sun Fire 6800、4810、4800

MOF

ファイルのス

CIM Object Manager

つ

Sun

mofcomp コマンド

MOF

コンパイラを起動し、

ドを使用します。

MOF

ファイルをコンパイルするには、

/usr/sadm/bin/mofcomp [-help] [-v] [-sc] [-si] [-sq] [-version] [-c cimom_

ホスト名

] [-u

ユーザー名

2 章WDR での Solaris WBEM Services

第

] [-p

パスワード] ファイル名

mofcomp

の使用方法

コマン

コマンドの各引数は以下を意味します。

表 2-1 mofcomp コマンドの引数

引数説明

-help

-v

-sc

-si

-sq

-version

mofcomp

すべてのコンパイラメッセージが表示される冗長モードで、コンパイラを実行します。

“set class”

のオプションは、クラスがすでに存在していて、そのクラスにインスタンスが含まれていない場合はクラスを更新し、クラスが存在していない場合はエラーを返します。ションを指定しないときは、コンパイラでは接続されているネームスペースにしている場合にエラーを返します。

“set instance”

このオプションは、インスタンスがすでに存在している場合はインスタンスを更新し、インスタンスが存在していない場合はエラーメッセージを返します。ないときは、コンパイラでは接続されているネームスペースに

CIM

ている場合にエラーを返します。

“set qualifier types”

ます。このオプションは、修飾子がすでに存在している場合は修飾子を更新し、修飾子が存在していない場合はエラーメッセージを返します。は、コンパイラでは接続されているネームスペースに飾子を追加し、修飾子がすでに存在している場合にエラーを返します。

MOF

コマンドの引数を一覧表示します。

オプションを付けてコンパイラを実行します。こ

-sc

オプ

クラスを追加し、クラスがすでに存在

CIM

オプションを付けてコンパイラを実行します。

-si

オプションを指定し

インスタンスを追加し、インスタンスがすでに存在し

オプションを付けてコンパイラを実行し

-sq

オプションを指定しないとき

CIM

コンパイラのバージョン番号を表示します。

修

14 WDR

開発ガイド

-c cimom_

• 2002 年 12

ホスト名

月

CIM Object Manager

を実行しているシステムを指定します。

表 2-1 mofcomp コマンドの引数 (続き)

引数説明

-u

ユーザー名

-p

パスワード

ファイル名コンパイルする

CIM Object Manager

す。

CIM Object Manager

-u

ルでは、

-p

と -u

もたらす可能性があるので、コマンド行にパスワードを入力する必要があります。より安全にパスワードを指定する方法は、コンパイラからパスワードを入力するプロンプトが表示されるように、ジの「ください。

CIM Object Manager

す。ルでは、このオプションを使用してください。

-p

ともたらす可能性があるので、コマンド行にパスワードを入力する必要があります。より安全にパスワードを指定する方法は、コンパイラからパスワードを入力するプロンプトが表示されるように、ジの「ください。

ユーザー名オプションを使用してください。

の両方を指定する場合は、セキュリティーに危険を

mofcomp

-u

の両方を指定する場合は、セキュリティーに危険を

mofcomp

に接続する際のユーザー名を指定しま

へのアクセス権を要求するコンパイ

-p

ではなく

のパスワード保護のアドバイス」を参照して

-p

ではなく

のパスワード保護のアドバイス」を参照して

MOF

-u

を指定する方法です。

に接続する際のパスワードを指定しま

へのアクセス権を要求するコンパイ

-u

を指定する方法です。

ファイルの名前。

ペー

MOF ファイルのコンパイル

ファイル名に

MOF

をコンパイルできます。ファイルは、

MOF ファイルのコンパイル方法

▼

オプションを付けないで

/usr/sadm/mof

します。

# mofcomp

ファイル名

以下に例を示します。

# mofcomp /usr/sadm/mof/Solaris_Application1.0.mof

Solaris_Application1.0.mof

Manager Repository

という拡張子が含まれていてもいなくても、

.mof

CIM

スキーマと

Solaris

スキーマが記述されている

にあります。

MOF

コンパイルを実行するときは、以下のコマンドを入力

という名前の

MOF

にコンパイルされます。

2 章WDR での Solaris WBEM Services

第

ファイルが、

ファイル

MOF

CIM Object

の使用方法

mofcomp

のパスワード保護のアドバイス

mofcomp

し、コマンド行にパスワードを入力した場合には、他のユーザーが後で ps コマンドまたは能性があります。このときシステムからは、セキュリティー警告は表示されません。

注 –

のコマンドの実行後、ただちにパスワードを変更してください。これにより、自分の現在のパスワードを他のユーザーが表示することはありません。

安全ではないす。

% mofcomp -p Log8Rif

% mofcomp -up molly Log8Rif

上記のいずれかの方法でだちにパスワードを変更してください。

コマンドを、

history

コマンド行でパスワードを入力するよう求めるコマンドを実行したときは、そ

コマンドを実行して、その前に入力されたパスワードを表示する可

(セキュリティーが保護されない) コマンドの使用例を以下に示しま

Solaris WBEM Services

WDR

アプリケーション開発者にとって役立つフトウェアプログラムは、す。

オプション、または -p と -u オプションを付けて実行

-p

mofcomp

コマンドを使用する場合は、コマンド実行後、た

の管理層

Solaris WBEM Services

Common Information Model (CIM) Object Manager

の管理層のソ

で

16 WDR

CIM Object Managerとは

Solaris WBEM Services Object Manager

ボード、接続点などの管理対象システムオブジェクトを表します。

まず CIM Object Manager では、RMI または XML/HTTP プロトコルのいずれかを使用して、管理アプリケーションへの接続を受け付けて、

Repository

ス要求を待ちます。サービスには以下のものがあります。

■

管理サービス。拠していることを確認し、アプリケーション管理データ、

開発ガイド

• 2002 年 12

が組み込まれています。個々の

への接続を設定してから、クライアントアプリケーションからのサービ

CIM

CIM Repository

月

WBEM

には、

データ操作の意味と構文をチェックして最新の

対応システムでオブジェクトを管理する

CIM

オブジェクトは、

CIM Object Manager

(WDR アプリケーションなど) 間の

、および管理対象リソースを配布します。

CPU

CIM

、入出力

仕様に準

■

セキュリティーサービス。ユーザーのログイン要求を認証し、システムリソースへのアクセスを制御します。

■

ロギングサービス。システムイベントを記録します。

WBEM

きます。要求するび削除、プロパティー値の取り出し、指定したクラス階層内のクラスまたはそのインスタンスの列挙などがあります。

クライアントは

WBEM

対応システムに接続されると、

操作には、

CIM

クラスとインスタンスの作成、表示、およ

WBEM

操作を要求で

手動による CIM Object Manager の起動と停止

CIM Object Manager

通常、いうユーティリティーによりドメインを起動するたびに、自動的に起動されます。このコマンドは、も起動します。両者はそれぞれ単一のプロセスとして実行されます。

CIM Object Manager

必要が生じたときには手動で行うこともできます。構文は次の通りです。

/etc/init.d/init.wbem start|stop|status

start

オプションを指定すると、このコマンドによって呼び出されたドメイン上で

CIM Object Manager

上でメイン上での

CIM Object Manager

は、インストール時と、

だけでなく

Solaris Management Console (SMC)

/etc/init.d/init.wbem

と

を手動で起動したり停止したりする必要はありませんが、その

ユーティリティーの

が起動します。

が停止します。

init.wbem

オプションを指定すると、そのドメイン

stop

status

の状態が表示されます。

オプションを指定すると、そのド

CIM Object Manager を起動する

▼

システムプロンプトで以下のコマンドを入力し、スーパーユーザーとなります。

% su

2. root

システムプロンプト

ます。

以下のコマンドを入力して、

に、ドメインのスーパーユーザーのパスワードを入力し

(#)

CIM Object Manager

を起動します。

# /etc/init.d/init.wbem start

CIM Object Manager を停止する

▼

システムプロンプトで以下のコマンドを入力し、スーパーユーザーとなります。

% su

2 章WDR での Solaris WBEM Services

第

の使用方法

プロンプトが表示されたら、

ユーザーのパスワードを入力します。

root

システムプロンプト

に、ドメインのスーパー

(#)

以下のコマンドを入力して、

CIM Object Manager

を停止します。

# /etc/init.d/init.wbem stop

Solaris WBEM Services

役立つ

Solaris

プロバイダというソフトウェアプログラムが含まれています。

のプロバイダ層には、

のプロバイダ層

WDR

アプリケーション開発者に特に

Solaris プロバイダ

Solaris

は、ム上の管理対象リソースのインスタンスを提供し、管理対象デバイスの情報を取り出して設定します。

WDR

きには、まずトでユーザーに与えられているのは、

WBEM

リティーサービス」を参照してください。

プロバイダは、管理対象オブジェクトと通信するクラスです。プロバイダ

CIM Object Manager に Solaris

オペレーティング環境が実行されているシステ

アプリケーションが管理対象リソースに関する

WBEM

でドメイン上のユーザーログイン情報を確認します。デフォル

Read Only (

システムのセキュリティーについての詳細は、

CIM

データにアクセスすると

読み取り専用) アクセス権です。

ページの「

WBEM

セキュ

18 WDR

CIM Object Manager

信します。アプリケーションからと、

CIM Object Manager

イダに渡します。

プロバイダは、マシン固有の独自のプロバイダであっても、

を使って記述した移植性がある (マシンに依存しない) ものでも構いません。な

(JNI)

Java Native Interface (JNI) は、Java™ Development Kit (JDK™)

お、す。

開発ガイド

• 2002 年 12

月

では、オブジェクトプロバイダ

CIM Object Manager

はプロバイダ

API

を使用してプロバイダと通

の動的データの要求がある

経由で応答し、要求された情報をプロバ

Java Native Interface

に含まれていま

WBEM

セキュリティーサービス

WBEM

リティー機能には、以下の

■

対応システム上で不正アクセスから

認証承認再実行保護

つがあります。

CIM

オブジェクトを保護する主なセキュ

認証

認証とは、識別情報を確認するプロセスのことです。正当なユーザーにはシステムリソースへのアクセスを許可し、認証できないユーザーにはアクセスを拒否する場合、認証がよく使用されます。

ユーザーがログインして、ユーザー名とパスワードを入力すると、クライアントではそのパスワードを使って、サーバーで確認される暗号化ダイジェストを生成します。ユーザーが認証されると、アントセッションを確立します。それ以降の操作はすべてセキュリティー保護されたクライアントセッション内で行われ、すべての操作には、認証プロセス時にネゴシエートされたセッションキーを使用するンとは、メッセージを認証するときに使用されるセキュリティー情報が格納され、遠隔呼び出しに追加されるトークンパラメタのことです

Sun Fire

システムにおいて、ユーザー、デバイスなどのエンティティーの

CIM Object Manager は MAC

MAC

トークンが含まれます

トークンを与えて、クライ

(MAC

)

。

トーク

承認

承認とは、ユーザー、プログラム、プロセスに対し、システムリソースにアクセスする権利を与えるプロセスのことです。承認は、認証に続いて行われます。

CIM Object Manager

て、ユーザーがアプリケーションや関連タスクの実行を許可されているかどうか確認できます。の承認では、特権ユーザーが他のユーザーに読み取り・書き込みアクセス権を割り当てることができます。このようにして承認されたユーザーは、既存のザーアカウントに追加されます。

CIM Object Manager では、機能ベースの承認をサポートしています。こ

でユーザーの識別情報が認証された後、その識別情報を使用し

2 章WDR での Solaris WBEM Services

第

Solaris

ユー

の使用方法

再実行保護

再実行保護は、セッションキーを確認することにより、未承認クライアントが、他のクライアントのメッセージを受信してサーバーに送信するのを防止するサービスです。

クライアントは、他のクライアントからメッセージをコピーすることはできません。シエートされたセッションキーに基づいて、すべてのメッセージでことにより、そのセッションを開始してクライアントサーバー認証に加わっていたクライアントとの間で、クライアントサーバーセッションの全通信が確かに行われていることを保証します。

MAC

を使用して、メッセージがそのセッションに対してもともと認証を受けていたクライアントから送信されたものであること、およびそのメッセージが他のクライアントによって再実行されたものでないことを確認します。このタイプのメカニズムは、RMI 中にネゴシエートされたセッションキーは、メッセージのティー情報の暗号化に使用されます。

メッセージを検証するときに

CIM Object Manager

WBEM

で使用されます。ユーザー認証の交換

に送信された最新の

は、認証時にネゴ

MAC

トークンのセキュリ

を使用する

デジタル署名

WBEM

ん。

セキュリティーサービスでは、メッセージのデジタル署名は実行されませ

セキュリティーの実装

Solaris

ス制御リストを使用します。

オペレーティング環境内でセキュリティーを管理するときは、

WBEM

アクセ

20 WDR

WBEM

アクセス制御リストによるセキュリティーは、義されているクラスを使って実装します。御リストによるセキュリティーは、であり、すべてのによって、デフォルトの承認が決定されます。

開発ガイド

• 2002 年 12

アクセス制御リスト

CIM 操作に適用されます。定義されているクラスのインスタンス

WBEM

ユーザーやネームスペース、あるいはその両方に割り当てられる

月

Solaris_Acl1.0.mof

Solaris WBEM Services

ファイルに定

固有のアクセス制

のデフォルトの承認方式

ユーザーを既存のアクセス制御リストに追加して、そのユーザーに読み取りアクセス権または読み取り・書き込みアクセス権のいずれかを割り当てるときは、

WBEM User Manager Manager

」の節で説明します。Sun WBEM User Manager は、

/usr/sadm/bin/wbemadmin

を使用します。これについては、「Sun WBEM User

ディレクトリにあります。

Sun

詳細は、い。

ページの「

Sun WBEM User Manager

除、および承認ユーザーのシステム上で行うことができます。すべてのユーザーはを持っている必要があります。

Sun WBEM User Manager

スペースの組み合わせで、アクセス権を設定できます。ユーザーを追加してネームスペースを選択すると、ユーザーは指定したネームスペース内のの読み取りアクセス権をデフォルトで持つことができます。

つのネームスペースに対するすべてのユーザーのアクセスを制限してから、ユーザーごとに、そのネームスペースに対する読み取り、読み取り・書き込み、または書き込みアクセスを許可することができます。

個々の管理対象オブジェクトにはアクセス権を設定できません。ただし、ネームスペース内と各ユーザーについては、すべての管理対象オブジェクトのアクセス権を設定できます。

Sun WBEM User Manager

の使用方法」を参照してくださ

の使用方法

を使用すると、特権ユーザーは、承認ユーザーの追加と削

CIM

オブジェクトへのアクセス権の設定を、

Solaris

では、個々のネームスペースで、またはユーザーとネーム

ユーザーアカウント

CIM

WBEM

オブジェクトへ

対応

スーパーユーザーとしてログインしている場合は、

CIM

て、以下のような

■

Read Only (

可します。読み取り専用アクセス権を持っているユーザーは、インスタンスとクラスを取り出すことはできますが、ません。デフォルトのユーザーアクセス権です。

■

Read/Write (

対する読み取り、書き込み、および削除をすべて許可します。

■

Write (書き込み) — すべての CIM クラスおよびインスタンスに対する書き込みと

削除を許可しますが、読み取りは許可しません。

■

None (

可しません。

読み取り専用

読み取り・書き込み

アクセス権なし

オブジェクトに対するアクセス権を設定できます。

) — CIM

スキーマ内のオブジェクトの読み取りのみを許

CIM

オブジェクトの作成、削除、変更はでき

) —

すべての

クラスおよびインスタンスに対するアクセスを許

2 章WDR での Solaris WBEM Services

第

WBEM User Manager

CIM

クラスおよびインスタンスに

の使用方法

を使用し

Sun WBEM User Manager を起動する

▼

スーパーユーザーとして、以下のコマンドをコマンド行に入力します。

# /usr/sadm/bin/wbemadmin

Sun WBEM User Manager

れます。コンテキストヘルプを使用するには、ダイアログのフィールドをクリックして、「コンテキストヘルプ」パネルを表示します。

「ログイン」ダイアログボックスの「ユーザー名」フィールドにユーザー名を入力し

ます。

ログインするには、ている必要があります。デフォルトでは、持っています。このアクセス権は、ユーザーにデフォルトのネームスペースへの読み取りアクセスを許可します。読み取りアクセス権を持っているユーザーは、ユーザー特権を表示することはできますが、変更はできません。

ユーザーにアクセス権を与えるには、スーパーユーザーか、またはネームスペースへの書き込みアクセス権を持っているユーザーとしてログインする必要があります。

「ログイン」ダイアログボックスの「パスワード」フィールドに、ユーザーアカウン

トのパスワードを入力します。

「了解」をクリックします。

User Manager

「と、現在のドメイン上のネームスペース内のザーのアクセス権が表示されています。

root\security

」ダイアログボックスが表示されます。ここには、ユーザーの一覧

が読み込まれ、「ログイン」ダイアログボックスが表示さ

ネームスペースへの読み取りアクセス権を持っ

Solaris

ユーザーは

guest

アクセス権を

root\security

WBEM

オブジェクトに対する各ユー

22 WDR

ユーザーにデフォルトのアクセス権を与える

▼

1. Sun WBEM User Manager

2.「User Manager

リックします。

ドメイン上で使用可能なネームスペースがすべて表示されているダイアログボックスが表示されます。

「ユーザー名」フィールドに

使用可能なネームスペースのリストからネームスペースを

「了解」をクリックします。

「

User Manager

ユーザー名が追加されます。

開発ガイド

• 2002 年 12

」ダイアログボックスの「ユーザーアクセス」部分で「追加」をク

」ダイアログボックスに表示されているユーザーのリストに、その

月

を起動します。

Solaris

ユーザーのアカウント名を入力します。

つ選択します。

「了解」をクリックして変更を保存し、「

じます。または、「適用」をクリックして変更を保存し、「ログボックスを閉じます。

User Manager

」ダイアログボックスを閉

User Manager

」ダイア

これで、指定したユーザーに、選択したネームスペースのる読み取り専用アクセス権が与えられました。

ユーザーのアクセス権を変更する

▼

1. Sun WBEM User Manager

ユーザーのアクセス権が表示されているリストから、変更するユーザーを選択しま

す。

そのユーザーに読み取り専用アクセス権を与えるには、「読み取り」チェックボック

スをクリックします。そのユーザーに書き込みアクセス権を与えるには、「書き込み」チェックボックスをクリックします。

「了解」をクリックして変更を保存し、「

じます。または、「適用」をクリックして変更を保存し、「ログボックスを閉じます。

ユーザーのアクセス権を削除する

▼

1. Sun WBEM User Manager

2.「User Manager

アクセス権が表示されているリストから、アクセス権を削除するユーザーを選択します。

」ダイアログボックスの「ユーザーアクセス」部分で、ユーザーの

を起動します。

User Manager

を起動します。

CIM

オブジェクトに対す

」ダイアログボックスを閉

User Manager

」ダイア

「削除」をクリックし、そのユーザーのネームスペースに対するアクセス権を取り消

します。

確認を求めるダイアログボックスが表示され、そのユーザーのアクセス権を取り消してよいか確認を求められます。「了解」をクリックして、次に進みます。

「了解」をクリックして変更を保存し、「

じます。または、「適用」をクリックして変更を保存し、「ログボックスを閉じます。

ネームスペースへのアクセス権を設定する

▼

1. Sun WBEM User Manager

を起動します。

2 章WDR での Solaris WBEM Services

第

User Manager

」ダイアログボックスを閉

User Manager

の使用方法

」ダイア

2.「User Manager

「追加」をクリックします。

ドメインで使用可能なネームスペースがすべて表示されているダイアログボックスが表示されます。

アクセス権を設定するネームスペースを選択します。

ユーザーにはデフォルトでネームスペースへの読み取り専用アクセスが許可されており、「読み取り」チェックを与えるには、「書き込み」チェックボックスをクリックします。読み取り・書き込みアクセス権を与えるには、「読み取り」と「書き込み」チェックボックスをクリックします。ネームスペースへのアクセスを許可しないときは、「読み取り」と「書き込み」の両方のチェックボックスがチェックされていないことを確認します。

」ダイアログボックスの「ネームスペースへのアクセス」部分で

ボックスがチェックされています。書き込みアクセス権

「了解」をクリックして変更を保存し、「

じます。または、「適用」をクリックして変更を保存し、「ログボックスを閉じます。

ネームスペースへのアクセス権を削除する

▼

1. Sun WBEM User Manager

2.「User Manager

アクセス権を削除するネームスペースを選択し、「削除」をクリックします。

これにより、選択したネームスペースからアクセス権が削除され、「

Manager

ネームスペースが削除されます。

「了解」をクリックして変更を保存し、「

じます。または、「適用」をクリックして変更を保存し、「ログボックスを閉じます。

API

」ダイアログボックスに表示されているネームスペースのリストからその

を使用したアクセス制御の設定

」ダイアログボックスの「ネームスペースへのアクセス」部分で、

を起動します。

User Manager

」ダイアログボックスを閉

User Manager

」ダイアログボックスを閉

User Manager

」ダイア

User

」ダイア

24 WDR

Sun WBEM SDK API

とのアクセス制御を設定することができます。以下のセキュリティークラスが

root\security

Solaris_Acl - Solaris

■

は、文字列プロパティー

)

に設定します。

専用

Solaris_UserAcl -

■

てユーザーが持っているアクセス制御です。

開発ガイド

• 2002 年 12

月

を使用して、ネームスペースでのアクセス制御や、ユーザーご

ネームスペースに格納されています。

アクセス制御リスト (ACL) の基底クラス。このクラスで

capability

を定義し、そのデフォルト値を

指定されたネームスペース内で、

CIM

“r” (

読み取り

オブジェクトに対し

Solaris_NamespaceAcl -

■

ネームスペース上のアクセス制御です。

Solaris_UserACL

ンスタンスのアクセス権を変更すると、ネームスペース内の

クラスのインスタンスを作成してから、API を使用してそのイ

CIM

オブジェクトに対

するアクセス制御を、ユーザーごとに設定できます。同様に、

Solaris_NameSpaceACL (setInstance

メソッドなど) を使用して、そのインスタンスのアクセス権を設定す

クラスのインスタンスを作成してから、

ると、ネームスペースでのアクセス制御を設定することができます。

この

つのクラスを効果的に組み合わせて使用するには、まず

Solaris_NameSpaceACL

るすべてのユーザーのアクセスを制限し、次に

クラスを使って、ネームスペースのオブジェクトに対す

Solaris_UserACL

API

クラスを使って、選択したユーザーにそのネームスペースへのアクセスを許可する方法があります。

注

アクセス制御リスト

–

す。現在

Solaris ACL

(ACL) は、DMTF

スキーマは

CIM

が作成中の標準規格によって管理されま

に準拠していますが、

DMTF

により

ACL

準規格が最終的に策定されたときには、このスキーマを変更する必要があります。

Solaris ACL

となる可能性があります。

スキーマクラスを使用して記述しているプログラムも、この変更の対象

Solaris_UserAcl クラス

Solaris_UserAcl

底クラスから

capability

“r” (Read Only)

を継承します。

クラスは

Solaris_Acl

基底クラスを拡張したもので、この基

のデフォルト値を持つ文字列プロパティー

標

Solaris_UserAcl

クラスの

capability

定すると、アクセス権を設定できます。

表 2-2 capability プロパティーの設定

アクセス権説明

none

Read Only (

Read/Write (

書き込み

Write (

Only (

単独使用

読み取り専用

読み取り・書き込み

)

2 章WDR での Solaris WBEM Services

第

プロパティーを以下のいずれかの値に設

)

の使用方法

Solaris_UserAcl

の主要なプロパティーが定義されます。

2 つの namespace-username ACL でどちらか 1 つのインスタンスだけです。

の

表 2-3 Solaris_UserAcl クラスの主要プロパティー

プロパティーデータ型目的

nspace

username

ユーザーごとにアクセス制御を設定する

▼

クラスでは、

文字列この

capability

が適用されるネームスペースを特定する。

ACL

が適用されるユーザーを特定する。

ACL

プロパティーのほかにも以下の

つのネームスペースに存在できるのは、こ

つ

以下のコードを使用して、

Solaris_UserAcl

クラスのインスタンスを作成します。

...

/* Create a namespace object initialized with root\security

(name of namespace) on the local host. */

CIMNameSpace cns = new CIMNameSpace("", "root\security");

// Connect to the root\security namespace as root.

cc = new CIMClient(cns, "root", "root_password");

// Get the Solaris_UserAcl class

cimclass = cc.getClass(new CIMObjectPath("Solaris_UserAcl");

// Create a new instance of the Solaris_UserAcl

class ci = cimclass.newInstance(); ...

以下のコードを使用して、ます。

capability

プロパティーを目的のアクセス権に設定し

...

/* Change the access rights (capability) to read/write for

user Guest

on objects in the root\molly namespace.*/

ci.setProperty("capability", new CIMValue(new String("rw"));

ci.setProperty("nspace", new CIMValue(new String("root\

molly"));

ci.setProperty("username", new CIMValue(new String("guest"));

...

26 WDR

開発ガイド

• 2002 年 12

月

以下のコードを使用して、新規作成したインスタンスを更新します。

...

// Pass the updated instance to the CIM Object Manager

cc.setInstance(new CIMObjectPath(), ci);

...

Solaris_NamespaceAcl クラス

Solaris_NamespaceAcl

この基底クラスからデフォルト値を持つ文字列プロパティー

”r” (GUEST

Solaris_NamespaceAcl

す。

プロパティーデータ型目的

nspace

ネームスペースでのアクセス制御を設定する

▼

以下のコードを使用して、

す。

文字列このアクセス制御リスト

クラスは

クラスでは、以下の主要なプロパティーが定義されま

Solaris_namespaceACL

Solaris_Acl

と全ユーザーに対する読み取り専用アクセス権) の

capability

ペースを特定する。は、

namespace ACL で 1

基底クラスを拡張したもので、

を継承します。

が適用されるネームス

(ACL)

つのネームスペースに存在できるの

つのインスタンスだけです。

クラスのインスタンスを作成しま

...

/* Create a namespace object initialized with root\security

(name of namespace) on the local host. */

CIMNameSpace cns = new CIMNameSpace("", "root\security");

// Connect to the root\security namespace as root.

cc = new CIMClient(cns, "root", "root_password");

// Get the Solaris_namespaceAcl class

cimclass = cc.getClass(new

CIMObjectPath("Solaris_namespaceAcl");

// Create a new instance of the Solaris_namespaceAcl

class ci = cimclass.newInstance();

...

2 章WDR での Solaris WBEM Services

第

の使用方法

以下のコードを使用して、目的のアクセス権を許可するよう

を設定します。

...

/* Create a namespace object initialized with root\security

(name of namespace) on the local host. */

CIMNameSpace cns = new CIMNameSpace("", "root\security");

// Connect to the root\security namespace as root.

cc = new CIMClient(cns, "root", "root_password");

// Get the Solaris_namespaceAcl class

cimclass = cc.getClass(new

CIMObjectPath("Solaris_namespaceAcl");

// Create a new instance of the Solaris_namespaceAcl

class ci = cimclass.newInstance();

...

以下のコードを使用して、新しく作成したインスタンスを更新します。

// Pass the updated instance to the CIM Object Manager

cc.setInstance(new CIMObjectPath(), ci);

capability

プロパティー

28 WDR

Solaris Management Console (SMC)

ユーザーツールの起動

ユーザーツールを使用すると、ユーザーを既存の役割に追加し、既存のユー

SMC

ザーに

RBAC

「権利」部分で管理されます。

SMC ユーザーツールを起動する

▼

以下のコマンドを入力して、

# cd /usr/sbin

以下のコマンドを入力して、

# smc

開発ガイド

• 2002 年 12

権を許可することができます。

SMC

起動コマンドの場所に移動します。

SMC

を起動します。

月

RBAC

権は、

SMC

ユーザーツールの

アプリケーションが読み込まれ、ユーザーインタフェースが表示されたら、左側の

(

「ナビゲーション」パネルの「このコンピュータ」をダブルクリック

)

のコンピュータ」の横にある展開・縮少アイコンをクリックピュータ」の下位のツリーを展開します。

左側の「ナビゲーション」パネルの「システム構成」をダブルクリック (または、「システム構成」の横にある展開・縮少アイコンをクリック成」の下位のツリーを展開します。「ユーザー」アイコンが表示されます。

「ユーザー」アイコンをクリックして、ユーザーツールを起動します。

して、「このコン

)

して、「システム構

または、「こ

注 – Solaris Management Console

を参照してください。

Solaris WBEM

WBEM

し、その発生状況を判定することができます。

ロギングサービスでは、サービスプロバイダから返されるようにプログラムされているアクションと、べて記録します。また、情報とエラーメッセージもログに記録できます。

たとえば、ユーザーがシリアルポートを使用不可にしたときに、シリアルポートプロバイダによって自動的にこの情報をログに記録することができます。あるいは、システムエラーなどの障害が発生したときには、管理者はログを調べて、その障害の原因を突き止めることができます。

イベントに応じて、すべてのコンポーネント、アプリケーション、およびプロバイダが自動的にロギングを開始します。たとえば、されて起動されると、自動的にイベントを記録します。

WBEM

することができます。詳細は、グの有効化」を参照してください。

ロギングサービスを使用すると、システム管理者はシステムイベントを監視

Solaris WBEM Services

環境用に開発するアプリケーションとプロバイダでログを記録するよう設定

の使用方法の詳細は、

ロギングサービス

コンポーネントが実行するアクションをす

CIM Object Manager

ページの「

API

を使用した

smc (1m)

Solaris WBEM

マニュアルページ

はインストール

ロギン

Solaris Management Console (SMC)

たログ機能をデバッグすることができます。ログファイルの表示方法の詳細は、ページの「ださい。

Solaris WBEM

ログビューア」と

ログビューアにログデータを表示して、設定し

smc(1m)

2 章WDR での Solaris WBEM Services

第

マニュアルページを参照してく

の使用方法

Solaris WBEM Services

イベントを記録するようにアプリケーションやプロバイダを設定すると、そのイベントはログファイルに記録されます。ログの記録はすべてパスに格納されます。ログファイルでは、次の命名規則が使用されます。

のログファイル

/var/sadm/wbem/log

の

wbem_log.#

ここで、# はログファイルのバージョンを示すために追加される数字です。

wbem_log.1

ンです。番号が付いています。すべてのバージョンのログファイルは、

/var/sadm/wbem/log

以下のル拡張子付きで名前変更され、保存されます。

■

現在のファイルが、るファイルサイズの限界に達した場合。デフォルト値は

wbemService.properties

ログファイルの使用方法をティーがどのように制御するかについては、のログファイル規則」を参照してください。

Solaris_LogService

■

で呼び出された場合。

Solaris_LogService

「

のように “.1” が付いているログファイルが最後に保存されたバージョ

“.2”

が付いているログファイルはその前のバージョンで、このように順に

にアーカイブとしてまとめて入れられています。

つの条件のいずれかが満たされたときに、ログファイルは

Solaris_LogServiceProperties

クラスで指定されてい

ファイルで設定されています。

Solaris_LogServiceProperties

ページの「

Solaris WBEM Services

クラスの

クラスとそのメソッドについては、

clearLog()

クラス」を参照してください。

メソッドが、現在のログファイル

ページの

というファイ

クラスのプロパ

Solaris WBEM Services のログファイル規則

Solaris_LogServiceProperties

れています。ルの属性を制御するプロパティーがあります。

■

ログファイルを書き込むディレクトリ

■

ログファイルの名前

■

ファイル拡張子付きで名前変更されて保存されるまでに、ログファイルにログを格納できる最大サイズ

■

アーカイブに保持できるログファイル数

■

Solaris

データを書き込む機能

Solaris_LogServiceProperties

オペレーティング環境のデフォルトのログシステムである

クラスは Solaris_Core1.0.mof で定義さ

クラスには、以下のログファイ

SysLog

にログ

30 WDR

開発ガイド

• 2002 年 12

月

これらの属性のいずれかを、ログファイルにデータを書き込むアプリケーションで指定するには、作成し、その関連プロパティーの値を設定します。新しいインスタンスのプロパティー値の設定方法についての詳細は、ティーの設定」を参照してください。

Solaris_LogServiceProperties

39 ページの「Solaris WBEM ロギングプロパ

クラスの新しいインスタンスを

Solaris WBEM Services のログファイル形式

ロギングサービスには、アプリケーション、システム、およびセキュリティーという

つのログ記録のカテゴリがあります。ログ記録は、情報であることも、エラーや警告から生成された記録データであることもあります。ログに記入可能なデータについて、標準的なフィールド設定が定義されていますが、必ずしもログではすべてのフィールドを使用する必要はありません。たとえば、情報ログの場合は、イベントを表す簡潔なメッセージを記録することができます。エラーログの場合は、より詳細なメッセージを記録することができます。

一部のログデータフィールドでは、ます。これらのフィールドは、飾子でフラグが立てられているプロパティーです。これらのフィールドには値を設定することはできません。ただし、ログファイルの以下のフィールドであれば、いずれも値を設定できます。

Category —

■

Severity —

■

AppName —

■

UserName —

■

ユーザー名

ClientMachineName —

■

名

ServerMachineName —

■

SummaryMessage —

■

DetailedMessage —

■

Data —

■

できるコンテキスト情報

ログ記録のタイプデータをログファイルに書き込む条件の重大度

データが取得されたときに使用していたアプリケーションの名前

ログデータが生成されたときに、アプリケーションを使用していた

アプリケーションとプロバイダがログメッセージを解釈するために提示

Solaris_LogRecord

ログデータを生成したイベントが発生したコンピュータ

ログデータを生成したイベントが発生したサーバー名

イベントの発生を説明する簡単なメッセージ

イベントの発生を説明する詳細なメッセージ

CIM Repository

のデータを特定する必要があり

クラスの読み取り専用キー修

Solaris WBEM

Solaris WBEM Solaris_LogService

ロギングサービスでは、

2 つの Solaris

の

ログクラス

Solaris_LogRecord

スキーマクラスを使用します。

2 章WDR での Solaris WBEM Services

第

と

の使用方法

Solaris_LogRecord クラス

Solaris_LogRecord

ログファイルのエントリをモデル化します。イベントに応じてアプリケーションやプロバイダにより

Solaris_LogRecord クラスが呼び出されると、

Solaris_LogRecord

ログファイルに書き込みます。

Solaris_LogRecord Solaris_Core1.0.mof

/usr/sadm/mof

ルは

Solaris_LogRecord

て、イベント、システム、ユーザー、およびデータを生成するアプリケーションまたはプロバイダの属性を指定します。読み取り専用修飾子の値は、アプリケーションと

CIM Repository RecordID

ときには、ログ形式の一部としては表示されません。

書き込み可能な修飾子の値を設定できます。たとえば、イベントが発生したシステムを特定する、ティーの修飾子の値を設定することができます。

SysLogFlag

に

UNIX

という値はログエントリを一意に特定しますが、生成されたデータを見る

ClientMachineName

プロパティーを真に設定すると、ログ記録の詳細メッセージが自動的

システムの

クラスは、

クラスでは、イベントによって生成されたすべてのデータを

クラスの定義を見るには、テキストエディタに

ファイルを表示します。

にあります。

クラスでは、プロパティーのベクトルとキー修飾子を使用し

との間で使用するために透過的に生成されます。たとえば、

syslog

Solaris_Core1.0.mof

Solaris

プロバイダの一部として

Solaris_Core1.0.mof

ServerMachineName

や

デーモンに送信されます。

ファイルで定義され、

ファイ

といったプロパ

Solaris_LogService クラス

32 WDR

Solaris_LogService

方法を定義します。このクラスには、発行元アプリケーションから

Manager

用できるを生成するトリガーとなり、す。

に特定のイベントに関するデータを配布するときにアプリケーションで使

組のメソッドがあります。そのデータが

Solaris_LogService

clearLog —

■

ルの削除を行う。

getNumRecords —

■

listLogFiles — /usr/sadm/wbem/log

■

イルのリストを返す。

getCurrentLogFileName —

■

getNumLogFiles — /usr/sadm/wbem/log

■

を返す。

getLogFileSize —

■

開発ガイド

• 2002 年 12

クラスは、ロギングサービスの操作を制御し、ログデータの処理

CIM Repository

クラスでは、以下のメソッドを使用します。

現在のログファイルの名前変更と保存、保存されているログファイ

特定のログファイルに含まれているレコード数を返す。

最新のログファイル名を返す。

特定のログファイルのサイズをメガバイト単位で返す。

月

からのデータの取得などが行われま

に格納されているすべてのログファ

に格納されているログファイル数

CIM Object

CIM Object Manager

からの応答

getSyslogSwitch — Solaris

■

SysLog getLogStorageName —

■

はデバイスの名前を返す。

getLogFileDir —

■

返す。

に、ログデータを送信できるようにする。

ログファイルが格納されているディレクトリのパスと名前を

オペレーティング環境のロギングサービスである

ログファイルが格納されているホストコンピュータまた

Solaris_LogServiceProperties

ティーを設定できます。を参照してください。

Solaris_LogService Solaris_Core1.0.mof

API

を使用した

39 ページの「Solaris WBEM ロギングプロパティーの設定」

クラスの定義は、

ファイルで見ることができます。

クラスを使用すると、ロギングのプロパ

/usr/sadm/mof

にある

Solaris WBEM

ロギング

の有効化

現在、ログファイルの内容はログビューアで見ることができます。しかし、カスタマイズされた方法でのログファイルの表示を望む場合は、独自のログビューアを開発することができます。ロギングアプリケーションプログラミングインタフェースを使用すると、ログビューアを開発できます。このきます。

■

アプリケーションからログファイルへのデータの書き込み

■

ログファイルからログビューアへのデータの読み取り

■

ログデータの処理方法を指定するロギングプロパティーの設定

API

では、以下のことを実行で

(API)

Solaris WBEM ログファイルへのデータの書き込み

アプリケーションでログファイルにデータを書き込めるようにするには、以下の主なタスクが必要です。

■

Solaris_LogRecord

■

ログファイルに書き込まれるプロパティーを指定し、プロパティー修飾子の値を設定する

■

出力する新しいインスタンスとプロパティーを設定する

クラスの新しいインスタンスを作成する

2 章WDR での Solaris WBEM Services

第

の使用方法

Solaris_LogRecord のインスタンスを作成し

▼

てデータを書き込む

必要な

クラスです。

import java.rmi.*;

import com.sun.wbem.client.CIMClient;

import com.sun.wbem.cim.CIMInstance;

import com.sun.wbem.cim.CIMValue;

import com.sun.wbem.cim.CIMProperty;

import com.sun.wbem.cim.CIMNameSpace;

import com.sun.wbem.cim.CIMObjectPath;

import com.sun.wbem.cim.CIMClass;

import com.sun.wbem.cim.CIMException;

import com.sun.wbem.solarisprovider.*;

import java.util.*;

2. public

CIMNameSpace

public class CreateLog {

if ( args.length != 3) {

}

CIMClient cc = null;

CIMObjectPath cop = null;

try {

クラスをすべてインポートします。以下に挙げるクラスは最小限必要な

Java

クラス

CreateLog

クラスのインスタンスを作成します。

public static void main(String args[]) throws CIMException {

System.out.println("Usage: CreateLog host username password");

System.exit(1);

CIMNameSpace cns = new CIMNameSpace(args[0]);

cc = new CIMClient(cns, args[1], args[2]);

を宣言し、

CIMClient、CIMObjectPath

、および

34 WDR

返されるプロパティーのベクトルを指定します。修飾子のプロパティーの値を設定し

ます。

Vector keys = new Vector();

CIMProperty logsvcKey;

logsvcKey = new CIMProperty("category");

logsvcKey.setValue(new CIMValue(new Integer(2)));

keys.addElement(logsvcKey);

開発ガイド

• 2002 年 12

月

logsvcKey = new CIMProperty("severity");

logsvcKey.setValue(new CIMValue(new Integer(2)));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("AppName");

logsvcKey.setValue(new CIMValue("SomeApp"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("UserName");

logsvcKey.setValue(new CIMValue("molly"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("ClientMachineName");

logsvcKey.setValue(new CIMValue("dragonfly"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("ServerMachineName");

logsvcKey.setValue(new CIMValue("spider"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("SummaryMessage");

logsvcKey.setValue(new CIMValue("brief_description"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("DetailedMessage");

logsvcKey.setValue(new CIMValue("detailed_description"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("data");

logsvcKey.setValue(new CIMValue("0xfe 0x45 0xae 0xda"));

keys.addElement(logsvcKey);

logsvcKey = new CIMProperty("SyslogFlag");

logsvcKey.setValue(new CIMValue(new Boolean(true)));

keys.addElement(logsvcKey);

ログ記録に対して、

CIMObjectPath logreccop = new CIMObjectPath("Solaris_LogRecord", keys);

5. Solaris_LogRecord

CIMObjectPath

の新しいインスタンスを宣言します。ファイルに書き込むプ

クラスの新しいインスタンスを宣言します。

ロパティーのベクトルを設定します。

CIMInstance ci = new CIMInstance();

ci.setClassName("Solaris_LogRecord");

ci.setProperties(keys);

//System.out.println(ci.toString());

2 章WDR での Solaris WBEM Services

第

の使用方法

cc.setInstance(logreccop,ci);

}

catch (Exception e) {

System.out.println("Exception: "+e);

e.printStackTrace();

}

データがログファイルに書き込まれたならば、セッションを閉じます。

// close session.

if(cc != null) {

cc.close();

}

Solaris WBEM ログファイルからのデータの読み取り

アプリケーションでログファイルからログビューアにデータを読み取れるようにするには、以下のタスクが必要です。

■

Solaris_LogRecord

■

目的のインスタンスを取得する

■

出力デバイス (通常はログビューアのユーザーインタフェース) にインスタンスのプロパティーを出力する

クラスのインスタンスを列挙する

36 WDR

Solaris_LogRecord クラスのインスタンスを

▼

取得してデータを読み取る

必要な

クラスです。

import java.rmi.*;

import com.sun.wbem.client.CIMClient;

import com.sun.wbem.cim.CIMInstance;

import com.sun.wbem.cim.CIMValue;

import com.sun.wbem.cim.CIMProperty;

import com.sun.wbem.cim.CIMNameSpace;

import com.sun.wbem.cim.CIMObjectPath;

import com.sun.wbem.cim.CIMClass;

開発ガイド

• 2002 年 12

クラスをすべてインポートします。以下に挙げるクラスは最小限必要な

Java

月

import com.sun.wbem.cim.CIMException;

import com.sun.wbem.solarisprovider.*;

import java.util.*;

import java.util.Enumeration;

クラス

3. ReadLog

ReadLog

public class ReadLog

{

public static void main(String args[]) throws

CIMException

{

if ( args.length != 3)

{

System.out.println("Usage: ReadLog host username password");

System.exit(1);

}

クラスの

を宣言します。

CIMClient

、

CIMObjectPath

、および

設定します。

CIMClient cc = null;

CIMObjectPath cop = null;

try { CIMNameSpace cns = new CIMNameSpace(args[0]);

cc = new CIMClient(cns, args[1], args[2]);

cop = new CIMObjectPath("Solaris_LogRecord");

4. Solaris_LogRecord

Enumeration e = cc.enumInstances(cop, true);

for (; e.hasMoreElements(); ) {

のインスタンスを列挙します。

CIMNameSpace

の値を

出力デバイスにプロパティー値を送信します。

System.out.println("---------------------------------");

CIMObjectPath op = (CIMObjectPath)e.nextElement();

CIMInstance ci = cc.getInstance(op);

System.out.println("Record ID : " +

(((Long)ci.getProperty("RecordID").getValue().getValue()).longVal ue()));

System.out.println("Log filename : " +

((String)ci.getProperty("FileName").getValue().getValue()));

2 章WDR での Solaris WBEM Services

第

の使用方法

int categ = 0

(((Integer)ci.getProperty("category").getValue().getValue()).intV alue());

if (categ == 0)

System.out.println("Category : Application Log");

else if (categ == 1)

System.out.println("Category : Security Log");

else if (categ == 2)

System.out.println("Category : System Log");

int severity =

(((Integer)ci.getProperty("severity").getValue().getValue()).intV alue());

if (severity == 0)

System.out.println("Severity : Informational");

else if (severity == 1)

System.out.println("Severity : Warning Log!");

else if (severity == 2)

System.out.println("Severity : Error!!");

System.out.println("Log Record written by :" +

((String)ci.getProperty("AppName").getValue().getValue()));

System.out.println("User : " +

((String)ci.getProperty("UserName").getValue().getValue()));

System.out.println("Client Machine : " +

((String)ci.getProperty("ClientMachineName").getValue().getValue( )));

System.out.println("Server Machine : " + ((String)ci.getProperty("ServerMachineName").getValue().getValue()) );

System.out.println("Summary Message : " +

((String)ci.getProperty("SummaryMessage").getValue().getValue()) );

System.out.println("Detailed Message : " +

((String)ci.getProperty("DetailedMessage").getValue().getValue() ));

System.out.println("Additional data : " +

((String)ci.getProperty("data").getValue().getValue()));

boolean syslogflag =

((Boolean)ci.getProperty("syslogflag").getValue().getValue()). booleanValue();

if (syslogflag == true) {

38 WDR

開発ガイド

• 2002 年 12

月

System.out.println("Record was written to syslog as well");

} else {

System.out.println("Record was not written to syslog");

}

System.out.println("---------------------------------");

エラー条件が発生した場合は、ユーザーにエラーメッセージを返します。

...

catch (Exception e) {

System.out.println("Exception: "+e);

e.printStackTrace(); }

...

データがファイルから読み取られたならば、セッションを閉じます。

// close session.

if(cc != null) {

cc.close();

}

Solaris WBEM ロギングプロパティーの設定

Solaris_LogServiceProperties

スタンスのプロパティー値を設定すると、アプリケーションやプロバイダがログを処理する方法を制御できます。

Solaris WBEM ロギングプロパティーを設定する

▼

以下のコード例では、ロギングプロパティーの設定方法を示します。プロパティー

/var/sadm/lib/wbem/WbemServices.properties

は、す。

public class SetProps {

public static void main(String args[]) throws CIMException {

if ( args.length != 3) {

System.out.println("Usage: SetProps host username password");

System.exit(1);

クラスのインスタンスを作成して、そのイン

ファイルに格納されま

2 章WDR での Solaris WBEM Services

第

の使用方法

}

CIMClient cc = null;

try {

CIMNameSpace cns = new CIMNameSpace(args[0]);

cc = new CIMClient(cns, args[1], args[2]);

CIMObjectPath logpropcop = new CIMObjectPath("Solaris_LogServiceProperties");

Enumeration e = cc.enumInstances(logpropcop, true);

for (; e.hasMoreElements(); ) {

CIMObjectPath op = (CIMObjectPath)e.nextElement();

CIMInstance ci = cc.getInstance(op);

ci.setProperty("Directory", new CIMValue("/tmp/bar1/"));

ci.setProperty("FileSize", new CIMValue("10"));

ci.setProperty("NumFiles", new CIMValue("2"));

ci.setProperty("SyslogSwitch", new CIMValue("off"));

cc.setInstance(logpropcop,ci);

}

catch (Exception e) {

System.out.println("Exception: "+e);

e.printStackTrace();

}

// close session.

if(cc != null) {

cc.close();

}

40 WDR

開発ガイド

• 2002 年 12

月

Solaris WBEM

ログビューア

Solaris Management Console (SMC)

ラフィカルユーザーインタフェースを提供するアプリケーションであり、このログビューアにログ記録の詳細をすべて表示することができます。は、マニュアルページ

ログ記録を作成した後、

SMC と Solaris ログビューアを起動する

▼

以下のコマンドを入力して、

# cd /usr/sbin

以下のコマンドを入力して

# smc

「ナビゲーション」パネルの「このコンピュータ」をダブルクリック (または、「こ

のコンピュータ」の横にある展開・縮少アイコンをクリックピュータ」の下位のツリーを展開します。「システムステータス」をダブルクリックすると、「ログビューア」アイコンが表示されます。

「ログビューア」アイコンをクリックして、ログビューアを起動します。

smc(1M)

SMC

を起動してから

SMC

ログビューアは、記録されたデータ表示用のグ

SMC

についての詳細

を参照してください。

SMC

ログビューアを起動します。

起動コマンドの場所に移動します。

を起動します。

して、「このコン

)

2 章WDR での Solaris WBEM Services

第

の使用方法

42 WDR

開発ガイド

• 2002 年 12

月

第 3 章

プロセスインジケーションの使用

この章では、ンをイベント発生時の通信に使用する方法、およびの受信をクライアントで申請できるようにするクラスについて説明します。この章は、以下のトピックで構成されています。

■

ページの「

■

ページの「インジケーションの生成方法」

■

ページの「サブスクリプションの作成方法」

■

ページの「

■

47 ページの「イベントフィルタの作成」

■

ページの「イベントハンドラの作成」

■

ページの「イベントフィルタとイベントハンドラのバインド」

プロセスインジケーションクラスについての詳細は、第イン、関連、および指示」を参照してください。

注 – CIM

CIM

プロセスインジケーションの概要、

CIM

イベントモデル」

CIM

リスナーの追加」

イベントモデルについての詳細は、

http://www.dmtf.org/education/whitepapers.php

CIM

プロセスインジケーショ

CIM

プロセスインジケーション

4 章「WDR

から入手可能の

のクラス、ドメ

Distributed Management Task Force 白書を参照してください。

CIM

イベントモデル

参考 – CIM Event API

は、

/usr/sadm/lib/wbem/doc/javax/wbem/client/CIMEvent.html

す。

にありま

イベント

とは、実世界でのできごとのことです。

プロセスインジケーション

とは、イベントが発生した結果として作成されるオブジェクトです。プロセスインジケーションはイベントの通知であり、イベントとプロセスインジケーションを区別することが重要です。

CIM ではイベントが発行されるのではなく、プロセスインジケーション

が発行されます。

プロセスインジケーションは、ゼロ個以上のデータ変更の記述

) と関連を持っているクラスのサブタイプであり、

トリガー

ラスのインスタンスを作成できるのがこのトリガーです。

(

イベントにより生成された

Indication

WBEM の実装には、トリ

ク

ガーを表す明示的に定義されたオブジェクトはありません。トリガーは、システムの

(

基本オブジェクトでの操作

create

delete

、

、および

クラス、インスタンス、およびネームスペースでの

modify)

、または管理対象環境でのイベントのいずれか

によって、暗黙的に定義されます。イベントが発生すると、

WBEM

プロバイダで

は、システムで何かが起こったことを示すプロセスインジケーションを生成します。

たとえば

Service

クラスでは、サービスが停止してトリガーが開始されると、サー

ビス停止の通知としての役割を果たすプロセスインジケーションが発行されます。

Solaris WBEM Services

スキーマの関連

/usr/sadm/lib/wbem/doc/mofhtml/index.html

CIM

クラスは、

をご覧ください。クラスは以

下のように構成されています。

■

ルートクラス

■

スーパークラス

■

サブクラス

CIM_ClassDeletion

■

CIM_ClassModification

■

スーパークラス

■

サブクラス

CIM_InstDeletion

■

CIM_InstMethodRecall

■

CIM_InstRead

■

スーパークラス

: CIM_Indication

: CIM_ClassIndication

: CIM_ClassCreation

: CIM_InstIndication

: CIM_InstCreation

: CIM_ProcessIndication

44 WDR

CIM_ProcessIndication

スーパークラスは、

ンクラス階層図」の最上位に位置しています。

開発ガイド

• 2002 年 12

月

ページの「

WDR

インジケーショ

インジケーションの生成方法

CIM

イベントは、きます。ライフサイクルイベントは組み込みラスのインスタンスの作成、変更、削除といった、データへの変更に応答して発生します。プロセスイベントは、ライフサイクルイベントでは表されない、ユーザーが定

(固有でない) イベントです。

義した

ライフサイクルイベントとプロセスイベント

(

固有の

) CIM

のいずれかに分類で

イベントで、クラスやク

管理者は

CIM Object Manager

更できます。

WBEM Services

CIM Object Manager

トプロバイダです。

EventProvider

ジケーションを生成するよう要求します。プロバイダでインジケーションが生成されると、れている送信先にそのインジケーションを送信します。このインスタンスは、サブスクライバ

cimom.properties

のイベントポーリング間隔とデフォルトのポーリング動作を変

ファイルのプロパティーを編集することにより、

cimom.properties

の管理』

(Part No. 806-7119-10)

からの要求に応じてインジケーションを生成するのは、イベン

CIM Object Manager

インタフェースを介して該当するプロバイダに連絡し、適切なイン

CIM Object Manager

(

申請元) によって作成されます。

CIM_IndicationHandler

は、

ファイルの編集方法については、『

を参照してください。

では、サブスクリプション要求を分析し、

インスタンスで指定さ

Solaris

サブスクリプションの作成方法

クライアントアプリケーションでは、

す。

サブスクリプション

宣言です。

CIM

述します。

■

対象とするイベント

■

イベントの発生時に

イベントが通知されるように申請するアプリケーションでは、以下について記

CIM Object Manager

つまたは複数のインジケーションストリームに対する

は、

CIM

イベントが通知されるように申請できま

がとるべきアクション

イベントの発生は、スとして表されます。インジケーションが生成されるのは、クライアントがイベントについて申請をしている場合のみです。

サブスクリプションを作成するには、を指定して、以下のます。

CIM_IndicationFilter —

ションで返されるようにするデータを定義します。

CIM_Indication

CIMListener

CIM_Indication

インジケーションを生成する基準と、そのインジケー

クラスのいずれかのサブクラスのインスタン

インタフェースのインスタンス

クラスのサブクラスのインスタンスを作成し

第

章プロセスインジケーションの使用

CIM_IndicationHandler —

ンジケーションを配信する宛先とプロトコルが含まれる場合もあります。

インジケーションの処理と操作方法を示します。イ

CIM_IndicationSubscription —

ンドして関連付けます。

アプリケーションでは、数のイベントフィルタを作成することができます。アプリケーションがイベントサブスクリプションを作成するまで、イベントインジケーションは配信されません。

CIM

タフェースのインスタンスを追加します。サブスクリプションが作成されたときに、イベントフィルタで指定されたントのインジケーションを生成します。

CIMListener

メソッドを実装している必要があります。このメソッドは、インジケーションが配信できるようになったときに呼び出されます。

CIM リスナーを追加する

▼

以下のようなコードを使用して、

// Connect to the CIM Object Manager

cc = new CIMClient();

// Register the CIM Listener

cc.addCIMListener(new CIMListener() {

});

リスナーの追加

イベントのインジケーションに関する登録を行うときは、

インタフェースでは、引数

public void indicationOccured(CIMEvent e) {

}

1 つまたは複数のイベントハンドラを使って、1 つまたは複

イベントフィルタとイベントハンドラをバイ

CIMListener

CIM Object Manager

CIMEvent

CIM

リスナーを追加します。

をとる

では、クライアント

indicationOccured

CIM

イン

イベ

46 WDR

開発ガイド

• 2002 年 12

月

イベントフィルタの作成

イベントフィルタには、配信されるイベントのタイプと、配信される条件が記述されます。アプリケーションでは、

CIM_IndicationFilter

作成し、そのプロパティーの値を定義することにより、イベントフィルタを作成します。イベントフィルタは、ネームスペースに含まれます。各イベントフィルタは、そのフィルタと同じネームスペースに含まれているイベントに対してのみ動作します。

クラスのインスタンスを

CIM_IndicationFilter

クラスには文字列プロパティーがあります。アプリケーションは、このプロパティーで、一意にフィルタを特定するよう設定し、照会文字列を指定し、照会文字列の構文解析に使用する照会言語を設定することができます。現在、照会言語でサポートされているのは、WBEM Query Language

のみです。

表 3-1 CIM_IndicationFilter クラスのプロパティー

プロパティー説明必須・オプション

SystemCreationClassName

SystemName

CreationClassName

フィルタを作成するクラスが存在する、またはそのクラスが適用されるシステムの名前。

フィルタが存在する、またはそのフィルタが適用されるシステムの名前。

フィルタの作成に使用されたクラスまたはサブクラスの名前。

オプション。この基本プロパティーのデフォルトは

CIMSystem.CreationCl assName

オプション。この基本プロパティーのデフォルトは、

CIM Object Manager

行されているシステムの名前です。

オプション。この基本プロパティーのデフォルトとして、により

です。

が実

CIM Object Manager

CIM_IndicationFilter

が割り当てられます。

Name

フィルタの一意の名前。オプション。

Manager

前が割り当てられます。

により一意の名

CIM Object

第

章プロセスインジケーションの使用

表 3-1 CIM_IndicationFilter クラスのプロパティー (続き)

プロパティー説明必須・オプション

SourceNamespace

Query

QueryLanguage

イベントフィルタを作成する

▼

インジケーションが生

CIM

成されるローカルのネームスペースへのパス。

インジケーションが生成される条件を定義する照会式。現在、

Level 1 WBEM Query

Language

れています。作成方法については、『

WBEM SDK (Part No. 816-0093-10)

「照会」を参照してください。

照会式を記述する言語。必須。デフォルトは

式のみサポートさ

照会式の

WQL

開発ガイド』

の

オプション。デフォルトは

NULL

必須。

Sun

(WBEM Query Language)

です。

WQL

48 WDR

以下のコードを使用して、

CIM_IndicationFilter

クラスのインスタンスを作成

します。

CIMClass cimfilter = cc.getClass

(new CIMObjectPath(‘‘CIM_IndicationFilter’’), true, true, true, null);CIMInstance ci = cimfilter.newInstance();

以下のコードを使用して、イベントフィルタの名前を指定します。

Name = ‘‘filter_all_new_solarisdiskdrives’’;

以下のコードを使用して、返されるイベントインジケーションを特定する

列を作成します。

String filterString = ‘‘SELECT *

FROM CIM_InstCreation WHERE sourceInstance is ISA Solaris_DiskDrive’’

以下のコードを使用して、

フィルタ名、

イベントを選択するフィルタ文字列、および照会文字列の構文解析

CIM

cimfilter

インスタンスのプロパティー値を設定して、

に使用する照会言語を指定します。

開発ガイド

• 2002 年 12

月

WQL

文字

現在、照会文字列の構文解析に使用できるのは

注 –

す。

WBEM Query Language

ci.setProperty(‘‘Name’’;, new

CIMValue("filter_all_new_solarisdiskdrives”)); ci.setProperty("Query", new CIMValue(filterString)); ci.setProperty("QueryLanguage", new CIMValue("WQL");)

のみで

以下のコードを使用して、

し、そのインスタンスを

cimfilter

CIM Object Manager Repository

インスタンスから

つのインスタンスを作成

に格納します。

CIMObjectPath filter = cc.createInstance(new CIMObjectPath(), ci);

イベントハンドラの作成

Solaris Event MOF

CIM

の

イベントのインジケーションの配信を処理する

Solaris_JAVARXMIDelivery CIM_IndicationHandler Solaris_JAVAXRMIDelivery

を設定する必要があります。クライアントがイベントの受信に使用できるのはのみで、HTTP はサポートされていません。

では、

RMI

プロトコルを使ってクライアントアプリケーションへ

クラスを作成することにより、

クラスを拡張しています。

クラスをインスタンス化して、

RMI

クライアントは、

RMI

による配信場所

RMI

第

章プロセスインジケーションの使用

アプリケーションでは、

CIM_IndicationHandler

し、ハンドラに一意の名前を付け、その所有者の

クラスのプロパティーを設定

UID

を特定します。

表 3-2 CIM_IndicationHandler クラスのプロパティー

プロパティー説明必須・オプション

SystemCreationClassName

SystemName

CreationClassName

Name

Owner

ハンドラを作成するクラスが存在する、またはそのクラスが適用されるシステムの名前。

ハンドラが存在する、またはそのハンドラが適用されるシステムの名前。

ハンドラの作成に使用されるクラスまたはサブクラスの名前。

ハンドラの一意の名前。必須。クライアントアプリ

このハンドラを作成した、または保持しているエンティティーの名前。プロバイダがこの値をチェックし、ハンドラでのインジケーションの受け取りを承認するかどうかを判定します。

オプション。

Manager

ます。

オプション。この基本プロパティーのデフォルトは、

CIM Object

により設定され

CIM Object Manager

行されているシステムの名前です。

オプション。この基本プロパティーのデフォルトとして、

CIM Object Manager

により適切なクラスが割り当てられています。

ケーションで一意の名前を割り当てる必要があります。

オプション。デフォルトの値は、このインスタンスを作成しているユーザーの

ユーザー名です。

Solaris

が実

50 WDR

開発ガイド

• 2002 年 12

月

CIM イベントハンドラを作成する

▼

イベントハンドラを作成するときは、以下のコードを使用します。

CIM

// Create an instance of the Solaris_RMIDelivery class. CIMClass rmidelivery = cc.getClass(new CIMObjectPath

(‘‘Solaris_RMIDelivery’’;), false, true, true, null);

CIMInstance ci = rmidelivery.newInstance();

//Create a new instance (delivery) from //the rmidelivery instance. CIMObjectPath delivery = cc.createInstance(new CIMObjectPath(), ci);

イベントフィルタとイベントハンドラのバインド

アプリケーションは、成することにより、イベントフィルタとイベントハンドラをバインドします。

CIM_IndicationSubscription

されたイベントのインジケーションが配信されます。

イベントフィルタとイベントハンドラをバインド

▼

CIM_IndicationSubscription

が作成されると、イベントフィルタによって指定

クラスのインスタンスを作

する

以下のコード例では、サブスクリプションの「イベントフィルタの作成」で作成したティーを定義し、

delivery

CIMClass filterdelivery = cc.getClass(new

CIMObjectPath(‘’CIM_IndicationSubscription’’), true, true, true, null);

ci = filterdelivery.newInstance();

//Create a property called “filter” that refers to the filter //instance. ci.setProperty("filter", new CIMValue(filter));

オブジェクトに

ページの「

CIM

handler

(filterdelivery) filter

イベントハンドラを作成する」で作成した

プロパティーを定義しています。

オブジェクトに

を作成し、

filter

ページ

プロパ

第

章プロセスインジケーションの使用

//Create a property called handler that refers to the delivery //instance. ci.setProperty("handler", new CIMValue(delivery));

CIMObjectPath indsub = cc.createInstance(new CIMObjectPath(), ci);

52 WDR

開発ガイド

• 2002 年 12

月

第 4 章

WDR のクラス、ドメイン、関連、およびインジケーション

この章では、以下の図に示す関連、およびインジケーションについて説明します。

第

章は、以下の

■

ページの「

■

68 ページの「CIM スロットクラス」

■

ページの「

■

ページの「

■

ページの「

つの項目について説明します。

CIM

CIM Solaris_WDRDomain WDR CIM

WDR CIM

接続点クラス」

スキーマの関連と集約」

プロセスインジケーションクラス」

クラス階層を構成するクラス、ドメイン、

クラス」

WDR CIM クラス階層図

Solaris_WDRDomain

¥ Id

Solaris_SGDomain

¥ BoardRelationship ¥ KeySwitchPosition ¥ State

CIM_CollectionOfMSEs

Solaris_DomainHasAttachmentPoints

Solaris_XCDomain

¥ ActiveEthernetBoard ¥ AdminGroup ¥ BoardRelationship ¥ KeySwitchPosition ¥ ReconfigGroup ¥ State

Solaris_CHCPU

¥ ECache

Solaris_DomainhasSlots

¥ ID ¥ Speed

Solaris_SystemBoardHasProcessors

Solaris_WDRAttachmentPoint

¥ Busy ¥ ClassName ¥ Condition ¥ DomainID ¥ LogicalID ¥ MiscInfo ¥ OccupantState ¥ PhysicalID ¥ ReceptacleState ¥ StatusTime ¥ Ty p e

¥ Configure() ¥ Connect() ¥ Disconnect() ¥ Test() ¥ Unconfigure()

Solaris_CHSystemBoard

¥ Assigned ¥ PoweredOn

CIM_LogicalElement

Solaris_CHMemory

¥ Deleted ¥ Interleaved ¥ Permanent ¥ PhysicalAddress ¥ Remaining ¥ Size ¥ Source ¥ Target ¥ Unconfigurable

Solaris_CHController

¥ Device ¥ Referenced

Solaris_SystemBoardHasControllers

Solaris_WDRSlot

¥ Empty ¥ LogocalID

¥ Assign() ¥ Unassign()

Solaris_XCSlot Solaris_SGSlot

¥ AssignedDomain ¥ AssignmentState ¥ BoardType ¥ PowerState ¥ TestState

54 WDR

開発ガイド

• 2002 年 12

Solaris_SlotHasSystemBoard

¥ AssignedDomain ¥ AssignmentState ¥ BoardType ¥ PowerState ¥ TestState

月

¥ Assign() ¥ PowerOff() ¥ PowerOn() ¥ Unassign()

CIM_LogicalElement

Solaris_SystemBoardHasMemory

CIM 接続点クラス

接続点クラスでは、接続点を表す論理要素を提供します。接続点とは、

4810、4800

続点では、ンのシステムボード、接続点は、受容体と占有装置からなります。占有装置を受容体に挿入または受容体から取り外すと、接続点の状態が変更されます。

注

–

) と cfgadm_sbd(1M)

般てください。

接続点クラスは、

3800

はです理的な要素についてはシステムボードと入出力ボードのみを表し、および入出力コントローラについては表しません。スロットは、範囲がボードに限定されている接続点の

、または

WDR

接続点についての詳細は、

システムの物理的な位置を表すという点においては、スロットクラスと同じ

(68

ページの「

Sun Fire 15K、12K、6800、4810、4800

、または

Sun Fire 15K、12K、6800

3800

システムの物理的な位置へのインタフェースです。この接

を使用して、

Solaris

オペレーティング環境が実行されているドメイ

CPU、およびメモリーモジュールを構成することができます。

cfgadm(1M)

マニュアルページ

WDR

を使用できる

CIM

スロットクラス」を参照)。しかしスロットクラスでは、論

つのタイプといえます。

Sun Fire 15K、12K、6800、4810、4800

マニュアルページ

(Sun Fire 15K

および

3800

(Sun Fire

12K 専用)

CPU

、メモリー、

システムの

、

モデル全

を参照し

、また

CIM Solaris_WDRAttachmentPoint クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRAttachmentPoint

説明

コアの構成管理情報を表します。(詳細は、

)

てください。れます。

この情報は、ドメイン上で

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

cfgadm(1M)

libcfgadm

マニュアルページを参照し

ライブラリを使用して収集さ

直系の既知のサブクラス

CIM Solaris_CHCPU クラス、CIM Solaris_CHSystemBoard クラス、CIM Solaris_CHController

クラス、および CIM Solaris_CHMemory クラス

CIM Solaris_WDRAttachmentPoint クラスのプロパティー

注 –

接続点についての詳細は、

般

) と cfgadm_sbd(1M) マニュアルページ (Sun Fire 15K および 12K システム専用)

を参照してください。

表 4-1 CIM Solaris_WDRAttachmentPoint のプロパティー

プロパティーデータ型説明

ClassName string

Busy uint32

Condition uint32

接続点のクラス。たとえば

接続点が、現在状態の切り替え中であるかどうかを示します。

接続点の条件。値

Unusable

LogicalID string

PhysicalID string

接続点の論理的な識別子。

接続点の物理的な識別子。例

/devices/pseudo/dr@0::SB6

DomainID

uint32

この接続点が割り当てられている、または使用可能であるドメイン。られます。り当てられます。インには

Sun Fire 6800

ます

cfgadm(1M)

Sun Fire 15K

Sun Fire 12K

0 と 1

システムのドメインには

(最大 4

つのドメイン)。

マニュアルページ (Sun Fire システム全

“sbd”

はシステムボードを表します。

: Unknown

Failing、Failed

、OK、

システムのドメインには

Sun Fire 3800、4800

の番号が割り当てられます (最大

0 ～ 17

、および

0 ～ 3

4810

の番号が割り当てられ

、および

の番号が割り当て

0 ～ 8

の番号が割

システムのドメ

つのドメイン)。

OccupantState uint32

ReceptacleState uint32

Type string

56 WDR

開発ガイド

• 2002 年 12

接続点の占有装置の状態。値

: None

Configured

、

、および

Unconfigured

接続点の受容体の状態。値

Connected

び

接続点のタイプ。ポーネントの番号

月

cpun、pcin )

。

: None

Empty、Disconnected

、

、または

memn

のいずれか

、およ

はコン

表 4-1 CIM Solaris_WDRAttachmentPoint のプロパティー (続き)

MiscInfo string

StatusTime datetime

CIM Solaris_WDRAttachmentPoint クラスのメソッド

Solaris_WDRAttachmentPoint

ソースの追加、このドメインからの接続点リソースの削除、接続点の状態のテストを行うときに使用する

ドライバによって設定されるドライバ固有情報。名前と値の組み合

Type

わせのリスト。

は年、は月、は日付、は時間、は分、は秒

Type

たとえばティーの内容は、プロセッサメモリーサイズ

接続点の状態が最後に変更された日付と時刻。次の書式で表されます。

yyyymmddhhmmss.mmmmmmsutc

各文字は以下を表します。

yyyy mm dd hh mm ss

プロパティーの値によって決まります。

プロパティーが

(MB)

の情報から生成されます。

cpun

、プロセッサ速度、および

の場合、

MiscInfo

メソッドには、動作中のドメインへの接続点リ

つのメソッドがあります。

プロパ

Ecache

注 – Solaris_WDRAttachmentPoint cfgadm(1M)、cfgadm_sbd(1M)

クラスのメソッドの詳細については、

、および

rcfgadm(1M)

の各マニュアルページを

参照してください。

メソッドのリターンコード

すべてのれたかどうかを示す実行されたことを示し、ゼロ以外の値のときは以下のようなエラーが発生したことを示します。

0 =

1 =

Solaris_WDRAttachmentPoint

sint32 値を 1 つ返します。戻り値が 0 (ゼロ) のときは正常に

構成操作は成功しました

構成操作は取り消されました

4 章WDR

第

メソッドは、メソッドが正常に実行さ

のクラス、ドメイン、関連、およびインジケーション

2 =

構成管理はサポートされていません

3 = 構成操作はサポートされていません

4 =

特権が不十分です

5 = コンポーネントシステムが使用中のため、再試行してください

6 =

システムが使用中のため、再試行してください

7 = データエラーです

8 =

ライブラリエラーです

9 = ライブラリが見つかりませんでした

10 =

条件が不十分です

11 =

無効な構成操作です

12 =

ハードウェア固有の障害です

13 =

接続点が見つかりませんでした

14 =

指定された属性を持つ接続点が見つかりませんでした

注 –

クライアントからのメソッドの呼び出し方法についての詳細は、

Sun WBEM API Specification

/usr/sadm/lib/wbem/doc/index.html

する前に、表示されている正確な順序でパラメタを使って生成し、さらに

invokeMethod()

て生成されたエラー文字列があればその文字列が含まれ、生成されたエラー文字列がない場合は空の文字列が含まれます。

が戻ると、

を参照してください。これは、

にあります。

inParams

outParams

ベクトルには、対応する

ベクトルをすべての

ベクトルを空の文字列で生成します。

invokeMethod()

WBEM SDK の

を使用

[IN] (入力)

操作によっ

58 WDR

開発ガイド

• 2002 年 12

月

CIM Solaris_WDRAttachmentPoint メソッドの説明

表 4-2 CIM Solaris_WDRAttachmentPoint メソッド

名前説明

Configure

Unconfigure

ドメインへの接続点を構成します。

Solaris

パラメタ

• boolean — force [IN]

• string — hardwareOpts [IN]

• uint32 — retries [IN]

• uint32 — retryDelay [IN]

• string — error [OUT]

現在接続点が構成されている

強制的に条件、またはその他のハードウェアに依存した事項によって、失敗する場合があります。ハードウェア特有の安全性および完全性のチェックを行うと、ても何も処理されません。

ラグインに渡されます。現在します。たままになります。ボードの割り当てが解除されます。

ドメインからボードの割り当てを解除すると、そのボードを別のドメインに割り当てることができます。ただし、ボードを別のドメインに割り当てた場合、割り当て解除されたドメインではそのボードを使用できません。

す。デフォルトはゼロです。

は単独では使用できず、必ずルト値は

の文字列が含まれます。の文字列が含まれます。

-o nopoweroff

-o unassign

ドメインで、動的再構成

で、これは

対応する

Configure

指定したオプションは

WDR は cfgadm_sbd

を指定すると、

再試行を行う際の時間間隔 (秒) を指定します。このオプション

-r retry_count

要求がすぐに再試行されることを意味します。

コマンドによって返されたエラー文字列があれば、こ

コマンドによって何もエラー文字列が返されない場合は、空

Solaris

ドメインから、接続点のリソースを削除します。

操作を行います。行わない場合は、接続点の

オプションを実行し

force

cfgadm

プラグインと間接的に接続して機能

disconnect

(DR)

オプションとともに指定します。デフォ

というハードウェア特有のプ

機能によりボードの電源が投入され

機能によりドメインから

要求が再試行される回数を指定しま

Connect

このメソッドで使用されるパラメタは、上記の

受容体の状態を接続状態に変更します。

このメソッドで使用されるパラメタは、上記の

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

Configure

メソッドのパラメタと同じです。

表 4-2 CIM Solaris_WDRAttachmentPoint メソッド (続き)

Disconnect

Test

受容体に装着されている占有装置との間の正常な通信を使用不可にします。

このメソッドで使用されるパラメタは、上記の

ボードのテストが完了していても、

注

: Connect

メソッドを呼び出す必要はありません。

パラメタ

• boolean — verbose [IN] DR

ソッドの機能にはほとんど影響しません。

• string — hardwareOpts [IN]

ラメタと同様に使用します。

• string — error [OUT]

用します。

メソッドを呼び出すと

コマンド出力はクライアントでは使用できないため、このメ

上記の

Configure

を使用したボードのテストを明示的に要求します。

POST

を使用してボードのテストが行われるため、

POST

Configure

メソッドで説明した

メソッドのパラメタと同じです。

メソッドで説明した

error

CIM Solaris_CHSystemBoard クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRAttachmentPoint

| +--Solaris_CHSystemBoard

Test

hardwareOpts

パラメタと同様に使

パ

60 WDR

説明

Dynamic Reconfiguration

モデル

のシステムボードをモデル化する論理要素を表します。

ページの「

WDR CIM

Solaris_CHSystemBoard

クラス階層図」に示すように、

クラスは、

Solaris_CHController、Solaris_WDRSlot

クラスと関連関係があります。

CIM

開発ガイド

• 2002 年 12

月

の機能をサポートしている

2.0

CIM

Solaris_CHMemory

、および

Solaris_CHCPU の各

UltraSPARC-III

、

世代

直系の既知のサブクラス

なし

CIM Solaris_CHSystemBoard クラスのプロパティー

表 4-3

名前データ型説明

Assigned

PoweredOn boolean

CIM Solaris_CHSystemBoard のプロパティー

boolean

ボードが

ボードの電源が入っていることを示します。

CIM Solaris_CHSystemBoard クラスのメソッド

Solaris_CHSystemBoard

現在動作しているドメインへのボードの割り当てとそのドメインからの割り当ての解

除に使用する

注 – Solaris_CHSystemBoard cfgadm(1M)、cfgadm_sbd(1M)

参照してください。

メソッドのリターンコード

すべてのどうかを示すれたことを示し、ゼロ以外の値のときは以下のようなエラーが発生したことを示します。

つのメソッドがあります。

Solaris_CHSystemBoard

sint32 値を 1 つ返します。戻り値が 0 (ゼロ) のときは正常に実行さ

Solaris

メソッドには、システムボードの電源投入と電源切断、

ドメインに割り当てられていることを示します。

クラスのメソッドについての詳細は、

、および

rcfgadm(1M)

メソッドは、メソッドが正常に実行されたか

の各マニュアルページを

0 =

構成操作は成功しました

1 = 構成操作は取り消されました

2 = 構成管理はサポートされていません

3 = 構成操作はサポートされていません

4 = 特権が不十分です

5 =

コンポーネントシステムが使用中のため、再試行してください

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

6 =

システムが使用中のため、再試行してください

7 = データエラーです

8 =

ライブラリエラーです

9 = ライブラリが見つかりませんでした

10 =

条件が不十分です

11 = 無効な構成操作です

12 =

ハードウェア固有の障害です

13 = 接続点が見つかりませんでした

14 =

指定された属性を持つ接続点が見つかりませんでした

注 –

クライアントからのメソッドの呼び出し方法についての詳細は、

Sun WBEM API Specification

/usr/sadm/lib/wbem/doc/index.html

する前に、表示されている正確な順序でパラメタを使って生成し、さらに

invokeMethod()

て生成されたエラー文字列があればその文字列が含まれ、生成されたエラー文字列がない場合は空の文字列が含まれます。

が戻ると、

を参照してください。これは、

にあります。

inParams

outParams

ベクトルには、対応する

ベクトルをすべての

ベクトルを空の文字列で生成します。

invokeMethod()

WBEM SDK の

を使用

[IN] (入力)

操作によっ

62 WDR

開発ガイド

• 2002 年 12

月

CIM Solaris_CH_SystemBoard メソッドの説明

表 4-4 CIM Solaris_CH_SystemBoard メソッド

名前説明

Assign

PowerOn

PowerOff

指定された

パラメタ

Solaris

• boolean — force [IN]

点の条件、またはその他のハードウェアに依存した事項によって、失敗する場合があります。ハードウェア特有の安全性および完全性のチェックを行うと、

force

• string — hardwareOpts [IN]

特有のプラグインに渡されます。現在的に接続して機能します。

• string — error [OUT]

れば、この文字列が含まれます。れない場合は、空の文字列が含まれます。

ボードの電源を投入します。

パラメタこのメソッドで使用されるパラメタは、上記の

す。

ボードの電源を切断します。

パラメタこのメソッドで使用されるパラメタは、上記の

す。

ドメインにボードを割り当てます。

強制的に

オプションを実行しても何も処理されません。

Assign

指定したオプションは

操作を行います。行わない場合は、接続

cfgadm

WDR は cfgadm_sbd

対応する

コマンドによって返されたエラー文字列があ

コマンドによって何もエラー文字列が返さ

Assign

メソッドのパラメタと同じで

というハードウェア

プラグインと間接

Unassign

現在割り当てられているドメインから、ボードの割り当てを解除します。

パラメタこのメソッドで使用されるパラメタは、上記の

す。

メソッドのパラメタと同じで

4 章WDR

第

Assign

のクラス、ドメイン、関連、およびインジケーション

CIM Solaris_CHCPU クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRAttachmentPoint

| +--Solaris_CHCPU

説明

システムボード上のプロセッサを表す論理要素。ボード上では、サは物理的にシステムボード上のおよび構成解除などの

Solaris_CHCPU

しています。

ページの「

スは

CIM Solaris_CHSystemBoard

つのシステムボードに

操作を接続点で実行できることから、

クラスは

WDR CIM

CIM Solaris_WDRAttachmentPoint

クラス階層図」に示すように、

CPU

個のプロセッサを搭載可能です。プロセッ

ソケットに取り付けられており、しかも構成

クラスと集約関係があります。

直系の既知のサブクラス

なし

UltraSPARC-III

CIM Solaris_CHCPU

世代のシステム

CIM

クラスから派生

クラ

64 WDR

開発ガイド

• 2002 年 12

月

CIM Solaris_CHCPU クラスのプロパティー

表 4-5

名前データ型説明

ID uint32

Speed uint32

ECache uint32

Solaris_CHCPU のプロパティー

プロセッサの一意の識別子。

プロセッサのクロック数

ECache

CIM Solaris_CHCPU クラスのメソッド

なし

CIM Solaris_CHMemory クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRAttachmentPoint

| +--Solaris_CHMemory

メモリーのサイズ

(MHz)

(MB)

。

説明

システムボードのメモリー情報を表す論理要素。

Solaris_CHMemory

さらに、メモリーはシステムボード上の接続点であることから、

Solaris_CHMemory

派生しています。

の CIM クラスのインスタンスには一対一の関係があります。

クラスは

CIM Solaris_WDRAttachmentPoint

Solaris_CHSystemBoard

直系の既知のサブクラス

なし

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

CIM

と

クラスから

CIM Solaris_CHMemory のプロパティー

表 4-6

名前データ型説明

Deleted uint32

Interleaved boolean

Permanent uint32

PhysicalAddress uint64

Remaining uint32

Size uint32

Source string

Target string

CIM Solaris_CHMemory

メモリードレインの実行中、れたメモリー全部を格納します。それ以外の場合は、パティーは

ボードが他のボードとのインタリーブに加わっている場合はです。

ページング不可のメモリーページ数を、ボードのメモリーに格納します

ボード上のメモリーの基底物理アドレス。

メモリードレインの実行中に、ンする必要がある残りのメモリー量を格納します場合は、

ボード上のメモリーの容量

コピー更操作が行われていない場合は、す。

コピー操作が行われていない場合は、す。

のプロパティー

Deleted

です。

NULL

。

(KB)

Remaining

プロパティーは

(MB)

名前変更のソースである接続点の名前。コピー

名前変更の対象である接続点の名前。コピー

プロパティーはすでに削除さ

Remaining

プロパティーは、ドレイ

NULL

。

Source

Target

プロパティーは

(MB)

です。

Deleted

プロ

True

。それ以外の

名前変

NULL

名前変更

で

NULL

で

Unconfigurable boolean

CIM Solaris_CHMemory クラスのメソッド

なし

66 WDR

開発ガイド

• 2002 年 12

このメモリーの構成解除を許可しないようにオペレーティングシステムが構成されている場合は

月

True

です。

CIM Solaris_CHController クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRAttachmentPoint

| +--Solaris_CHController

説明

入出力ボード上で入出力コントローラの接続点をモデル化する論理

直系の既知のサブクラス

なし

CIM Solaris_CHController クラスのプロパティー

表 4-7 Solaris_CHController のプロパティー

名前データ型説明

Device string

Referenced boolean

/devices

入出力コンポーネントが参照されている場合は

CIM Solaris_CHController クラスのメソッド

なし

CIM

パスの入出力コンポーネントの物理パス。

True

要素。

です。

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

CIM スロットクラス

CIM

スロットクラスは、テム上のシステムボードスロットをモデル化します。スロットにボードが装着されていてもいなくても構いません。接続点と同様に、スロットをドメインに割り当てたり、割り当て解除することができます。ただし、接続点と異なるのは、スロットはいずれのドメインからも独立して存在することができ、常に存在する点です。

注

名前に “XC” が含まれているクラスは、Sun Fire™ 15K および 12K システム用

–

です。名前に

3800

システム用です。

“SG”

Sun Fire 15K、12K、3800、4800、4810

が含まれているクラスは、

Sun Fire 6800、4810、4800

、および

6800

シス

、および

CIM Solaris_WDRSlot クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRSlot

抽象的な CIM Solaris_WDRSlot クラスは、プラットフォームに依存しないスロットをモデル化します。

68 WDR

説明

Sun Fire 15K、12K、6800、4810、4800

CIM

する論理テムボードと入出力ボードのどちらも装着できます。

ページの「ラスは、スと関連関係があります。

要素にスーパークラスを提供する論理

WDR CIM

Solaris_CHSystemBoard

クラス階層図」に示すように、

直系の既知のサブクラス

CIM Solaris_XCSlot

開発ガイド

• 2002 年 12

クラスおよび

月

CIM Solaris_SGSlot

、または

および Solaris_WDRDomain の各 CIM クラ

3800

シャーシのスロットをモデル化

CIM

要素。スロットには、シス

CIM Solaris_WDRSlot

クラス

ク

CIM Solaris_WDRSlot

のプロパティー

表 4-8

名前データ型説明

LogicalID string

CIM Solaris_WDRSlot

スロットの論理名。

Sun Fire 15K

ロットにシステムボードと入出力ボードをそれぞれす。システムボードのスロットは入出力ボードのスロットは

Sun Fire 12K

ロットにシステムボードと入出力ボードをそれぞれす。システムボードのスロットは出力ボードのスロットは

Sun Fire 6800、4810、4800

のシステムボードと最大テムボードのスロットはドのスロットは

Empty boolean

このスロットにボードが装着されているかどうかを示します。値が

NULL

Empty Solaris_XCSlot

プロパティーである、

PowerState

のプロパティー

システムには

IB6、IB7、IB8

の場合は、スロットの状態が不明であることを示します。

プロパティーが

クラスおよび

AssignmentState、BoardType

、および

TestState は NULL

個の拡張スロットがあり、その各ス

つ装着できま

SB0、SB1、... SB17

IO0、IO1、... IO17

個の拡張スロットがあり、その各ス

SB0、SB1、... SB8

IO0、IO1、... IO8

、または個の入出力ボードを装着できます。シス

3800

SB0、SB1、... SB5

、および

の場合には、サブクラス

True

と表記されます。

システムには、最大

と表記され、入出力ボー

と表記されます。

IB9

と表記され、

と表記されます。

つ装着できま

と表記され、入

CIM

CIM Solaris_SGSlot

、

です。

クラスの

個

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

CIM Solaris_WDRSlot のメソッド

Solaris_WDRSlot

つのメソッドがあります。

メソッドには、スロットの割り当てと割り当て解除に使用する

メソッドのリターンコード

Sun Fire 15K と 12K

ソッドが正常に実行されたかどうかを示す

のときは正常に実行されたことを示し、ゼロ以外の値のときは以下のようなエ

ロ

)

ラーが発生したことを示します。

構成操作は成功しました

0 =

構成操作は取り消されました

1 =

構成管理はサポートされていません

2 =

構成操作はサポートされていません

3 =

特権が不十分です

4 =

コンポーネントシステムが使用中のため、再試行してください

5 =

システムが使用中のため、再試行してください

6 =

データエラーです

7 =

ライブラリエラーです

8 =

システムでは、すべての

sint32 値を 1

Solaris_WDRSlot

つ返します。戻り値が

メソッドは、メ

0 (

ゼ

70 WDR

9 =

10 =

11 =

12 =

13 =

14 =

開発ガイド

ライブラリが見つかりませんでした

条件が不十分です

無効な構成操作です

ハードウェア固有の障害です

接続点が見つかりませんでした

指定された属性を持つ接続点が見つかりませんでした

• 2002 年 12

月

注 –

クライアントからのメソッドの呼び出し方法についての詳細は、

Sun WBEM API Specification

/usr/sadm/lib/wbem/doc/index.html

する前に、表示されている正確な順序でパラメタを使って生成し、さらに outParams ベクトルを空の文字列で生成します。

invokeMethod()

て生成されたエラー文字列があればその文字列が含まれ、生成されたエラー文字列がない場合は空の文字列が含まれます。

CIM_SolarisWDRSlot メソッドの説明

表 4-9 CIM Solaris_WDRSlot メソッド

名前説明

が戻ると、

を参照してください。これは、

にあります。

inParams

outParams

ベクトルには、対応する DR 操作によっ

ベクトルをすべての

WBEM SDK の

invokeMethod()

[IN] (入力)

を使用

Assign

Unassign

指定されたドメインにスロットを割り当てます。

パラメタ

• uint32 — domainID [IN]

• string — error [OUT]

ドメインからボードの割り当てを解除します。ドメインでスロットに装着されているボードは、アクティブな

パラメタこのメソッドで使用されるパラメタは、上記の

す。

このスロットに割り当てるドメインを指定します。

Fire 15K/12K

サーバーでは、

Sun Fire 3800、4800、4810

ます。

Sun Fire 6800

ば、この文字列が含まれます。場合は、空の文字列が含まれます。

システムでは、1 ～

対応する

接続または構成されている) 状態ではありません。

(

個までのドメインを構成することができます。

システムでは、1 つまたは

DR DR

Sun

つのドメインを構成でき

個のドメインを構成できます。

操作によって返されたエラー文字列があれ

操作によって何もエラー文字列が返されない

Assign

メソッドのパラメタと同じで

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

CIM Solaris_XCSlot クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRSlot

| +--Solaris_XCSlot

説明

Sun Fire 15K

ロットには、システムボードと入出力ボードのどちらも装着できます。

Sun Fire 15K

ボードと入出力ボードをそれぞれ

、

SB0

SB1、... SB17

と表記されます。

IO17

Sun Fire 12K

ボードと入出力ボードをそれぞれ

、

SB0

SB1、... SB8

と表記されます。

または

システムには

システム上のスロットをモデル化する論理

12K

個の拡張スロットがあり、その各スロットにシステム

つ装着できます。システムボードのスロットは

と表記され、入出力ボードのスロットは

個の拡張スロットがあり、その各スロットにシステム

つ装着できます。システムボードのスロットは

と表記され、入出力ボードのスロットは

CIM

IO0 (ゼロ)、IO1、...

IO0 (ゼロ)、IO1、... IO8

直系の既知のサブクラス

なし

要素。ス

72 WDR

開発ガイド

• 2002 年 12

月

CIM Solaris_XCSlot のプロパティー

表 4-10 CIM Solaris_XCSlot

名前データ型説明

AssignedDomain sint32

このスロットの

Assigned

ン。数値

H、I、J、K、L、M、N、O、N、P、Q

AssignmentState

uint32

現在スロットに割り当てられている状態。値

Unknown

Empty

True

が

BoardType uint32

スロットに装着されているボードのタイプ (既知の場合)。値

ValueMap の CPU

が

HPCIX

同じではありません。

Empty

True

が

PowerState uint32

ボードの電源状態。値

Unknown

Empty

True

が

のプロパティー

AssignmentState

の場合に、このスロットが割り当てられているドメイ

-1 ～ 18 が ValueMap の

プロパティーの値が

None、A、B、C、D、E、F、G

、および

を表します。

0 ～ 3 が ValueMap の

Free、Assigned

、

プロパティー

の場合は、常に

、または

Unknown

、および

プロパティー

の場合は、常に

プロパティー

の場合は、常に

、および

Active

(Solaris_WDRSlot

NULL

です。

WIB、HPCI、CPCI、MCPU、WPCI、SPCI

、

を表します。注

(Solaris_WDRSlot

NULL

です。

0 ～ 3 が ValueMap の Off

Minimal

を表します。

(Solaris_WDRSlot

NULL

です。

を表します。

クラスから継承される

Unknown

クラスから継承される

、On、

クラスから継承される

は

0 ～ 8

Empty

、

)

、と

)

TestState uint32

CIM Solaris_XCSlot のメソッド

なし

ボードのテスト状態。値

0 ～ 4 が ValueMap の

iPOST、Passed、Degraded

Empty

True

が

4 章WDR

第

プロパティー

の場合は、常に

(Solaris_WDRSlot

NULL

のクラス、ドメイン、関連、およびインジケーション

、または

です。

Unknown

Failed

を表します。

クラスから継承される

、

)

CIM Solaris_SGSlot クラス

クラス階層での位置

CIM_LogicalElement

| +--Solaris_WDRSlot

| +--Solaris_SGSlot

説明

Sun Fire 6800、4810、4800 CIM

注 – Sun Fire 6800

ボードと最大

、

SB0 IB9

と表記されます。

要素。

SB1、... SB5

、

個の入出力ボードを装着できます。システムボードのスロットは

と表記され、入出力ボードのスロットは

、または

4810、4800

直系の既知のサブクラス

なし

3800

、または

システム上のスロットをモデル化する論理

3800

システムには、最大

IB6、IB7、IB8

個のシステム

、および

74 WDR

開発ガイド

• 2002 年 12

月

CIM Solaris_SGSlot のプロパティー

表 4-11

名前データ型説明

AssignedDomain sint32

CIM Solaris_SGSlot のプロパティー

このスロットの

Assigned

ン。値

• None

• A

• B

• C

• D

AssignmentState uint32

現在スロットに割り当てられている状態。値以下の項目を表します。

• Unknown

• Free

• Assigned

• Active

BoardType uint32

スロットに装着されているボードのタイプ (既知の場合)。値が

ValueMap

• Unknown

• Empty

• CPU

• IO

• CPUWIB

• IOWIB

• SC

• L2

• Fan

• Power Supply

• Logic Analyzer

AssignmentState

の場合に、このスロットが割り当てられているドメイ

1 ～ 5 が ValueMap

の以下の項目を表します。

プロパティーの値が

1 ～ 4 が ValueMap

の以下の項目を表します。

の

1 ～ 11

PowerState uint32

ボードの電源状態。値す。

• Unknown

• On

• Off

• Failed

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

1 ～ 4 が ValueMap

の以下の項目を表しま

表 4-11 CIM Solaris_SGSlot のプロパティー (続き)

TestState uint32

CIM Solaris_SGSlot のメソッド

なし

CIM Solaris_WDRDomain

CIM Solaris

システム上のドメインを表します。

Fire

ボードのテスト状態。値す。

• Unknown

• Not Tested

• Passed

• Failed

• Under Test

• Start Test

• Degraded

• Unusable

ドメインクラスは、

Solaris

1 ～ 8 が ValueMap

の以下の項目を表しま

クラス

オペレーティング環境が実行されている

Sun

76 WDR

CIM Solaris_WDRDomain クラス

クラス階層での位置

CIM_CollectionOfMSEs

Solaris_WDRDomain

+--

説明

CIM Solaris_WDRDomain 6800、4810、4800、および 3800 システム) 上のドメイン情報を表す抽象スーパーク

ラスです。

開発ガイド

• 2002 年 12

月

クラスは、すべての

Sun Fire

システム

(15K、12K

、

ページの「

クラスは、

Solaris_WDRAttachmentPoint

WDR CIM

クラス階層図」に示すように、

Solaris_WDRSlot

CIM Solaris_WDRDomain

クラスと関連関係があり、

クラスと集約関係があります。

直系の既知の CIM サブクラス

CIM Solaris_SGDomain クラスおよび CIM Solaris_XCDomain クラス

注 –

12K

システム用です。名前に

6800、4810、4800

名前に

“XC“

が含まれている

、および

CIM Solaris_WDRDomain クラスのプロパティー

表 4-12

名前データ型説明

CIM Solaris_WDRDomain のプロパティー

uint32

ドメインを一意に特定します。

CIM Solaris_XCDomain クラス

クラス階層での位置

CIM_CollectionOfMSEs

| +--Solaris_WDRDomain

| +--Solaris_XCDomain

CIM

“SG“

が含まれている

3800

システム用です。

ドメインクラスは、

CIM

ドメインクラスは、

Sun Fire™ 15K

および

Sun Fire

説明

CIM Solaris_XCDomain

Sun Fire 15K および 12K システムのドメイン情報を表します。このクラスに

スで、

Sun Fire 15K および 12K システムに固有の情報が含まれている CIM プロパ

は、ティーがいくつかあります。

クラスは

4 章WDR

第

CIM Solaris_WDRDomain

のクラス、ドメイン、関連、およびインジケーション

クラスのサブクラ

直系の既知の CIM サブクラス

なし

CIM Solaris_XCDomain クラスのプロパティー

表 4-13 CIM Solaris_XCDomain

名前データ型説明

ActiveEthernetBoard

string

内部システムコントローラ

Ethernet

AdminGroup string

BoardRelationship[]

sint32

ドメイン管理者グループに割り当てられている

ドメイン内のボードの状態を示す値の配列 (各ボードについての値

ValueMap

• Not Available

• Available

• Assigned

• Active

配列の

SB17)

入出力ボード

KeyswitchPosition

uint32

ドメインの状態を示します。0 ～

ValueMap

• On

• Standby

• Off

• Diag

• Secure

• Unknown

のプロパティー

(SC)

ネットワークでアクティブな

接続をホストしている入出力ボード。

)

。配列の

BitMap

の個々の数値が以下の値のいずれかを表します。

BitMap の 1 ～ 18

の状態を表します。配列の

(IO0 ～ IO17)

の項目を表します。

の個々の位置が

の数値が、各システムボード

の状態を表します。

つのボードの状態を表し、

BitMap の 19 ～ 18

の値が、ドメインの状態を示す

UNIX

グループ名。

つ

(SB0 ～

の数値が、各

ReconfigGroup string

78 WDR

開発ガイド

• 2002 年 12

ドメイン再構成の役割に割り当てられている

月

UNIX

グループ名。

表 4-13 CIM Solaris_XCDomain のプロパティー (続き)

State uint32

ドメインの現在の状態。ずれかを表し、ドメインの現在の状態を示します。

ValueMap の 0 ～ 36

の各値が以下の値のい

• Unknown

• Powered Off

• Keyswitch Standby

• Running Domain POST

• Running Board POST

• Layout OBP

• Loading OBP

• OBP Booting

• OBP Running

• OBP Callback

• OBP Loading Solaris

• OBP Booting Solaris

• OBP Domain Exited

• OBP Failed

• OBP in Sync Callback

• OBP Exited

• OBP Error Reset

• OBP Domain Halt

• OBP Environmental Domain Halt

• OBP Booting Solaris Failed

• OBP Loading Solaris Failed

• OBP Debug

• OS Running Solaris

• OS Quiesce in Progress

• OS Quiesced

• OS Resume in Progress

• OS Panic

• OS Panic Debug

• OS Panic Continue

• OS Panic Dump

• OS Halt

• OS Panic Exit

• OS Environmental Exit

• OS Debug

• OS Exit

• Domain Down

• Domain In Recovery

4 章WDR

第

のクラス、ドメイン、関連、およびインジケーション

CIM Solaris_SGDomain クラス

クラス階層での位置

CIM_CollectionOfMSEs

| +--Solaris_WDRDomain

| +--Solaris_SGDomain

説明

CIM Solaris_SGDomain

Sun Fire 6800、4810、4800

スで、す。このクラスには、報が含まれている

Sun Fire 6800、4810、4800

CIM

プロパティーがいくつかあります。

クラスは

CIM Solaris_WDRDomain

、および

直系の既知の CIM サブクラス

なし

クラスのサブクラ

3800

システムのドメイン情報を表しま

、および

3800

システムに固有の情

80 WDR

開発ガイド

• 2002 年 12

月

CIM Solaris_SGDomain クラスのプロパティー

表 4-14

名前データ型説明

BoardRelationship[] sint32

CIM Solaris_SGDomain のプロパティー

ドメイン内のボードの状態を示す値の配列 (各ボードについての値ボード状態の値を表します。

• Nonexistent Slot

• Not Available

• Available

• Assigned

• Active

Sun Fire 6800

す。ます。す。

Sun Fire 3800、4800

個、入出力ボード用に

す。したがって、用) と、です。

KeyswitchPosition uint32

ドメインの状態を示します。値を表します。

• Unknown

• Off

• Standby

• On

• Diag

• Secure

• Off To Standby

• Off To On

• Off To Diag

• Off To Secure

• Standby To Off

• Active To Off

• Active To Standby

• Reboot To On

• Reboot To Diag

• Reboot To Secure

。配列

)

BitMap

BitMap 値 1 ～ 6

BitMap 値 7 ～ 10

の各位置の

では、

BitMap 値 1 ～ 10

がシステムボード

、および

が入出力ボード

4810

個、合計

BitMap 値 4、5

BitMap 値 9 と 10 (IB8 と IB9 用)

1 ～ 16 が ValueMap

ValueMap 項目 0 ～ 4

ですべてのボードを表しま

0 ～ 5 (SB0 ～ SB5)

(IB6 ～ IB9)

システムでは、

個のスロットのみ使用できま

、および

6 (SB3、SB4

は常に

CPU

0 (Nonexistent Slot)

つ

が、以下の

に対応し

に対応しま

ボード用に

、および

の以下の項目

SB5

第

4 章WDR

のクラス、ドメイン、関連、およびインジケーション

表 4-14 CIM Solaris_SGDomain のプロパティー (続き)

State uint32

WDR スキーマの関連と集約

Sun Microsystems WDR User’s Manual [ja]

Specifications and Main Features

Frequently Asked Questions

User Manual