...

Administering the server

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.

Starting the server

Use this procedure to start a server using the Eclipse framework.

1. In the Java EE perspective, open the Servers view.
2. On the Server panel, right click on the server to be started.
3. On the resulting context menu, click Start.

Stopping the server

Use this procedure to stop a server using the Eclipse framework.

1. In the Java EE perspective, open the Servers view.
2. On the Server panel, right click on the server to be stopped.
3. On the resulting context menu, click Stop.

Launching the administrative console

Use this procedure to launch the server's administrative console in Eclipse.

1. In the Java EE perspective, open the Servers view.
2. On the Server panel, right click on the server to be managed.
3. On the resulting context menu, click Launch WASCE Console.

Note: The server must be started for this option to be available and for it to work.

Launching the support

Use this procedure to launch the server's support page in Eclipse.

1. In the Java EE perspective, open the Servers view.
2. On the Server panel, right click on the server to be managed.
3. On the resulting context menu, click Launch WASCE Support.

Debugging the server

Use this procedure to start a server in debug mode using the Eclipse framework.

1. In the Java EE perspective, open the Servers view.
2. On the Server panel, right click on the server to be started.
3. On the resulting context menu, click Debug.

Debugging a remote application on an already running server

Before debugging the remote application on a running server, you have to start the server under jdpa debugger using geronimo.sh/bat:

geronimo jpda run

or

geronimo jpda start

Use this procedure to attach a remote application (a WAR file in this example) to an already running server started in debug mode.

1. On the Eclipse menu bar, click File and Import. On the Import panel, expand Web, select WAR file and click Next.
2. Specify the WAR file directory, and the target runtime. Click Next.
3. Import Web libraries if needed. Click Finish.
4. Left-click the down arrow following the debug icon on the main tool bar, and select Debug Configurations....
5. Select Remote Java Application, and click the 'New' button to create a new debug configuration.
6. Fill in the information about the server:
   • Name: as desired
   • Project: the WAR file you want to bebug on the server
   • Host: the server's hostname
   • Port: 5005 (or the appropriate value if the server's debug port has been changed.)
7. Click Debug.

Creating a new project

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.

...