Managing WBEM/CIM - login | DMTF WBEM/CIM Infrastructures Jim Davis Sun Microsystems, Inc. June 12, 2002

Managing WBEM/CIM Managing WBEM/CIM InfrastructuresInfrastructures

Jim DavisSun Microsystems, Inc.

June 12, 2002

DMTF 2002 Developers' Conference June 10-13, 2002 Page 2

AgendaAgenda• Overview• CIM Interop 26• CIM Interop 2.7 Preliminary• What’s Next• Q & A


OverviewOverview• CIM Client

– interacts with a CIM Server by issuing CIM Operation Message Requests and receives and processes CIM Operation Message Responses

• CIM Server – a server that receives and processes

CIM Operation Message Requests and issues CIM Operation Message Responses

• CIM Object Manager (CIMOM)– The central component of the CIM

Server responsible for the communication between the CIM Server components

• Provider– instruments one or more aspects of

the CIM SchemaManaged Element(s)

Provider(s)

CIM Object Manager(CIMOM)

CIM Server

CIM-XMLProtocolAdapter

CIM-XMLIndication

Handler

Provider(s)

CIM Client


CIM CIM Interop Interop ModelModel• Describes WBEM Infrastructure and

relationships• Registration/Interaction with WBEM

Infrastructure• Manage/Administer WBEM Infrastructure• Discover WBEM Infrastructure

Capabilities• First Introduced with CIM Schema 2.6


CIM CIM Interop Interop Model 2.6Model 2.6

• Abstract Base Class for all WBEM Services• Object Manager Model

– Describes Object Manager– Describes access to a CIM Server

• Namespace Model– Describes Namespace– Describes the information contained in a

namespace


System

CreationClassName: string [key]Name: string [key]NameFormat: stringPrimaryOwnerName: stringPrimaryOwnerContact: stringRoles: string[ ]

CreationClassName: string [key]Name: string [key]StartMode: stringStarted: boolean

StartService(): uint32StopService(): uint32

Service

HostedService

*w

LogicalElement

ObjectManager

1

1

0..1ServiceAccessPoint

CreationClassName: string [key]Name: string [key]

ServiceAccessBySAP

HostedAccessPoint

ObjectManagerCommunicationMechanism

CommunicationMechanism: uint16OtherCommunicationMechanismDescription: stringProfilesSupported: uint16[ ] (enum)OtherProfileDescription: stringMultipleOperationsSupported: booleanAuthenticationMechanismsSupported: uint16[ ] (enum)OtherAuthenticationDescription: string

CommMechanismForManagerCIMXMLCommunicationMechanism

[Default CommunicationMechanism = "CIM-XML"]CIMXMLProtocolVersion: uint16 (enum)CIMValidated: boolean

*

*1

* w

1 1..n

WBEMService

1

CIMCIM InteropInterop Model 2.6 (1)Model 2.6 (1)


CIMCIM InteropInterop Model 2.6 (2)Model 2.6 (2)

System

CreationClassName: string [key]Name: string [key]NameFormat: stringPrimaryOwnerName: stringPrimaryOwnerContact: stringRoles: string[ ]

*ManagedSystemElement

Name: stringStatus: stringInstallDate: datetime

Component

CreationClassName: string [key]Name: string [key]StartMode: stringStarted: boolean

StartService(): uint32StopService(): uint32

Service

*

HostedService

*w

Dependency **

Description: stringCaption: string

ManagedElement

LogicalElement

Namespace

[Propagated Keys]CreationClassName: string [Key]Name: string [Key]ClassInfo: uint16 (enum)DescriptionOfClassInfo: string

SystemInNamespace

w

SystemIdentification

[Propagated Keys]CreationClassName: string [Key]Name: string [key]IdentificationFormats: uint16 [ ] (enum)FormatDescriptions: string [ ]IdentificationData: string [ ]

*w

IdentificationOfManagedSystem

1

0..1

1

0..1ServiceAccessPoint

CreationClassName: string [key]Name: string [key]

ServiceAccessBySAP

HostedAccessPoint

*1

*

ScopeOfContaineddata: uint16[] enumDescriptionOfContaineddata: string[]

SystemInNamespace

*


CIMCIM InteropInterop Model 2.6 (3)Model 2.6 (3)Dependency

Antecedent: ref ManagedElement [key]Dependent: ref ManagedElement [key]

NamespaceInManager

Antecedent: ref ObjectManagerDependent: ref CIM_Namespace

SystemInNamespace

Antecedent: ref ManagedNamespaceDependent: ref SystemIdentificationScopeOfContainedData[]: uint16 (enum)DescriptionOfContainedData[]: string

CommMechanismForManager

Antecedent: ref ObjectManagerDependent: ref ObjectManagerCommMechanismunicaiton

Antecedent: ref ServiceDependent: ref ServiceAccessPoint

ServiceAccessBySAP


Object Manager ModelObject Manager Model• CIM_ObjectManager

– CIM_WBEMService(Stop/Shutdown, Status, Set start mode)

• CIM_CommunicationMechanism– Describes access to a CIM Server – Describes CIM Operation capabilities and support

(e.g. Functional Profiles, Batch, Authentication)– CIM_CIMXMLCommunicationMechanism

• Association :– CIM_CommMechanismForManager


ObjectManagerObjectManager

myhost.mydomain.com*SystemNamestring

CIM Object Manager install dateInstallDatedatetime

OK, Error, degraded, unknown, pred fail, starting, stopping, service, stressed, non recover, no contact, lost comm, stoppedStatusstring

Name (e.g. ACMEObjectManager)*Namestring

CIM_ObjectManager*CreationClassNamestring

CIM_ComputerSystem*SystemCreationClassNamestring

Full Description of the CIM Object Manager.

Descriptionstring

One line descriptionCaptionstring

ValueProperty NameTypeCIM_ObjectManager : CIM_Service

started manually or automaticallyStartModestring

TrueStartedboolean

*Key

This has no effect for this classStartService()uint32

Stops/Shutdowns the CIMOMStopService()uint32


CommunicationMechanismCommunicationMechanism


When commMech was first availableInstallDatedatetime


Name of the Communication Mech.*Namestring

CIM_CommunicationMechanism*CreationClassNamestring


Full Description of the Communication Mechanism

Descriptionstring


ValueProperty NameTypeCIM_CommunicationMechanism

The functional profiles supportedProfilesSupporteduint16[]

Unknown, Other, CIM-XMLcommunicationmechanismuint16

*Key Note: The OtherXXX properties were left out for layout purposes

True | FalseMultipleOperationsSupportedboolean

Unknown, Other, None, Basic, DigestAuthenticationMechanismSupporteduint16[]


CIMXMLCommunicationMechanismCIMXMLCommunicationMechanism

True | FalseCIMValidatedboolean

1.0CIMXMLProtocolVersionuint16

2 (CIM-XML)CommunicationMechanismuint16

ValueProperty NameTypeCIM_CIMXMLCommunicationMechanism

Note: Also includes all properties from CIM_Communication Mechanism (previous slide). Not added here for readability.


NamespaceNamespace ModelModel• CIM_Namespace

– Scoped by Object Manager– Instance for each namespace in the system– Includes Class Information and Description

• CIM_SystemIdentification– The SystemIdentification class provides enough

data to identify the system(s) represented in theNamespace.

• Associations:– CIM_NameSpaceInManager– CIM_SystemInNameSpace


NamespaceNamespace


Full DescriptionDescriptionstring


Name (e.g. /root/cimv2)*Namestring

CIM_Namespace*CreationClassNamestring


ACMEObjectManager*ObjectManagerNamestring

CIM_ObjectManager*ObjectManagerCreationClassNamestring

ValueProperty NameTypeCIM_Namespace

Description (e.g. Local System Info)DescriptionOfClassInfostring

Type of Information (e.g. CIM2.6)ClassInfouint16

*Key


SystemIdentificationSystemIdentification

Indexed Array describing the format of the corresponding Identification format.

Format DescriptionString[]

Unknown, Other, Short DNS Name, Fully qualified DNS Name, Windows Domain Name, NetWare Server Name, Unix Hostname, Globally Unique System Identifier, "IP Address, Modem DialupString,MAC Address, IPMI Address

Identification Formatsuint16[]

Full Description of Information contained in the namespace

Descriptionstring


ValueProperty NameTypeCIM_ SystemIdentification

Indexed Array describing the data of the corresponding Identification format.

IdentificationDataString[]

Note: Not all properties are listed here (e.g. SystemName, …)


Use Cases/ExamplesUse Cases/Examples

• Walk through the following use cases and running examples:

Use Case 1: View the CIM Object Manager Information

Use Case 2: Determine the communication mechanisms supported by a CIM Server and the capabilities of each communication mechanism.

Use Case 3: Determine the namespaces available on a CIM Server and the information contained in each namespace.


CIM CIM Interop Interop 2.7 Preliminary2.7 Preliminary

• CIM Server Statistics Model– CIM Object Manager Performance– Debug Performance Issues

• Provider Model– Registration with the CIM Object Manager– Describe the Capabilities (class & type)– Support for Provider Modules– Manage providers


CIM Server Statistics ModelCIM Server Statistics Model

• CIM_CIMOMStatisticalData– provides statistical data about the performance of

the CIM Object Manager– Each object of this class provides elapsed time and

size data for a particular type of CIM operation– All operations of that type, regardless of the CIM

operations protocol being used, are accumulated into one object which therefore covers the CIM operations issued by all clients of the CIM Object Manager hosting the object


CIMOMStatisticalDataCIMOMStatisticalData

5000NumberOfOperationsuint64

1240000 (bytes)ResponseSizeuint64

250000 (bytes)RequestSizeuint64

ProviderElapsedTimedatetime

CIMOMElapsedTimedatetime

OtherOperationTypestring

(3) GetClassOperationTypeuint16

CIM<ID>, Where ID is unique*InstanceIDstring

ValueProperty NameTypeCIM_CIMOMStatisticalData


Provider ModelProvider Model• CIM_Provider

– CIM_WBEMService– Provider Handle

• CIM_ProviderCapabilities – Describes what the provider supports

(e.g. ClassName, Provider Type, …)• CIM_ProviderModule

– Module handle • Associations:

– CIM_ProviderCapabilities, CIM_ProviderInModule, CIM_ObjectManagerIsProvider, CIM_FiltersSupported


CIM_ProviderCIM_Provider


CIM Object Manager install dateInstallDatedatetime


Name (e.g. ACMEProvider)*Namestring

CIM_Provider*CreationClassNamestring


Full Description DescriptionstringOne line descriptionCaptionstring

ValueProperty NameType

CIM_Provider : CIM_Service

manually | automatic [on Denamd|on init]StartModestring

True | FalseStartedboolean

*Key

Start the ProviderStartService()uint32

Stop the ProviderStopService()uint32

stringRequired

Handle Implementatiion Specific (e.g. /usr/sadm/lib/…)


CIM_CIM_ProviderCapabilitiesProviderCapabilities

If NULL all methods are supportedSupportedMethodsString[]

If NULL all properties are supportedSupportedPropertiesString[]

Instance, Association, Indication, MethodProviderTypeUnit16[]CIM_OperatingSystemClassNamestring


CIM_ProviderCapabilities : CIM_Capabilities

*Note: LocalProperties Only

String[] OtherProviderType


CIM_CIM_ProviderModuleProviderModule

A human readable name that is unique

Namestring


CIM_ProviderModule : CIM_EnabledLogicalElement

*Note: LocalProperties Only

StringRequired

Handle An implementation specific string that identifies the handle of the provider


Provider RegistrationProvider RegistrationExampleExample

instance of CIM_ProviderModule {Name = ”ACMEOperatingSystemProvider”;Handle = ”/usr/sadm/lib/wbem/acme_os.so”;

};instance of CIM_ProviderCapabilities {ClassName = “CIM_OperatingSystem”;ProviderType = { 2 }; // InstanceSupportedProperties = NULL; // All propertiesSupportedMethods = NULL; // All methods

};

instance of CIM_Provider {Name = ”ACME_OperatingSystemProvider";Handle = “/usr/sadm/lib/wbem/acme_os.so”

};

Example 1: Standalone Provider for CIM_OperatingSystem

instance of CIM_ProviderElementCapabilities {ManagedElement = “…” Capabilities = “…”

};

instance of CIM_ProviderCapabilities {ClassName = “CIM_OperatingSystem”;ProviderType = { 2 }; // InstanceSupportedProperties = NULL; // All propertiesSupportedMethods = NULL; // All methods};

instance of CIM_Provider {Name = ”ACME_OperatingSystemProvider";Handle = “ACME_OperatingSystemProvider”;

};

Example 2: Provider for CIM_OperatingSystem in a Module

instance of CIM_ProviderElementCapabilities {ManagedElement = “…”Capabilities = “…”

};

instance of CIM_ProviderInModule {provider= ”...";Module = ”...";

};


What’s Next!What’s Next!• Q3-Q4 ‘02

– Discovery– Error Handling– Asynchronous Operations– CIM Query Specification

• Q4 ‘02/Q1 ‘03– CIM Operations 2.0

• Client & Provider Operations– Representation of CIM in XML 2.3– CIM-XML 2.0– CIM-SOAP 1.0


What’s Next!What’s Next!• Locking• Transactions• Protocol Adapter Model

– Manage Protocol Adapters (e.g. start/stop, ports)– Register/unregister protocol adapters

• Indication Delivery Handler Model– Manage indication delivery handlers– Register/unregister handlers


Q & AQ & A

Documents

Managing WBEM/CIM - login | DMTF WBEM/CIM Infrastructures Jim Davis Sun Microsystems, Inc. June 12, 2002