1 karl  1.1 For the demo, we need class level information within the wsman
 2           conversions but do not have things like xsds, access to xsd 
 3           repositories, etc.  The pegasus repository was a logical source
 4           of this information.  
 5           
 6           So, we extensivly use the pegasus repository with getclass to
 7           crete meta-information about classes.  This assumes that we can
 8           access a pegasus repository even for instance operations.
 9           
10           When working with Pegasus that is easy since Pegasus is always
11           available. We assume that the address of the wsman server and 
12           the source for class information are the same.
13           
14           However, when working with other wsman servers both the client aps
15           and internal implementation need access to this information so
16           for the demo we set up a way that we can have one address for
17           the wsman server and a second address representing the pegasus
18           server which will be used for class operations and for getting
19           any class level information needed by the client.
20           
21           To use this, set the following Environment variable before starting
22 karl  1.1 any client
23           
24           WSM_PEGASUS_HOST
25           and
26           WSM_PWGASUS_PORT
27           
28           Thus
29           
30           export WSM_PEGASUS_HOST=localhost
31           export WSM_PEGASUS_PORT=5988
32           
33           When the WSM_USE_WSMAN=true environment variable is set, the WSMCLI client
34           sends instance operations to a wsman destination and both api driven class
35           operations (ex. getClass) and background class operations to the PEGASUS Host
36           defined. This means the the host and port specified on the CIMCLient   connect
37           call (the -n option with CLI)  represent:
38           
39           1. the cimxml cimserver when WSM_USE_WSMAN is NOT set.
40           2. The wsman server for all instance operations and ignored for class
41           operations if WSM_USE_WSMAN is set.
42           
43 karl  1.1 The defaults for server addresses are applied as follows:
44           
45           cimxml server address:
46           
47               localhost:5988
48           
49           wsmanserver address
50           
51           localhost:<<value in defines.h>> (port 80 for the demo)
52           
53           Thus, The cli -n options specifies the WSM host and port for instance operations
54           when the WSM_USE_WSMAN=true flag is set and the cimxml host when the
55           flag is not set.
56           
57           NOTE: The code today DOES NOT allow the port 5988 to be used as the port for
58           the wsman server.  If you do use that address, it will cause problems.
59           
60           Thus, some examples that work:
61           
62           export WSM_PEGASUS_HOST=hostb
63           export WSM_PEGASUS_PORT=5988
64 karl  1.1 
65           cli ni CIM_Computersystem -l hostb:5988
66           
67               will access the cimxml server with cimxml address
68           
69           export WSM_USE_WSMAN=1
70           
71           cli ni CIM_ComputerSystem -l hostb:80
72              
73              will access the wsman server on hostb at port 80
74              Note that it will also get class info from the Pegasus server
75              defined in the exports above.
76           
77           cli ni CIM_ComputerSystem -l hostb
78           
79           1 Nov 2006
80           
81           
82