Make a Connection to the CIMOM

Before you can enumerate classes, invoke methods, or examine properties of the managed server, you must create a connection object in your client. The connection object manages the connection with the CIM server, accepts CIM methods by proxy, and passes them to the CIM server. The following pseudocode illustrates how to create a connection by using command-line parameters passed to the client.

To make a connection to the CIMOM

Procedure

  1. Collect the connection parameters from the environment. 
    use os

function parse_environment() 
   ///Check if all parameters are set in the shell environment.///
   VI_SERVER = VI_USERNAME = VI_PASSWORD = VI_NAMESPACE=Null
   ///Any missing environment variable is cause to revert to command-line arguments.///
   try
      return { 'VI_SERVER':os.environ['VI_SERVER'], \
               'VI_USERNAME':os.environ['VI_USERNAME'], \
	               'VI_PASSWORD':os.environ['VI_PASSWORD'], \
	               'VI_NAMESPACE':os.environ['VI_NAMESPACE'] }
   catch
      return Null

use sys

function get_params() 
   ///Check if parameters are passed on the command line.///
   param_host = param_user = param_password = param_namespace = Null
   if len( sys.argv ) == 5 
      print 'Connect using command-line parameters.'
      param_host, param_user, param_password, param_namespace = sys.argv [ 1:5 ] 
      return { 'host':param_host, \
               'user':param_user, \
               'password':param_password, \
               'namespace':param_namespace }
   env = parse_environment()
   if env 
      print 'Connect using environment variables.'
      return { 'host':env['VI_SERVER'], \
               'user':env['VI_USERNAME'], \
	               'password':env['VI_PASSWORD'], \
	               'namespace':env['VI_NAMESPACE'] }
   else
      print 'Usage: ' + sys.argv[0] + ' <host> <user> <password> [<namespace>]'
      print '  or set environment variables: VI_SERVER, VI_USERNAME, VI_NAMESPACE'
      return Null

params = get_params()
if params is Null 
   exit(-1)
  2. Create the connection object in the client. 
    use wbemlib
connection = Null

function connect_to_host( params ) 
   ///Connect to the server.///
   connection = wbemlib.WBEMConnection( 'https://' + params['host'], \
             ( params['user'], params['password'] ), \
             params['namespace'] )
   return connection

if connect_to_host( params ) 
   print 'Connected to: ' + params['host'] + ' as user: ' + params['user']
else
   print 'Failed to connect to: ' + params['host'] + ' as user: ' + params['user']

    With some client libraries, creating a connection object in the client does not send a request to the CIMOM. A request is not sent until a method is called. To verify that such a client can connect to and authenticate with the server, see another use case, such as Listing Registered Profiles in the CIM Implementation.