Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In this section we discuss how to use the Geronimo Eclipse Plugin to convert Applications into Geronimo Plugins and install them to the server.
We are using Apache Geronimo V2.1.3 for this tutorial.
We have used an existing tutorial from tutorial section. Refer Stateless Session Bean for application development and deployment. Once done refer the illustration in this tutorial to export and import JEE artifacts using the Geronimo Eclipse Plugin.

Creating Geronimo Plugins

In order to convert applications into Geronimo Plugins, the Geronimo Server must be installed and started. Clicking on the server's "Launch Plugin Manager" popup menu item will bring up the Plugin Manager wizard that is shown below.



Enter or create a directory and select the "create Geronimo plugin" radio button. The directory is a temporary place to save the application and will give you a chance to make any manual updates if necessary.

Image Added

The next page of the dialog contains a drop down list of all the objects that can be converted into Geronimo plugins. Many of the objects in this list are already plugins that are used by the Geronimo server.

Image Added

Selecting your application objects (one at a time) and clicking next will bring up pages that will allow you to change the geronimo-plugin.xml before saving. All fields on the next two pages are data that will be saved with the plugin and will help with installation.



...

The next page has 2 tables. The data in both the License table and Prerequisite table can be updated using the Add, Edit, and Remove buttons.

Image Added

  • Licenses
    The name of the license that this plugin is covered by. Ideally, it would be prefixed by the class of license, like "BSD – (name)" or "GPL – (name)". Specify whether the license is an OSI-approved open source license (see http://www.opensource.org/licenses/index.php).
  • Prerequisites
    The module IDs of prerequisites for this plugin. These are modules that must be present in the server before the plugin can be installed. They may be something like a specific web container for a web application (geronimo/jetty/1.0/car) or something like a database pool or security realm that the user must install because the plugin author can't create a value that will be valid in the destination server. You may want to leave out as many segments of the module ID as possible in order to accommodate more users.
    No Format
    (e.g. */mypool/*/* rather than myapp/mypool/1.2/car)

...

If you haven't done so already, remove the projects from the server.

Image Added

From the main page of the Plugin Manager wizard, select "install Geronimo plugins" and click Next.



Select all the Geronimo plugins that you want to install on the server. If Installable is false, then the plugin cannot be selected. The most common reasons that a plugin cannot be installed are if the version of the plugin is already installed on the server or if prerequisites are not available. Clicking next will install all selected plugins.