You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

This page introduces how to customize a server with plugins from the existing one to meet requirements of your application.

Assembling a server from an existing server.

Just as with installing plugins, this can be done from the admin console, gshell, and the Geronimo Eclipse Plugin. In the admin console you specify the groupId and artifactId of the server you want, the version, the target path and the archive type and then select the plugins you want installed. The server will be assembled in var/temp by default.

Similarly you can use the gshell deploy/assemble command specifying the same information on the command line interactively.

Important Note

In order to get a working server you must include the framework plugin group (org.apache.geronimo.plugingroups/framework/version/car) which includes several files used to start the server

TODO: The groupId is not currently used but the intention is to copy the assembled server into an appropriate maven repository.

Here's an example of a gshell script to install the roller plugin into the framework assembly and extract a server that only supports roller (and does not include the admin console or any deployment capabilities)

TODO: use something like this: snippet:url=geronimo/plugins/roller/trunk/roller-jetty-commands

TODO: get gshell to accept line continuations as in the following (these DO NOT WORK IN REAL LIFE):

# assembles a server containing roller-jetty from the geronimo-framework server.
# run using ./bin/gsh < roller-jetty-commands
deploy/list-plugins -u system -w manager -r file:/Users/david/.m2/repository/\
 org.apache.geronimo.plugins/roller-jetty/0.0.2-SNAPSHOT/car\
 org.apache.geronimo.plugins/roller-themes/0.0.2-SNAPSHOT/car

deploy/assemble -g org.apache.geronimo.assemblies -a geronimo-roller-jetty -v 1.0-SNAPSHOT\
 org.apache.geronimo.assemblies/geronimo-boilerplate-minimal/2.1-SNAPSHOT/jar\
 org.apache.geronimo.plugins/roller-jetty/0.0.2-SNAPSHOT/car\
 org.apache.geronimo.plugins/roller-themes/0.0.2-SNAPSHOT/car

The use of the GEP to assemble a custom server is very similar to the other methods. While the Geronimo server is running, use the server's popup menu to launch the Custom Server Assembly dialog. Specify the artifact name, group, version, archive type, path (relative to the running server), and plugins that you want installed. Once again, remember that the framework plugin group must be included to get a working server.

  • No labels