Page History

...

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.
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.
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.
6. In the Search Results, expand Geronimo Eclipse Update Site and Geronimo WTP Server Adapters.
7. Select Geronimo Core Feature 2.1.0 and Geronimo v2.1 Server Adapter 2.1.0 and click Next.
8. Read and accept any license agreements and click Next.
9. Click Finish to download the selected features.
10. Click Install All.
11. Click Finish to complete the installation.
12. Click Yes to restart Eclipse for the changes to take effect.

...

1. Launch the Define a New Server dialog using one of the following:
   • From the Servers view in the Java EE Perspective: right click, and select New, and Server.
   • From any Perspective: Select File, New, Other, Server.
2. Select Apache Geronimo v2.1 Server and click Next.
3. Select a 5.0 JRE (click Installed JREs to add any new JREs and return to this dialog once done).
4. If you already have Geronimo v2.1 installation that you want to use with GEP, enter the directory name or browse to <geronimo_home> and click Next. Skip the next three steps and go to selecting source archive.
5. Enter a directory for Application Server Installation Directory, under Download Options select the Web container and click Download and Install.

   Note
   title Important
   The directory specified for Application Server Installation Directory must exist in order to select Download Options.

6. Click OK for Install Confirmation. This will install the selected Geronimo v2.1 server and fill the Application Server Installation Directory field accordingly.
7. Click Next.
8. 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.
9. 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.

This completes defining a new Geronimo 2.1 Server runtime. 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.

...

1. Select File, Import to launch the Select dialog.
2. Based on your application type, select as given below:
   • For Web application, Select Web, WAR file.
   • For EAR application, Select J2EE, EAR file.
   • For EJB application, Select EJB, EJB JAR file.
3. Click Next.

   Note
   Remaining steps are based on a web application.

4. Type the name of the WAR file or select the WAR file by clicking on Browse, enter/edit the Project Name and select Apache Geronimo v2.1 Runtime as Target Runtime.
5. Click Finish to complete the import.

The imported application can be viewed in the Project Explorer view. The GEP will create a Geronimo specific deployment plan, in this case geronimo-web.xml under WebContent/WEB-INF, if one is not already present in the archive. You may need to edit the deployment plan to map any resources used by your application.

...

To deploy the application on Geronimo, follow the steps below:

1. In the Servers view, Right-right click on Apache Geronimo v2.1 Server at localhost and select Add and Remove Projects.
2. In the Add and Remove Projects dialog, select the project under Available projects and click on Add button. The project will now be listed under Configured projects.
3. Click Finish.

...

In order to run the application follow the steps below:

1. In the Project Explorer view, Right-right click on the project, select Run As, Run on server.
2. Select Choose an existing server and select Apache Geronimo v2.1 server at localhost.
3. Click Finish.

...