Creating and using a custom server assembly

In this section we discuss how to use the Geronimo Eclipse Plugin to create and use a custom server assembly.

Creating a custom server assembly

In order to create a custom server assembly, you must already have a Geronimo Server installed and started. Double clicking the Geronimo server will bring up the Server Editor in the main window. Items for working with the server can be found on the Plugin page. Clicking Right clicking on the Create server and selecting Launch Custom Server Assembly button will bring up the New Server Custom Assembly dialog that is shown below.



Enter in the pertinent information and select all the plugins that you desire to have in the new server. Press Ctrl key to select multiple plugins. Geronimo Assembly :: Boilerplate or Geronimo Plugin Group :: Framework MUST be selected in order to create a working server. The working server will be placed in the specified directory. A tar ball or zip file will also be placed in the var/temp directory of the running server for easy distribution.

Using a custom server assembly

Now that we have created the custom server assembly above, it is time to use it. Stop the original server and uninstall it (easiest done by using the Windows Preferences dialog via the Server Runtime Environments pageselecting Windows->Preferences->Server, and removing the server runtime environment. See Defining Geronimo server runtimes and servers page for the detail). Use the same method that you used to install the original server with one small difference. This time, point to the directory where the newly created server is.



In place of the full Geronimo server that you started with, you should now have a valid custom Geronimo Server.