Page History

...

1. Launch Eclipse by running <eclipse_home>/eclipse.
2. Launch the Define a New Server dialog using one of the following:
   • From the Servers view in the Java EE Perspective: Right-click, New, Server.
   • From any Perspective: Select File, New, Other, Server
     
     Image Modified
     
     
3. Click on the Download additional server adapters link.
   
   Image Modified
   
   
4. In the Install New Server Adapter dialog, select Geronimo v2.1 Server Adapter and click Next.
5. Read and accept any License Agreements and click Finish. Click OK to continue installation.

This will download and install the GEP. The Progress view will display the installation status. Once the installation is completed, restart Eclipse. Define a New Server dialog will now show an Apache Geronimo v2.1 Server option under Apache.

Image Modified

#2. Install GEP Using Eclipse Update Manager

...

1. Launch Eclipse by running <eclipse_home>/eclipse.
2. Open the Eclipse Update Manager as follows:
   • Select Help, Software Updates, Find and Install.
   • Select Search for new features to install and click Next.
     
     Image Modified
     
     
3. Create a Eclipse Remote Update Site as follows:
   • Click the New Remote Site... button.
   • Type Geronimo Eclipse Update Site (or other suitable unique name) in the Name field.
   • Type the URL of the Geronimo Eclipse Update site http://www.apache.org/dist/geronimo/eclipse/updates/ in the URL field.
   • Click OK.
     
     Image Modified
     
     
4. Select only the Geronimo Eclipse Update Site in the Sites to include in search selection box and click Finish.
5. Select a mirror and click OK if prompted to do so.

...

1. Launch eclipse by running <eclipse_home>/eclipse.
2. Launch the Define a New Server dialog using one of the following:
   • From the Servers view in the Java EE Perspective: Right-click, New, Server.
   • From any Perspective: Select File, New, Other, Server.
     
     Image Modified
     
     
3. Select Apache Geronimo v2.1 Server and click Next.
   
   Image Modified
   
   
4. Select Workbench default JRE (click Installed JREs to add any new JREs and return to this dialog once done), enter the directory name or browse to <geronimo_home> and click Next. (Note: Download options part of this dialog does not work currently.)
   
   Image Modified
   
   
5. Select the location of the archive containing Geronimo source and click Next. This is required only if you intend to debug into Geronimo source code.
6. Modify Hostname, Administrator Id, Administrator password, Web Connector port and RMI Naming port if necessary and click Finish. Normally you will not need to change the default values for these fields for a newly installed Geronimo 2.1 server.
   
   Image Modified
   
   

This completes defining a new Geronimo 2.1 Server runtime and server. The newly added server will appear in the Servers view. The server can be started by selecting the server and clicking on the Start server button.

Image Modified

Additional servers using the same Geronimo 2.1 installation can be defined in a similar manner. If you intend to define additional servers that use a different Geronimo 2.1 installation, you will need to create a new Server runtime as given below:

1. Launch the Installed Server Runtime Environments dialog using one of the following:
   • In Define a New Server dialog, click on Installed Runtimes... button.
   • Click Window, Preferences, Server, Installed Runtimes.
     
     Image Modified
     
     
2. Click Add to launch New Server Runtime dialog.
3. Select Apache Geronimo v2.1 Runtime, check Also create new local server and click Next.
   
   Image Modified
   
   
4. Select a 5.0 JRE, enter the directory name or browse to the directory where Geronimo 2.1 server is installed and click Next.
   
   Image Modified
   
   
5. Select the location of the archive containing Geronimo source and click Next. This is required only if you intend to debug into Geronimo source code.
6. Modify Hostname, Administrator Id, Administrator password, Web Connector port and RMI Naming port if necessary.
   
   Image Modified
   
   
7. Click Finish to return to Installed Server Runtime Environments dialog.

...

1. Click File, New, Project to launch the New Project dialog.
2. Select Dynamic Web Project and click Next.
   
   Image Modified
   
   
3. Enter mywebapp for project name, select Apache Geronimo v2.1 Runtime for Target Runtime, select Default Configuration for Apache Geronimo v2.1 Runtime and click Finish.
   
   Image Modified
   
   
4. In the Project Explorer view, Right click on mywebapp and select New, JSP.
5. Enter index.jsp for File name and click Finish.
6. Change the content of index.jsp to the following:

   Code Block
   html html borderStyle solid title index.jsp
   <%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>My WebApp</title> </head> <body> <h1>Welcome to My WebApp</h1> </body> </html>

7. Right-click on mywebapp and select Run As, Run on Server.
8. Click Choose and existing server, select Apache Geronimo v2.1 Server at localhost and click Finish.

...

In order to edit the configuration of a server, double click on server in the Servers view to open the overview of the server as shown below.

Image Modified

• Security Credentials
  The default User ID is system with a password manager. If your server installation uses a different set of credentials, change these accordingly.
• Automatic Publishing
  All servers use the default publishing settings. The server can be configured to not publish automatically by selecting the Never publish automatically option. The default publish setting can be overridden by selecting the Override default settings option and providing a new Publish interval.
• Port Configuration
  The default HTTP and RMI ports are 8080 and 1099 respectively. If your server installation uses a different HTTP and/or RMI port, edit these values accordingly.
• Console Output
  The default server console output log level is INFO. If you want to enable debug output to console, select DEBUG.
• Server Startup
  The settings under this section control the ping thread that polls to the server while the server is starting up. (Need to figure the exact use of these setting)
• Server VM Arguments
  Any additional arguments to be passed on to the server VM can be specified here.

...