Create new JBoss Tools Documentation Jira issue

This will launch the Jboss Tools Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.orgCommunity Documentation

Chapter 5. Deploying Modules

5.1. Deploying on the Package Explorer
5.1.1. Deploying with Run On Server Wizard
5.1.2. Deploying single files
5.2. Deploying with Servers View
5.2.1. Top part of Servers view
5.2.2. Bottom part of Servers view
5.3. Deploying with Project Archives View

In this chapter it will be described how to deploy modules onto the server.

First of all it is necessary to say that deploying to a server is mostly painless. There are several ways to do it provided by WTP, and some additional methods provided by JBoss Tools. These methods are described further in this chapter.

On the package explorer it is possible to publish either a project to a server or just a single file. Let's look at how to do this.

As it has been already mentioned Servers view contains two parts: the top part that displays all defined servers and the bottom part which provides categories with additional information. Thus, in this section we suggest two more ways to deploy resources onto the server.

In the top part of the Servers view you should right click on a server and select the Add and Remove menu item.


This will bring up a familiar dialog allowing you to either publish projects or modules to a server, or remove them from the server. If the selected module is a project like a Dynamic Web project, EJB project, or EAR project, it will be published as through Run on Server wizard, with a best-guess full package. If, however, the selected element is an archive from the Project Archives view, it will be published according to the rules of that module type.

In the Project Archives View you can right-click on any declared archive and select the Publish To Server element. For more on this subject, see Publishing to Server in the Project Archives View section.


The only way to ensure an Incremental Build , such as changes to one .jsp, .html, or .class file, is to enable the builder for that project. This is done by either changing the global preferences for the Archives View, or by enabling project-specific preferences and ensuring the builder is on.

You can also use the "Finger touch" button for a quick restart of the project without restarting the server:


The "Finger" touches descriptors dependent on project (i.e. web.xml for WAR, application.xml for EAR, jboss-esb.xml in ESB projects).

The last chapter covers a variety of methods on how you can deploy needed modules onto a server.