Download the Equinox JAR, for example org.eclipse.osgi_3.6.0.v20100517.jar, and move it to a suitable directory (e.g. ~/gemini-web-test). On the Download page, first choose the desired Release or Build, then download the JAR from the Framework section.
Gemini Web Container is distributed as a ZIP file. Download Gemini Web Container and unzip it to ~/gemini-web-test/gemini-web.
Configure Equinox by creating a directory ~/gemini-web-test/configuration and create files config.ini and Java6-server.profile in the configuration directory. Example files which work with 1.1.0.RELEASE are available in config.ini.zip and Java6-server.profile.zip. Essentially config.ini ensures that Java6-server.profile is used and that the dependencies of Gemini Web Container, which come in the dep directory, are installed and then the Gemini Web Container bundles are installed and started. Java6-server.profile ensures that javax.xml.ws is exported at version 2.1.1 from the system bundle as the Tomcat bundles in Gemini Web Container depend on that version.
Start Equinox as follows:
java -jar org.eclipse.osgi_3.6.0.v20100517.jar -console
You can then deploy WAR files (a trivial example is available in Simple-war.war.zip) and web bundles using the install and start commands from the console.
osgi> install file:simple-war.war Bundle id is 40 osgi> start 40
Drive the WAR or web bundle using a web browser, e.g. http://localhost:8080/simple-war should display "Hello World!".
Stop Gemini Web Container as follows:
osgi> close
![]() | Tip |
---|---|
You need to stop any old instance of Gemini Web before starting it again. Otherwise, the new instance will not start correctly, because the old one still occupies the http port (and, perhaps, other system resources). |