|Home > Documentation > Developing > Development environment > Defining Geronimo server runtimes and servers|
A Geronimo Server Runtime in GEP associates a Geronimo 2.2 Server installation with a JRE to be used to run that server. A Geronimo Server in GEP associates a Geronimo Server Runtime with a profile consisting of Security settings, Publish Settings, Port Configuration, JVM settings to be used with that Geronimo Server Runtime. This page discusses how to define Geronimo servers and server runtimes in Eclipse.
This page discusses how to define Geronimo servers and server runtimes in Eclipse.
Before defining a Geronimo server runtime, you have to install a Geronimo Eclipse Plugin.
In order to define a new Geronimo Server v2.2 Runtime, follow the steps below:
Additional Server Runtimes to use a different Geronimo server installation or a different JRE can be added in a similar manner.
Follow the steps below to define a new Geronimo v2.2 Server:
Additional Server Runtimes can be installed by clicking on Configure runtime environments... button and return to this step once done to select the newly added server runtime. Or you can add another Geronimo 2.2 runtime environment by clicking "Add...".
This completes defining a new Geronimo 2.2 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.
A Geronimo Server can also be defined while creating a Geronimo Server Runtime by checking the option Create a new local server. This will present an additional dialog to configure the hostname, ports, etc.
To view the server status in the Java EE perspective, open the Servers view. GEP monitors the server's status and sets the stopped, starting, and started indicators appropriately. This information is accurate even if you do not start or stop the server using Eclipse.
Use this procedure to start a server using the Eclipse framework.
Note that you can start the server in debug or profiling mode if you installed Test and Performance Tools Platform (TPTP) eclipse plugin.
Use this procedure to stop a server using the Eclipse framework.
Use this procedure to launch the server's administrative console in Eclipse.
Note: The server must be started for this option to be available and for it to work.
Use this procedure to launch the server's support page in Eclipse.
Use this procedure to start a server in debug mode using the Eclipse framework.
Starting from Geronimo 2.2, you can customize server assemblies with GEP in Eclipse. See Assembling a server using GEP for more details about creating server assemblies using GEP.
You can deploy or test your assets using GEP. See Deploying and debugging applications using GEP for more information about how to deploy or test applications in Eclipse.
Once Geronimo Server Runtimes are defined, Eclipse provides these runtime for selecting as a target runtime while creating an EJB, Web and Java EE projects. Notice the Target Runtime field in the Dynamic Web Project dialog shown in the figure below.
Upon adding the Geronimo 2.2 server runtime as the target runtime, the Geronimo server libraries and Java EE specification libraries get automatically added to the build path of the project. GEP will also create Geronimo specific deployment plans.
In order to run an application on Geronimo, follow the steps below:
The application can also be run on Geronimo by adding the project to the Geronimo server explicitly as given below: