init.wbem

- start and stop the CIM Boot Manager

Synopsis

svccfg svc:/application/management/wbem start | stop 

Description

The init.wbem utility is run automatically during installation, each time the system is rebooted, and by means of the svccfg(1M) command. This method manipulates the CIM Object Manager (CIMOM). init.wbem can be used to start, stop, or retrieve status from the server.

CIM Object Manager

The CIM Object Manager manages CIM objects on a WBEM-enabled system. A CIM object is a computer representation, or model, of a managed resource, such as a printer, disk drive, or CPU. CIM objects are stored internally as Java classes.

When a WBEM client application accesses information about a CIM object, the CIM Object Manager contacts either the appropriate provider for that object or the CIM Object Manager Repository. Providers are classes that communicate with managed objects to access data.

When a WBEM client application requests data from a managed resource that is not available from the CIM Object Manager Repository, the CIM Object Manager forwards the request to the provider for that managed resource. The provider dynamically retrieves the information.

At startup, the CIM Object Manager performs the following functions:

• Listens for RMI connections on RMI port 5987 and for XML/HTTP connections on HTTP port 5988.

• Sets up a connection to the CIM Object Manager Repository.

• Waits for incoming requests.

During normal operations, the CIM Object Manager performs the following functions:

• Performs security checks to authenticate user login and authorization to access namespaces.

• Performs syntactical and semantic checking of CIM data operations to ensure that they comply with the latest CIM Specification.

• Routes requests to the appropriate provider or to the CIM Object Manager Repository.

• Delivers data from providers and from the CIM Object Manager Repository to WBEM client applications.

A WBEM client application contacts the CIM Object Manager to establish a connection when it needs to perform WBEM operations, such as creating a CIM class or updating a CIM instance. When a WBEM client application connects to a CIM Object Manager, it gets a reference to the CIM Object Manager, which it then uses to request services and operations.

System Booting

The init.wbem script is installed in the /etc/init.d directory.

Options

The init.wbem function is implemented as a service management facility (SMF) method and is controlled by means of the svcadm(1M) command using the fault management resource identifier (FMRI) svc:/application/management/wbem.

The following options are supported through svcadm(1M):

start

Starts the CIMOM on the local host.

stop

Stops the CIMOM.

status

Gets the status of the CIMOM.

The SMF property options/tcp_listen is used to control whether CIMOM and the Solaris Management console server will respond to requests from remote systems.

The specification:

svc:/application/management/wbem/options/tcp_listen = true

...allows remote access and false disallows remote access. false is the default value.

Examples

Example 1 Allowing Access to Remote Systems

The following commands enable CIMOM to allow access from remote systems.

# svccfg -s \
svc:/application/management/wbem setprop options/tcp_listen = true
# svcadm refresh svc:/application/management/wbem

Notes

When the init.wbem script is invoked by SMF, it does not run the CIMOM directly. The server process is in Java and is too heavyweight to be run immediately at system boot time. Instead, three lightweight processes listen on three different ports that the CIMOM normally uses. This acts similarly to inetd(1M).

Because Java programs cannot inherit file descriptors as other programs can, there is a small time period from when the first connection is made until the server is fully operational where client connections may be dropped. WBEM clients are immune to this, as they will retry until the server comes online.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

inetd(1M), mofcomp(1M), svccfg(1M), svcadm(1M), wbemadmin(1M), wbemlogviewer(1M), attributes(5), smf(5)