cimserver(1M)							 cimserver(1M)

NAME
       cimserver - 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 ALSO
       cimconfig(1M), cimserverd(8).

								 cimserver(1M)

Vote for polarhome