Deploying applications in Eclipse
The Geronimo Eclipse Plugin is a tool for deploying and testing applications to a Geronimo server. Define a new server and server runtime, before attempting to deploy your applications.
When you create or import your Java EE project in the Eclipse Integrated Development Environment (IDE), specify the Geronimo server runtime you defined previously as the target runtime. This action adds the server's class libraries to your project's build path.
If you deploy your assets using Eclipse, it is recommended that you also undeploy and redeploy your applications using Eclipse. For example, if you deploy your application in Eclipse and then undeploy the application using the administrative console or the deploy command, Eclipse will not detect the change and the view will show that the asset is still deployed. If this happens to you, you can correct the view by removing the applications that have been published to the server but undeployed outside of the Eclipse framework.
Use this procedure to deploy applications to a local server.
- In the Java EE perspective, select the Project view and right click the Java EE project you want to deploy. Select Run As, Run on server
- On the Run on server panel, if you have an existing server, keep the Choose an existing server option and select the server. If you don't have a Geroimo server defined, select the Manually define a new server option and select the server.
- Click Finish. The Geronimo Eclipse Plugin will deploy the applications shortly. If the server is not started, the Geronimo Eclipse Plugin will start the server and deploy the Java EE applications when the server has initialized.
Removing an asset that has been published to the server
Once an asset has been published to the server, you must use the tool's Add/Remove projects option if you want to remove it from the server. If you simply remove the asset without removing its project, the asset will remain deployed on the server.
- In the Java EE perspective, the select the Server view.
- On the Server panel, right click on the server where the asset was deployed.
- On the resulting context menu, click Add/Remove Projects.
- On the selection panel, click on the asset to undeploy and click the <Remove button to move it from the right to the left list. Click Finish.
You can use the same steps discussed above to deploy a Java EE asset to a remote server, but there are additional considerations.
- To define a remote server, you must first define a local server and then change the value of its hostname attribute to the name of the remote server's host. This is required because the Eclipse framework must use the class libraries from the local server.
- You cannot use Eclipse to start, stop, or restart the remote server. You cannot use Eclipse to start the remote server in debug mode. Often, this limitation makes it more convenient to develop and debug your Java EE assets using a local server and then switch to a remote server when you need a common server to integrate your assets with assets from other developers.
- Make sure you can successfully use your system's ping command with the target system's unqualified host name. If the command is successful, the network can successfully resolve the unqualified name and remote deployment should work .
- If there is a firewall between your system and the target server, it must be configured to permit both HTTP and RMI requests to flow between your system and the server's host. When the server is installed, the initial HTTP port is 8080 and the initial RMI port is 1099. If the target server has been configured to use different ports, the firewall must be configured to use those ports instead.
- The remote server must be running when you invoke the deploy command. When you deploy or refresh your Java EE asset, the files will be copied across the network, saved as temporary files, and then deployed.