Sun Logo


WDR Developer's Guide

Creating WBEM-Based System Management Applications

816-1984-11



Contents

Preface

Before You Read This Book

How This Book Is Organized

Using UNIX Commands

Typographic Conventions

Shell Prompts

Related Documentation

Accessing Sun Documentation Online

Sun Welcomes Your Comments

1. Introduction to WDR

Hardware Required for WDR

Hardware Required for MSP on Sun Fire 6800/4810/4800/3800 Systems

Software Required for WDR

Software Required for Sun Fire 15K/12K Systems

Software Required for Sun Fire 6800/4810/4800/3800 Systems

About Web-Based Enterprise Management (WBEM)

Common Information Model (CIM)

Platform-Specific and Common MOF Files

Operations that WDR Performs

Administrator Security Models

WDR Security

Sun Fire 6800/4810/4800/3800 System Groups

Sun Fire 15K and 12K System Groups

Solaris WBEM Services

CIM Object Manager (CIMOM)

WBEM Providers

Solaris WBEM Software Development Kit (SDK)

2. Using Solaris WBEM Services in WDR

Overview of Solaris WBEM Services

Layers of Solaris WBEM Services

Solaris WBEM Services Application Layer

Sun WBEM User Manager and SMC Users Tool

Solaris Management Console (SMC) WBEM Log Viewer

Managed Object Format (MOF) Compiler

The mofcomp Command

Compiling a MOF File

procedure iconsmall spaceHow to Compile a MOF File

The mofcomp Password Security Advisory

Solaris WBEM Services Management Layer

About the CIM Object Manager

Manually Starting and Stopping the CIM Object Manager

procedure iconsmall spaceTo Start the CIM Object Manager

procedure iconsmall spaceTo Stop the CIM Object Manager

Solaris WBEM Services Provider Layer

Solaris Providers

WBEM Security Services

Authentication

Authorization

Replay Protection

Digital Signatures

Implementing Security

WBEM Access Control Lists

Using the Sun WBEM User Manager

procedure iconsmall spaceTo Start the Sun WBEM User Manager

procedure iconsmall spaceTo Grant Default Access Rights to a User

procedure iconsmall spaceTo Change a User's Access Rights

procedure iconsmall spaceTo Remove a User's Access Rights

procedure iconsmall spaceTo Set Access Rights for a Namespace

procedure iconsmall spaceTo Remove Access Rights for a Namespace

Using APIs to Set Access Control

The Solaris_UserAcl Class

procedure iconsmall spaceTo Set Access Control on a User

The Solaris_NamespaceAcl Class

procedure iconsmall spaceTo Set Access Control on a Namespace

Starting Solaris Management Console (SMC) Users Tool

procedure iconsmall spaceTo Start SMC Users Tool

Solaris WBEM Logging Services

Solaris WBEM Services Log Files

Solaris WBEM Services Log File Rules

Solaris WBEM Services Log File Format

Solaris WBEM Log Classes

Solaris_LogRecord Class

Solaris_LogService Class

Using the APIs to Enable Solaris WBEM Logging

Writing Data to a Solaris WBEM Log File

procedure iconsmall spaceTo Create an Instance of Solaris_LogRecord to Write Data

Reading Data from a Solaris WBEM Log File

procedure iconsmall spaceTo Get an Instance of the Solaris_LogRecord Class and Read Data

Setting Solaris WBEM Logging Properties

procedure iconsmall spaceTo Set Solaris WBEM Logging Properties

Solaris WBEM Log Viewer

procedure iconsmall spaceTo Start SMC and Solaris Log Viewer

3. Using Process Indications

The CIM Event Model

How Indications are Generated

How Subscriptions Are Created

Adding a CIM Listener

procedure iconsmall spaceTo Add a CIM Listener

Creating an Event Filter

procedure iconsmall spaceTo Create an Event Filter

Creating an Event Handler

procedure iconsmall spaceTo Create a CIM Event Handler

Binding an Event Filter to an Event Handler

procedure iconsmall spaceTo Bind an Event Filter to an Event Handler

4. Classes, Domains, Associations, and Indications in WDR

WDR CIM Class Hierarchy Diagram

CIM Attachment Point Classes

CIM Solaris_WDRAttachmentPoint Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_WDRAttachmentPoint Class Properties

CIM Solaris_WDRAttachmentPoint Class Methods

CIM Solaris_CHSystemBoard Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_CHSystemBoard Class Properties

CIM Solaris_CHSystemBoard Class Methods

CIM Solaris_CHCPU Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_CHCPU Class Properties

CIM Solaris_CHCPU Class Methods

CIM Solaris_CHMemory Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_CHMemory Properties

CIM Solaris_CHMemory Class Methods

CIM Solaris_CHController Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_CHController Class Properties

CIM Solaris_CHController Class Methods

CIM Slot Classes

CIM Solaris_WDRSlot Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_WDRSlot Properties

CIM Solaris_WDRSlot Methods

CIM Solaris_XCSlot Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_XCSlot Properties

CIM Solaris_XCSlot Methods

CIM Solaris_SGSlot Class

Position in the Class Hierarchy

Description

Direct Known Subclasses

CIM Solaris_SGSlot Properties

CIM Solaris_SGSlot Methods

CIM Solaris_WDRDomain Classes

CIM Solaris_WDRDomain Class

Position in the Class Hierarchy

Description

Direct Known CIM Subclasses

CIM Solaris_WDRDomain Class Properties

CIM Solaris_XCDomain Class

Position in the Class Hierarchy

Description

Direct Known CIM Subclasses

CIM Solaris_XCDomain Class Properties

CIM Solaris_SGDomain Class

Position in the Class Hierarchy

Description

Direct Known CIM Subclasses

CIM Solaris_SGDomain Class Properties

WDR Schema Associations and Aggregations

CIM Solaris_DomainHasAttachmentPoints Aggregation

Description

CIM Solaris_DomainHasAttachmentPoints Aggregation Properties

CIM Solaris_DomainHasSlots Aggregation

Description

CIM Solaris_DomainHasSlots Aggregation Properties

Solaris_SlotHasSystemBoard Association

Description

CIM Solaris_SlotHasSystemBoard Association Properties

Solaris_SystemBoardHasProcessors Aggregation

Description

CIM Solaris_SystemBoardHasProcessors Aggregation Properties

Solaris_SystemBoardHasMemory Aggregation

Description

CIM Solaris_SystemBoardHasMemory Aggregation Properties

Solaris_SystemBoardHasControllers Aggregation

Description

CIM Solaris_SystemBoardHasControllers Aggregation Properties

CIM Process Indication Classes

The WDR Indication Class Hierarchy Diagram

Solaris_WDRIndication Class

Solaris_SGBoardPresenceChange Indication

Description

Solaris_SGBoardPresenceChange Properties

Solaris_SGDomainACLChange Indication

Description

Solaris_SGDomainACLChange Properties

Solaris_SGDomainStateChange Indication

Description

Solaris_SGDomainStateChange Properties

Solaris_SGSlotAssignmentChange Indication

Description

Solaris_SGSlotAssignmentChange Properties

Solaris_SGBoardStateChange Indication

Description

Solaris_SGBoardStateChange Properties

Solaris_SGSlotAvailabilityChange Indication

Description

Solaris_SGSlotAvailabilityChange Properties

Solaris_XCSystemBoardConfigChange Indication

Description

Solaris_XCSystemBoardConfigChange Properties

Solaris_XCEnvironmentalIndication Indication

Description

Solaris_XCEnvironmentalIndication Properties

Solaris_XCComponentRemove Indication

Solaris_XCComponentInsert Indication

Solaris_XCBoardPowerOn Indication

Solaris_XCBoardPowerOff Indication

Solaris_XCDomainIndication Indication

Description

Solaris_XCDomainIndication Properties

Solaris_XCDomainConfigChange Indication

Solaris_XCDomainUp Indication

Solaris_XCDomainDown Indication

Solaris_XCDomainStop Indication

Solaris_XCDomainStateChange Indication

Description

Solaris_XCDomainStateChange Properties

5. Programming Techniques in WDR

Caching System State Information

Working with an EventProvider

procedure iconsmall spaceTo Subscribe to and Read WDR Indications

procedure iconsmall spaceTo Implement an Event Listener

procedure iconsmall spaceTo Bind an Event Filter to an Event Handler

Working with an InstanceProvider

Working with an AssociatorProvider

Working with a MethodProvider

A. MOF Files

WDR_Core1.0.mof File

WDR_SG1.0.mof File

WDR_XC1.0.mof File

Index