2.2 Installing from the ZIP Download
Prev | 2. Installing Gemini Web | Next

## 2.2 Installing from the ZIP Download

- Download the Equinox JAR, for example org.eclipse.osgi_3.10.2.v20150203-1939.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 Only' section.

- Download the Equinox Console, for example equinox-SDK-LunaSR2.zip. You will need the bundles listed below:

  - org.apache.felix.gogo.command_0.10.0.v201209301215.jar
  - org.apache.felix.gogo.runtime_0.10.0.v201209301036.jar
  - org.apache.felix.gogo.shell_0.10.0.v201212101605.jar
  - org.eclipse.equinox.console_1.1.0.v20140131-1639.jar

  Move them to a suitable directory (e.g. ~/gemini-web-test). On the Download page, first choose the desired Release or Build, then download the ZIP from the 'All of Equinox' section. Bundles can be found in the plugins folder.

- 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 a file config.ini in the configuration directory. Example file which works with 3.0.0.RELEASE is available in config.ini.zip. Essentially config.ini ensures 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.

- Start Equinox as follows:

      java -jar org.eclipse.osgi_3.10.2.v20150203-1939.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 webbundle:file:simple-war.war?Web-ContextPath=/simple-war
      Bundle id is 43
      osgi> start 43

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

Prev | Up | Next
2. Installing Gemini Web | Home | 3. Configuration