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