Accessing and building Imperius source

Ther are three ways to access the source

1. Web Access: The code repository can be browsed here
2. Anonymous SVN: SVN URL for anonymous users is http://svn.apache.org/repos/asf/incubator/imperius Instructions for anonymous access are here .
3. Committer SVN: SVN URL for committers is https://svn.apache.org/repos/asf/incubator/imperius Instructions for committer access are here

To build Imperius you must install Apache Maven 2.0.4 , Apache Ant, Java 142 and Subversion client on your system. After the installation make sure that the mvn, ant, java and svn executables are in the search path (e.g. %PATH%). Then follow the steps below to build the particular SPL binding you need.

Building Imperius with Java binding (JavaSPL)

Once you have installed these three applications, simply download the build file to a directory where you'd like to create the Imperius distribution and run ant from that directory. The build will use the Subversion client to pull down the latest files from the Imperius repository (subsequent runs of the build will use your local copy of the files). When the build is complete, you can find the distribution archives in /dist.

Build the SPL Editors

To build the SPL Editor:

• First configure the maven repository with eclipse plugins. To do this on a command prompt run mvn eclipse:make-artifacts -DeclipseDir= < ECLIPSE_HOME >
• To build the JavaSPL editor Run ant javaspl.runtime.editor
• To build the CIMSPL editor Run ant cimspl.all (Please refer to the README located under the /imperius-cimsplextension folder for further details)

Build CIM-SPL Client Side provider

1. Install the pre-requisites listed above then download the SBLIM CIM Java client jars
2. Next download and install a CIM Server like OpenPegasus 2.7.x (Note: As the Client side provider uses the SBLIM jars any compatible CIM Server an be used)
3. 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
4. In the trunk directory issue the command ant cimspl.clientside.runtime

Build CIM-SPL Provider

1. Install the pre-requisites listed above then download the SBLIM CIM Java client jars
2. Next download and install a CIM Server like OpenPegasus 2.7.x (Note: As the Client side provider uses the SBLIM jars any compatible CIM Server an be used)
3. 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
4. Install the JMPIImpl.jar found in <PEGASUS_HOME>/lib folder using the following command mvn install:install-file -Dfile=<PEGASUS_HOME>/lib/JMPIImpl.jar -DgroupId=openpegasus -DartifactId=jmpiimpl -Dversion=1.0.0 -Dpackaging=jar
5. In the trunk directory issue the command ant cimspl.runtime
6. Refer to the README under the imperius-cimsplprovider folder for instructions on registering the provider with a CIM server

To develop using eclipse download and install Subclipse plugin and ANTLRv2.7.7 .

Then Select New > Project > SVN > Checkout Project from SVN. Next, create a new repository location using the anonymous SVN URL (or Committer SVN URL) shown above.

Next, follow the steps below to configure eclipse for the specific Imperius binding you need.

Set up Eclipse for Imperius with Java binding (JavaSPL)

1. Explore to /trunk/modules and select imperius-splcore and imperius-javaspl modules. Click Next.
2. Select the option to create a Java project for each directory (module) and click Finish. Subversion will now download the code into the appropriate eclipse projects
3. The projects will not compile as the required libraries are missing. To fix this
   • Add the $ANTLR_HOME/lib/antlr.jar downloaded earlier to the classpath for imperius-splcore project
   • Add imperius-splcore project as a dependency for imperius-javaspl
4. Make sure you refresh all projects to force a recompilation