cimserver(1M)cimserver(1M)NAMEcimserver - start or stop the CIM Server; display the version number of
the CIM Server
SYNOPSIS
[configProperty=value] ...
=value]
Remarks
This command can only be executed by a privileged user.
DESCRIPTION
The command provides a command line interface to stop and start the CIM
Server, as well as to display the version number of the CIM Server.
After installation, the CIM Server must be started using the command.
If the system is rebooted, the CIM Server will automatically restart,
with the exception of the case where the CIM Server was shutdown prior
to the reboot. Generally, once the CIM Server is started, it is
expected to be always running and ready to serve CIM requests. How‐
ever, if the CIM Server must be stopped and restarted, the command can
be used to shutdown the CIM Server gracefully and restart it at a later
time.
Starting the CIM Server
Issuing the command without any options starts the CIM Server process.
When starting the CIM Server using the command, the <configProp‐
erty=value> syntax can be used to set the configuration properties to
be used by the CIM Server. It is important to know that the values
specified in the command apply only to the current CIM Server process
that gets started. The default values for the configuration properties
do not change. For a list of the CIM Server configuration properties,
see the man page for the command or the HP WBEM Services Administra‐
tor's Guide.
Shutting down the CIM Server
Issuing the command with the option stops the CIM Server. Optionally,
a timeout value can be specified by setting the configuration property.
Under normal operation, CIM Server should be able to be shutdown fairly
quickly without problem. There are, however, situations that may pre‐
vent CIM Server from shutting down within a reasonable amount of time.
For example, a provider that is not responding to requests, or a
provider that is servicing a long-running CIM request. To handle such
situations and to ensure that the CIM Server can be shutdown without
having the user wait a long period of time (or indefinitely), a shut‐
down timeout value is used.
The shutdown timeout value is the maximum amount of time (in seconds)
the user is willing to wait for the CIM Server to complete all the out‐
standing CIM operation requests before shutting down the CIM Server.
If the specified shutdown timeout period expires, the CIM Server will
be shutdown even if there are CIM operations in progress. The shutdown
timeout value is a CIM Server configuration property (that can be
changed using the command. The default shutdown timeout value is 30
seconds.
A timeout value (in seconds) can be specified in the command to shut‐
down the CIM Server using the =value> syntax. This overrides the
default shutdown timeout value. The minimum timeout value is 3 sec‐
onds.
While CIM Server is shutting down, a client connection request will
result in a connection error (the same as if the CIM Server were not
running). For clients who have already established a connection to the
CIM Server, new CIM requests will be rejected with a CIM error indicat‐
ing that the CIM Server is shutting down.
When a client receives a response containing a CIM error indicating
that the CIM Server is shutting down, it should close the connection
and reconnect to CIM Server at a later time.
Options
The command recognizes the following options:
Display the version number of the CIM Server.
Display the command usage.
Stop the CIM Server.
Specify the timeout value for shutting down the CIM Server.
This can only be used in conjunction with the
option. The minimum timeout value is 3 seconds.
If this is not specified, the default config‐
urable timeout value will be used.
configProperty=value
Set the value for the specified configuration
property to be used in starting the CIM Server.
EXIT STATUS
The command returns one of the following values:
Success
Error
When an error occurs, an error message is written to stderr and an
error value of 1 is returned.
DIAGNOSTICS
The command was issued to stop the CIM Server when CIM Server
was not running. An exit status value of 1 is returned.
The command was issued to start the CIM Server and some other
application is using 5989 port which should be used by cim‐
server. An exit status value of 1 is returned.
The command was issued to start the CIM Server and the CIM
Server was already running. An exit status value of 1 is
returned.
EXAMPLES
Stop the CIM Server with the default timeout value of 30 seconds.
Stop the CIM Server with a timeout value of 5 seconds.
Start the CIM Server.
Start the CIM Server with the configuration property set to true.
Display the version number of the CIM Server. This version number is
used to identify the release version of the CIM Server in the HP WBEM
Services product.
Display the command usage.
AUTHOR
was developed by the Open Group OpenPegasus Open Source Software
project.
SEE ALSOcimconfig(1M), cimserverd(8).
cimserver(1M)