Chapter 11 CIM Object Manager

When Solaris WBEM Services is installed, the CIM Object Manager starts automatically and runs continuously. It restarts automatically between system sessions or after a power outage. At times, such as if you change a provider program, you have to manually restart the CIM Object Manager.

If you change a provider program, you must stop and restart the CIM Object Manager before you can use the updated provider.

This chapter describes how and when to stop and restart the CIM Object Manager. The following topics are covered.

• About CIM Object Manager

• The init.wbem Command

• The cimom Command

• Stopping the CIM Object Manager

• Restarting the CIM Object Manager

• Error Messages Generated by the CIM Object Manager

About CIM Object Manager

During the installation of Solaris WBEM Services, the CIM Object Manager starts automatically. Generally, you do not need to stop the CIM Object Manager. However, if you change a provider program, you must stop and restart the CIM Object Manager before you can use the updated provider.

Solaris WBEM Services provides one way to stop the CIM Object Manager and two ways to restart it. Use the init.wbem command to stop the CIM Object Manager. Use the init.wbem command to restart the CIM Object Manager between sessions, or use the cimom command to restart the CIM Object Manager on a specific host or view the version of the CIM Object Manager.

To stop a running CIM Object Manager or restart a stopped CIM Object Manager, you must be logged in as root. For information about stopping the CIM Object Manager, see "Stopping the CIM Object Manager". For information about restarting the CIM Object Manager after it has been stopped, see "Restarting the CIM Object Manager".

The init.wbem Command

The init.wbem restarts the CIM Object Manager between system sessions. The init.wbem command can also be used to stop the CIM Object Manager.

Location of the init.wbem Command

The init.wbem command is located in the following path: /etc/init.d/init.wbem.

Syntax of the init.wbem Command

The init.wbem command uses only two parameters:

The syntax of the init.wbem command is:

• init.wbem stop

• init.wbem start

The cimom Command

Use the cimom command to start the CIM Object Manager when you want to obtain or specify additional information, such as the host that contains a CIM Repository in which you want your objects to be stored. The cimom command uses parameters that enable you to specify characteristics of the CIM Object Manager.

Location of the cimom Command

By default, the cimom command is located in the following path: /opt/SUNWconn/wbem/bin/

Syntax of the cimom Command

The cimom command uses the following three parameters.

The syntax of the cimom command is: cimom [parameter] [modifier]

where [parameter] is any of the parameters shown in the preceding table, and [modifier] is the additional information that is required by a parameter. For example in the command cimom -s hopskotch, -s is the [parameter] and hopskotch is the [modifier] that indicates the name of the server on which the CIM Repository is located.

Stopping the CIM Object Manager

Use the following procedure to stop the CIM Object Manager.

How to Stop the CIM Object Manager

1. Become root on your system by typing the following command at the system prompt:

   % su

2. Type the root password when you are prompted.

3. Change directories to the location of the init.wbem command by typing the following command:

   # cd /etc/init.d/

4. Stop the CIM Object Manager by typing the following command:

   # ./init.wbem stop

   The CIM Object Manager stops.

Restarting the CIM Object Manager

You can restart the CIM Object Manager using the init.wbem command or the cimom command, depending on how you want to restart. If you want to restart the CIM Object Manager on the default host, use the init.wbem command. If you want to restart the CIM Object Manager on another host, use the cimom command. Using the cimom command, you can also view the version of the CIM Object Manager.

How to Restart the CIM Object Manager Using Default Settings

1. Become root on your system by typing the following command at the system prompt:

   % su

2. Type the root password when you are prompted.

3. Change directories to the location of the init.wbem command by typing the following command:

   # cd /etc/init.d/

4. Restart the CIM Object Manager by typing the following command:

   # ./init.wbem start

   The CIM Object Manager starts.

How to Restart the CIM Object Manager and Specify a Host

1. Become root on your system by typing the following command at the system prompt:

   % su

2. Type the root password when you are prompted.

3. Change directories to the location of the cimom command by typing the following command:

   # cd /opt/SUNWconn/wbem/bin

4. Restart the CIM Object Manager and specify a host by typing the following command:

   # cimom -s server_name

   where server_name is the name of a specific host running a CIM Object Manager Repository.

   The CIM Object Manager resumes running.

Error Messages Generated by the CIM Object Manager

The CIM Object Manager generates error messages to indicate incorrect MOF syntax and semantics. The same error messages are generated by the MOF Compiler and the CIM Workshop. To view the error messages and their meanings, see Chapter 9, Error Messages.