Installing the Eclipse Equinox OSGi framework with Eclipse Gemini for clients and servers

If you want to deploy WebSphere® eXtreme Scale in the OSGi framework, then you must set up the Eclipse Equinox Environment.

About this task

The task requires that you download and install the Blueprint framework, which allows you to later configure JavaBeans and expose them as services. The use of services is important because you can expose plug-ins as OSGi services so they can be used by the eXtreme Scale run time environment. The product supports two blueprint containers within the Eclipse Equinox core OSGi framework: Eclipse Gemini and Apache Aries. Use this procedure to set up the Eclipse Gemini container.

Procedure

Download Eclipse Equinox SDK Version 3.6.1 or later from the Eclipse website.
Create a directory for the Equinox framework, for example: /opt/equinox. These instructions refer to this directory as equinox_root. Extract the compressed file in the equinox_root directory.
Download the gemini-blueprint incubation 1.0.0 compressed file from the Eclipse website.
Extract the file contents into a temporary directory, and copy the following extracted files to the equinox_root/plugins directory:
```
dist/gemini-blueprint-core-1.0.0.jar
dist/gemini-blueprint-extender-1.0.0.jar
dist/gemini-blueprint-io-1.0.0.jar
```
Attention: Depending on the location where you download the compressed Blueprint file, the extracted files might have the extension, RELEASE.jar, much like the Spring framework JAR files in the next step. You must verify that the file names match the file references in the config.ini file.

Download the Spring Framework Version 3.0.5 from the following SpringSource web page: http://www.springsource.com/download/community.

Extract it into a temporary directory, and copy the following extracted files to the equinox_root/plugins directory:

org.springframework.aop-3.0.5.RELEASE.jar
org.springframework.asm-3.0.5.RELEASE.jar
org.springframework.beans-3.0.5.RELEASE.jar
org.springframework.context-3.0.5.RELEASE.jar
org.springframework.core-3.0.5.RELEASE.jar
org.springframework.expression-3.0.5.RELEASE.jar

Download the AOP Alliance Java™ archive (JAR) file from the SpringSource web page.
Copy the com.springsource.org.aopalliance-1.0.0.jar to the equinox_root/plugins directory.
Download the Apache commons logging 1.1.1 JAR file from the SpringSource web page.
Copy the com.springsource.org.apache.commons.logging-1.1.1.jar file to the equinox_root/plugins directory.
Download the Luminis OSGi Configuration Admin command-line client. Use this JAR file bundle to manage OSGi administrative configurations.
Copy the net.luminis.cmc-0.2.5.jar to the equinox_root/plugins directory.
Download the Apache Felix file installation Version 3.0.2 bundle from the following web page: http://felix.apache.org/site/index.html.
Copy the org.apache.felix.fileinstall-3.0.2.jar file to the equinox_root/plugins directory.
Create a configuration directory inside equinox_root/plugins directory; for example:
```
mkdir equinox_root/plugins/configuration
```

Create the following config.ini file in the equinox_root/plugins/configuration directory, replacing equinox_root with the absolute path to your equinox_root directory and removing all trailing spaces after the backslash on each line. You must include a blank line at the end of the file; for example:

osgi.noShutdown=true
osgi.java.profile.bootdelegation=none
org.osgi.framework.bootdelegation=none
eclipse.ignoreApp=true
osgi.bundles=\
org.eclipse.osgi.services_3.2.100.v20100503.jar@1:start, \
org.eclipse.osgi.util_3.2.100.v20100503.jar@1:start, \
org.eclipse.equinox.cm_1.0.200.v20100520.jar@1:start, \
com.springsource.org.apache.commons.logging-1.1.1.jar@1:start, \
com.springsource.org.aopalliance-1.0.0.jar@1:start, \
org.springframework.aop-3.0.5.RELEASE.jar@1:start, \
org.springframework.asm-3.0.5.RELEASE.jar@1:start, \
org.springframework.beans-3.0.5.RELEASE.jar@1:start, \
org.springframework.context-3.0.5.RELEASE.jar@1:start, \
org.springframework.core-3.0.5.RELEASE.jar@1:start, \
org.springframework.expression-3.0.5.RELEASE.jar@1:start, \
org.apache.felix.fileinstall-3.0.2.jar@1:start, \
net.luminis.cmc-0.2.5.jar@1:start, \
gemini-blueprint-core-1.0.0.jar@1:start, \
gemini-blueprint-extender-1.0.0.jar@1:start, \
gemini-blueprint-io-1.0.0.jar@1:start

If you have already set up the environment, you can clean up the Equinox plug-in repository by removing the following directory: equinox_root\plugins\configuration\org.eclipse.osgi.

Run the following commands to start equinox console.
If you are running a different version of Equinox, then your JAR file name is different from the one in the following example:
```
java -jar plugins\org.eclipse.osgi_3.6.1.R36x_v20100806.jar -console
```