Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Gemini/Web"

(Trying out Gemini Web)
Line 9: Line 9:
 
2. [http://www.eclipse.org/gemini/web/download Download] Gemini Web and unzip it to ~/gemini-web-test/gemini-web.  
 
2. [http://www.eclipse.org/gemini/web/download Download] Gemini Web and unzip it to ~/gemini-web-test/gemini-web.  
  
3. 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 works with '''1.1.0.RELEASE''' are available in [http://wiki.eclipse.org/images/5/5e/Config.ini.zip config.ini.zip] and [http://wiki.eclipse.org/images/3/32/Java6-server.profile.zip Java6-server.profile.zip]. Essentially config.ini ensures that Java6-server.profile is used and that the dependencies of Gemini Web, which come in the dep directory, are installed and then the Gemini Web 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 depend on that version.  
+
3. 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 works with '''1.1.0.RELEASE''' are available in [http://wiki.eclipse.org/images/5/5e/Config.ini.zip config.ini.zip] and [http://wiki.eclipse.org/images/3/32/Java6-server.profile.zip Java6-server.profile.zip]. Essentially config.ini ensures that Java6-server.profile is used and that the dependencies of Gemini Web, which come in the dep directory, are installed and then the Gemini Web 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 depend on that version.  
  
 
4. Start Equinox as follows:  
 
4. Start Equinox as follows:  
Line 15: Line 15:
 
  java -jar org.eclipse.osgi_3.6.0.v20100517.jar -console
 
  java -jar org.eclipse.osgi_3.6.0.v20100517.jar -console
  
5. You can then install WAR files (a trivial example is available in [http://wiki.eclipse.org/images/a/a0/Simple-war.war.zip Simple-war.war.zip]) and web bundles using the install command from the console. Refer to the [http://www.eclipse.org/gemini/web/documentation documentation] for more information.
+
5. You can then deploy WAR files (a trivial example is available in [http://wiki.eclipse.org/images/a/a0/Simple-war.war.zip Simple-war.war.zip]) and web bundles using the install and start commands from the console. Refer to the [http://www.eclipse.org/gemini/web/documentation documentation] for more information.  
 
+
<pre>
 
osgi> install file:simple-war.war
 
osgi> install file:simple-war.war
 
Bundle id is 40
 
Bundle id is 40
osgi> start 40
+
osgi> start 40  
 +
</pre>
  
6. Drive the WAR or web bundle using a web browser, e.g. [http://localhost:8080/simple-war http://localhost:8080/simple-war].
+
6. Drive the WAR or web bundle using a web browser, e.g. [http://localhost:8080/simple-war http://localhost:8080/simple-war] should display "Hello World!".
  
 
== Set as a Target Platform in PDE ==
 
== Set as a Target Platform in PDE ==

Revision as of 10:13, 27 October 2010

Gemini Web is a subproject of the Gemini project.

Gemini Web is a sister project of Virgo. Please refer to the Virgo wiki for salient information.

Trying out Gemini Web

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

2. Download Gemini Web and unzip it to ~/gemini-web-test/gemini-web.

3. 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 works 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, which come in the dep directory, are installed and then the Gemini Web 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 depend on that version.

4. Start Equinox as follows:

java -jar org.eclipse.osgi_3.6.0.v20100517.jar -console

5. 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. Refer to the documentation for more information.

osgi> install file:simple-war.war
Bundle id is 40
osgi> start 40 

6. Drive the WAR or web bundle using a web browser, e.g. http://localhost:8080/simple-war should display "Hello World!".

Set as a Target Platform in PDE

The following steps enable you to develop Web Application Bundles that compile against the libraries of the Gemini Web container by using the existing Plug-in Development Environment (PDE) tooling in Eclipse.

  1. Open Window > Preferences from the main menu in the Eclipse IDE.
  2. Navigate to the Plug-in Development > Target Platform preferences page.
  3. Click the Add... button.
  4. Choose Nothing: start with an empty target definition and click Next >
  5. Give a Name for the new target definition (like "Gemini Web").
  6. Make sure the Locations tab is the active one and click the Add... button.
  7. Choose Directory and press the Next > button.
  8. Browse to the ~/gemini-web-test folder and click the Finish button.
  9. Repeat steps 6-8 to add the ~/gemini-web-test/gemini-web and ~/gemini-web-test/gemini-web/dep folders to the target definition.
  10. Click the Finish button to close the New Target Definition wizard.
  11. Select the newly created target definition and click the OK button to activate it for you PDE environment.

Run as OSGi Framework from the Eclipse IDE

The following steps enable you to deploy and run the Web Application Bundles in your Eclipse workspace on the Gemini Web container.

OSGi Framework run configuration, Bundles tab
OSGi Framework run configuration, Arguments tab
OSGi Framework run configuration, Settings tab
  1. Make sure you have set the Gemini Web container as a target platform as described in the previous section.
  2. Open Run > Run Configurations... from the main menu of the Eclipse IDE.
  3. Navigate to the OSGi Framework category.
  4. Right-click > New.
  5. Give a Name for you run configuration (like "Gemini Web").
  6. Open the Bundles tab.
  7. Make sure all of the bundles under the Target Platform node are selected.
  8. Select the bundles from the Workspace you want to deploy in the Gemini Web container.
  9. Switch to the Arguments tab.
  10. Add the following system property to the VM arguments: -Dosgi.java.profile=file:configuration/java6-server.profile
  11. Select the Other radio button in the Working directory group and specify the path to the ~/gemini-web-test folder.
  12. Switch to the Settings tab.
  13. Deselect the Use default location check box in the Configuration Area group.
  14. Specify the path to the ~/gemini-web-test/configuration folder in the Location text field.
  15. Click the Run button.

You will see some logs dumped in the Console view. After a second the Gemini Web container is started and the Web Application Bundles from the workspace are deployed. You can now call you application from the browser using URLs like:

http://localhost:8080/<context-root>/...

The above steps are needed only for the first run of Gemini Web. Any subsequent runs can be executed much simpler:

  • Right-click your Web Application Bundle project and call Run As > OSGi Framework. That's all.

How to stop Gemini Web?

The safest way to stop Gemini Web is to type close in the Console view and hit Enter.

You need to stop any old instance of Gemini Web before starting it again. Otherwise, the new instance won't start correctly, because the old one still occupies the http port (and, perhaps, other system resources).

How to run in debug mode?

Running in debug mode is done simply by:

  • Right-click your Web Application Bundle project and call Debug As > OSGi Framework. That's all.

You will get all debug features (including hot code replace) from JDT and PDE for free.

Limitations

Gemini Web is a designed to be an application server component rather than a fully-functional application server. As such it has some limitations:

  • Some resources are not available by URL (see bug 325578). Virgo, for example, works around this by installing an Equinox hook to ensure that all resource URLs returned have a "file:" protocol and not a "bundleresource:" protocol which is the default returned by Equinox.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.