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              The CMPI header files are being standardized and will be (or by the time you 
11              read this, already are) frozen.  However, the Pegasus 2.4 release is done 
12              earlier than the anticipated date for freezing the CMPI standard. 
13              Hence to not provide the developer with a possibly not-frozen interface, 
14              the CMPI header files are not shipped as part of the SDK (openwbem-devel RPM). 
15              But they are part of the CVS and source tarball. Please visit
16              http://cvs.opengroup.org/cgi-bin/viewcvs.cgi/pegasus/src/Pegasus/Provider/CMPI/
17              to retrieve the frozen CMPI files.
18              
19              
20              Build CMPI from sources
21              -----------------------
22              

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

29 konrad.r 1.2    PEGASUS_ENABLE_CMPI_PROVIDER_MANAGER=1

30 schuur   1.1 

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

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

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

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