CIM-SPL Editor
 

 
 What is it? 
  
-----------
  
CIM-SPL Editor is an eclipse plugin to author CIM-SPL policies.


Prerequisites
-------------

1. A CIM Server: Like OpenPegasus 2.7.x download and install from http://www.openpegasus.org

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

2. SBLIM CIM client plugin: Download the latest SBLIM Java CIM client jars from
http://sblim.wiki.sourceforge.net/CimClient and create a eclipse plugin out of it as follows:
a. Create a folder  META-INF in a temporary location (say TMP).
b. Create a a file MANIFEST.MF under META-INF and paste the following into it:

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: Client Plug-in
Bundle-SymbolicName: org.sblim.cim.client
Bundle-Version: 1.0.0
Bundle-ClassPath: sblimCIMClient.jar
Export-Package: org.sblim.wbem.cim,
 org.sblim.wbem.cimxml,
 org.sblim.wbem.client,
 org.sblim.wbem.client.indications,
 org.sblim.wbem.client.operations,
 org.sblim.wbem.http,
 org.sblim.wbem.http.io,
 org.sblim.wbem.util,
 org.sblim.wbem.xml,
 org.sblim.wbem.xml.parser

c. Create another file build.properties under TMP/ and paste the following into it:

bin.includes = META-INF/,\
               sblimCIMClient.jar
               
d. Jar the META-INF and the build.properties to org.sblim.cim.client.jar
             




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.all

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

10. Unzip the SPLEditor.zip into your <ECLIPSE_HOME> folder

11. Copy the org.sblim.cim.client.jar into <ECLIPSE_HOME>/plugins folder

12. Restart Eclipse


 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/>