Publishing a project on a J2EE server

You can publish (deploy) a created project on the J2EE server. If the server on which the project is to be published exists on a local host, the project will be published in the exploded archive format. If the server on which the project is to be published exists on a remote host, the project will be published in the archive format.

To publish a project on the J2EE server:

In the Server view, select the server on which the project is to be published. In the context menu, choose Add and Remove.
The Add and Remove dialog box appears.
Select the project to be added from Available, and then click the Add button.
The added project appears in Configured.
Click the Finish button.
The added project appears in the Server view. If the J2EE server is running, the project is automatically published (step 4 is not required).
If the J2EE server is not running, select a destination server from the Server view, and then choose Publish in the context menu.
The status of the published project appears in the Status column of the Server view.

Reference note

If you execute the operations in step 4, you can replace or reload the projects that are already published.

You can also apply changes in projects such as correction of source code in J2EE applications.

Organization of this section: (1) Notes on publishing a project on a J2EE server

Note the following points when you want to publish a project on a J2EE server:

Enterprise application projects displayed in the Add and Remove dialog box must include at least one dynamic Web project or EJB project.
When individually publishing a dynamic Web project and an EJB project, the WTP connector creates a pseudo-application structure. The application directory or EAR file is named after the project name.
If you change the project dependencies, configuration, or the deployment descriptor (application.xml), execute Clean instead of Publish to correctly apply the changes.
When adding a project, if a J2EE application with the same name exists on the J2EE server, you cannot publish the project successfully.
In such cases, delete the J2EE application by using the management portal or server management commands, or change the J2EE application name.
If you publish a project while an application is suspended at a breakpoint, timeout will occur and the project might not be published successfully.
During the publishing process, do not exit Eclipse or perform operations such as Close Project as an error might occur.
If you are editing the Server Overview page, save the edited contents before publishing the contents. If the contents are published while you are still editing them, close the server editor once.
If an error occurs during the publishing of a project, Administration Agent might be terminated by java.lang.OutOfMemoryError. In such a case, change the maximum size of the Java heap for Administration Agent and then execute the operation. Note that the changed value is approximately five times the application file size.

6.7 Publishing a project on a J2EE server

(1) Notes on publishing a project on a J2EE server