HomeDocumentation > Developer's guide > Apache Geronimo Development Tools Project > How to Use Geronimo Eclipse Plugin
{scrollbar}

Here we will illustrate the various useful functionalities of GEP. This will include adding server runtime, adding Java runtime, start, stop, deploy, redeploy, undeploy and other functionalities.

Adding Target Server and Java Runtime in Eclipse

  1. Launch Eclipse. By default JEE perspective will be launched. Select Server tab. Right Click and Select New->Server.





  2. On the next screen select Apache->Apache Geronimo V2.1 Server. In case you do not see geronimo in the list follow the steps mentioned in How to install Geronimo Eclipse Plugin v2.1.2.





  3. On the next screen select Installed JRE's to install a new Java Runtime Environment.





  4. This will launch the installed JRE's window where all the installed JRE's can be seen. You can currently see only one installed JRE. Select Add.





  5. On the Add JRE window select Standard VM. Select Next.





  6. On the next window Browse to your root directory of Installed JRE.





  7. Once done you can see JRE home and JRE name field populated. Select Finish.





  8. Check the box to select newly added JRE. Select Ok.





  9. On the New Server window select the drop down box and select the newly added JRE.





    However for the current illustration we will stick to Java 6.
  10. Next Browse to the root folder of your Geronimo Server Installation. In case you do not have a server installed select the link as shown in the figure to download geornimo.





  11. Select Next once you have specified all the artifacts.





  12. Keep the default values for next 2 windows and select Next. Select Finish. This will create a geronimo server under Server tab.





    This completes the ilustration for adding a server

Start and Stop Server

  1. Right Click on the geronimo server instance and Select Start.





  2. Server will be started and you can see the status changed to Started.





  3. To stop the server Right Click on the server instance and Select Stop.





    Deploy Run Undeploy and Redeploy an Application

    To illustrate these functionalities we will add a simple web project and later work with it to deploy/run/undeploy/redploy application.
  4. Right Click under Project Explorer and Select New->Dynamic Web Project.





  5. Name the project as Hello World. Select Next.





  6. Keep the defaults on the next window. Select Next.





  7. On the Geronimo Deployment Plan window name the Artifact Id as Hello. Select Finish. This will add a web project.





  8. Expand the project and Right Click on Web Content. Select New->JSP. Name the jsp as index.jsp and Select Next.





  9. On the next window select Finish.





  10. In index.jsp add the title as Hello World and in the body add This is my first application on G/GEP. Save the changes.





  11. Now you are all set to run your first application on Geronimo. Right Click on your project and select Run->Run on Server.





  12. On the next screen select Apache Geronimo and Select Next.





  13. You can see Hello World as one of the configured projects. Select Finish. This will DEPLOY your application on Geronimo server.





  14. Launch a web browser as shown in the figure.





  15. Run the url http://localhost:8080/Hello World. This sill RUN your application.



  16. Next modify index.jsp and append Hello World! in the body.





  17. Once you save the changes you can see Geronimo server state changing to Republish. It may take a moment till your application is REDEPLOYED.





  18. Refresh the browser to verify if the changes you made are reflected.





  19. To UNDEPLOY the application from server. Right Click on geronimo server instance and select Add and Remove Projects.





  20. On the next screen select Hello World project and select Finish. This will UNDEPLOY the project from geronimo.





Launching Geronimo Console and Support

You can also launch Geronimo Console from Eclipse.

  1. Select your preferences to launch the geronimo console as suggested in the figure. Accordingly geronimo administrative console will be launched in Eclipse Internal browser or an external browser.





  2. Right click on geronimo server instance and Select Launch Geronimo Console to launch geronimo administrative console.



  3. Similarly select Geronimo Support. This will launch Apache Geronimo website.

Other function

  1. Double click on geronimo server instance. This will launch the settings for your added geronimo server instance.





Where to go from here??? There are good number of tutorials through which you can play more with Eclipse and GEP. Check out the following

  1. tutorials. These tutorials illustrate step by step development of applications based on all the Java EE5 API's.