1 schuur 1.1 CMPI Providers in a nutshell
 2            ============================
 3            
 4            Viktor Mihajlovski <mihajlov@de.ibm.com>
 5            Nov 14th 2003
 6            

 7 konrad.r 1.3 Pegasus 2.4 *NEWS*
 8              ------------------
 9              

10 konrad.r 1.5 The CMPI header files are being standardized and will be (possibly by the 
11              time you read this) frozen.  However, since the OpenPegasus 2.4 release is 
12              anticipated prior to the anticipated freezing of the CMPI standard, 
13              the OpenPegasus 2.4 release will not provide the CMPI header files as 
14              part of the OpenPegasus 2.4 SDK. 

15 konrad.r 1.3 

16 konrad.r 1.5 They can be found within CVS and the source tarball. Visit
17              http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/pegasus/src/Pegasus/Provider/CMPI/ to view the CMPI header files.

18 konrad.r 1.3 
19              Build CMPI from sources
20              -----------------------
21              

22 schuur   1.1 The Common Manageability Programming Interface (CMPI) has been integrated into
23              Pegasus as a pluggable provider manager.
24              
25              CMPI must be enabled during Pegasus build.
26              For CMPI enablement, set the following environment variables prior to make:
27              

28 konrad.r 1.2    PEGASUS_ENABLE_CMPI_PROVIDER_MANAGER=1

29 schuur   1.1 

30 konrad.r 1.3 
31              Using CMPI
32              ----------

33 schuur   1.1 If you plan to write your own CMPI providers you are kindly referred to the
34              WBEMSource homepage where the draft specification document for CMPI resides.
35              You can find at http://www.wbemsource.org/doc.tpl?CALLER=index.tpl&gdid=3712 .
36              If you are looking for samples you should have a look at the SBLIM project.
37              The packages prefixed by the string sblim-cmpi contain CMPI providers for
38              various classes. See http://www-124.ibm.com/developerworks/projects/sblim .
39              

40 konrad.r 1.3 
41              Registering CMPI providers with Pegasus
42              ---------------------------------------
43              

44 schuur   1.1 Once you have a CMPI provider library you want to register it with Pegasus.
45              How? Well it's almost the same as for C++ providers. The only difference is
46              that the Provider.Interface property must be set to "CMPI".
47              
48              Here's an excerpt from the SBLIM Linux Computer System provider registration
49              
50              // ===================================================================
51              // 	Linux_ComputerSystem
52              // ===================================================================
53              
54              
55              instance of PG_ProviderModule
56              {
57                 Name = "OSBase_ComputerSystemProviderModule";
58                 //The library name on disk
59                 Location = "cmpiOSBase_ComputerSystemProvider";
60                 Vendor = "SBLIM";
61                 Version = "1.2.2";
62                 InterfaceType = "CMPI";
63                 InterfaceVersion = "0.86.0";
64              };
65 schuur   1.1 
66              instance of PG_Provider
67              {
68                 //The provider module as defined in PG_ProviderModule
69                 ProviderModuleName = "OSBase_ComputerSystemProviderModule";
70                 // The provider name as referenced in the code
71                 Name = "OSBase_ComputerSystemProvider";
72              };
73              
74              instance of PG_ProviderCapabilities
75              {
76                 //The provider module as defined in PG_ProviderModule
77                 ProviderModuleName = "OSBase_ComputerSystemProviderModule";
78                 //The provider name as defined in PG_Provider
79                 ProviderName = "OSBase_ComputerSystemProvider";
80                 CapabilityID = "1";
81                 //Name of the CIM class as defined in the mof
82                 ClassName = "Linux_ComputerSystem";
83                 Namespaces = {"root/cimv2"};
84                 ProviderType = { 2,5 }; // Instance, Method
85                 SupportedProperties = NULL; // All properties
86 schuur   1.1    SupportedMethods = NULL; // All methods
87              };
88