CIM-SPL Provider
 

 
 What is it? 
  
-----------
  
CIM-SPL Provider is a CIM binding for Apache Imperius.
A CIM binding allows the Imperius engine to interact with objects in
the CIM environment.
The CIM-SPL Provider is registered as an instance and method provider into
a CIM Server. The CIM-SPL provider implements the CIM-SPL standard specification.


Prerequisites
-------------
1. SBLIM CIM client jars: Download the latest SBLIM Java CIM client jars from
http://sblim.wiki.sourceforge.net/CimClient

2. A CIM Server: Like OpenPegasus 2.7.x download and install from http://www.openpegasus.org
(Note: As the Client side provider uses the SBLIM jars any compatible CIM Server an be used)


Build
------
1. Install the SBLIM jar into the Maven local repository using the following commands

mvn install:install-file -Dfile=c:/sblim.jar -DgroupId=sblim \
    -DartifactId=sblimCIMClient -Dversion=1.0.0 -Dpackaging=jar

2. Install the JMPIImpl.jar found in <PEGASUS_HOME>/lib folder using the following command

mvn install:install-file -Dfile=<PEGASUS_HOME>/JMPIImpl.jar -DgroupId=openpegasus \
    -DartifactId=jmpiimpl -Dversion=1.0.0 -Dpackaging=jar

3. In the top level directory issue the command

ant cimspl.runtime

Deploy
-------
The CIM-SPL Provider needs to be deployed into OpenPegasus before use. To
deploy the provider do the following:

1. Build OpenPegasus with JMPI enabled. Refer to the OpenPegasus documentation for more
information. 

2. Unzip the generated imperius-cimsplprovider-1.0.0.zip into a temporary location <TEMP>

3. Copy the contents of <TEMP>/imperius-cimsplprovider-1.0.0/lib to <PEGASUS_HOME>/lib

4. Copy the <ANTLR_HOME>/lib/antlr.jar to <PEGASUS_HOME>/lib

5. Add the above jars to the CLASSPATH and LD_LIBRARY_PATH variables as follows:

set  LD_LIBRARY_PATH=%LD_LIBRARY_PATH%;%PEGASUS_HOME%\lib\imperius-cimsplprovider-1.0.0.jar;
set  LD_LIBRARY_PATH=%LD_LIBRARY_PATH%;%PEGASUS_HOME%\lib\imperius-splcore-1.0.0.jar;
set  LD_LIBRARY_PATH=%LD_LIBRARY_PATH%;%PEGASUS_HOME%\lib\imperius-cimsplcommon-1.0.0.jar;
set  LD_LIBRARY_PATH=%LD_LIBRARY_PATH%;%PEGASUS_HOME%\lib\antlr.jar;

set  CLASSPATH=%CLASSPATH%;%PEGASUS_HOME%\lib\imperius-cimsplprovider-1.0.0.jar;
set  CLASSPATH=%CLASSPATH%;%PEGASUS_HOME%\lib\imperius-splcore-1.0.0.jar;
set  CLASSPATH=%CLASSPATH%;%PEGASUS_HOME%\lib\imperius-cimsplcommon-1.0.0.jar;
set  CLASSPATH=%CLASSPATH%;%PEGASUS_HOME%\lib\antlr.jar;

6. Copy <TEMP>/imperius-cimsplprovider-1.0.0/customexpressions.properties to <PEGASUS_ROOT>

7. Start the CIM Server

> cimserver

8. Register the CIM-SPL Policy class as follows

> cimmof -n root/cimv2 <TEMP>/imperius-cimsplprovider-1.0.0/CIM_SPLPolicyRule.mof

9. Register the CIM-SPL Provider as follows

> cimmof -n root/PG_InterOp <TEMP>/imperius-cimsplprovider-1.0.0/CIM_SPLPolicyRuleProviderR.mof

9. Make sure the provider is installed and operational by running the following command:

> cimcli -n root/cimv2 ei CIM_SPLPolicyRule



 The Latest Version
  
------------------

  
Details of the latest version can be found on the Apache Imperius
  
Project web site <http://incubator.apache.org/Imperius/>.


  

Documentation
  
-------------

 
 Documentation is available online at the project website


Samples
--------
Sample polices are located under the cimspl-samples project.




 Licensing
  
---------

  
This software is licensed under the terms you may find in the file 
 
 named "LICENSE" in this directory.
  

 
 Thanks for using Imperius.

                                          
The Apache Imperius Project
                                         
<http://incubator.apache.org/Imperius/>