Deployer's Guide

Target audience

The target audience for this guide is the deployer. The deployer is responsible for the deployment of J2EE modules like Enterprise Beans and their containers, web components and Ear applications in the application server.

The content of this guide is the following:

  1. Deployment process description
  2. Example deploying an EJB using ejb-jar file
  3. Example deploying a WAR file
  4. Example deploying an EAR file

Deployment process description

The deployment process consists of two types of deployment :

Deployment descriptors are written in XML, the deployer must use its favorite XML editor for editing it.

Example deploying an EJB using ejb-jar file

Suppose that we want to customize the deployment of the AccountImpl bean in the JOnAS example examples/src/eb.
The customization wanted will be to change the name of the database table used for the persistence of the AccountImpl.

We have described step by step all the work to do to build the ejb-jar.jar file in order to explain all the process.

In fact in the $JONAS_ROOT/examples/src/eb directory there is a script compile.sh for unix or compile.bat for Windows that you can use.

If the GNU make is installed on your machine you can use the Makefile file you find in this directory.
You only have to type make install and all the process to build the ejb-jar.jar file and install it in the $JONAS_ROOT/ejbjars directory will be made.
In your real application you will have the choice to write your own script that will looks like the compile.sh or compile.bat, or to write a Makefile file that use the common makefile rules that are provided in the JOnAS distribution.
It is quite easy to understand how to change the Makefile file for your own purpose:

If the jakarta ANT tool is installed on your machine you can use the ant install command in the $JONAS_ROOT/examples/src. It will build all ejbjars examples and copy them into the $JONAS_ROOT/ejbjars directory.

Example deploying a WAR file

Before deploying a war file in the JOnAS application server, you must first package the war file. To do this process follow the WAR packaging guide.

When you have packaged your war file, follow these steps :

Example deploying an EAR file

Before deploying an ear file in the JOnAS application server, you must first package the ear file. To do this process follow the EAR packaging guide.

When you have packaged your ear file, follow these steps :