Title: Deploying An Application To TomEE Or OpenEJB

# Deploying An Application To TomEE Or OpenEJB
## How to deploy my application under TomEE
### Description

This aims to be more dynamic in the way you deploy your applications.
It is clearly cloud oriented.

### Webapp and TomEE deployment

Webapp can be deployed as Tomcat does. Simply put it in webapps folder
(or the one you configured) and start TomEE.

### TomEE specific deployment

By default TomEE deploys applications (ear, war, jar) contained in $CATALINA_BASE/apps
directory at start up.

### Deployer

OpenEJB provides a Deployer EJB to do this task. It can be used
in your own software looking up remotely the "openejb/DeployerBusinessRemote" EJB.
Its interface is "org.apache.openejb.assembler.Deployer".
The needed dependency is org.apache.openejb:openejb-core.

Once you got your deployer simply invoke the "deploy" method. Give it the location
of your application (can be a file, http, https, maven location depending on
the way you configured your container, for more information
have a look to TomEE provisionning).

Note: the "undeploy" method exists too and take the same path.

The Deployer is the base of all other solutions

### Maven plugin

[org.apache.openejb:tomee-maven-plugin](maven/index.html) can be used to deploy/undeploy your application. Once this plugin is added to your pom you have access to the following configuration:

* tomeeHttpPort
* tomeeHost

Then simply run

    mvn tomee:deploy <path>

or

    mvn tomee:undeploy <path>

#### The Deployer through TomEE Webapp

When you start TomEE you can locally access the TomEE webapps (http://host:ip/tomee/).

Then simply go to JNDI tree, select the deployer in the tree, then click on "invoke this ejb",
select the deploy (or undeploy) method, fill the path and click on "invoke".

#### Cloud idea

If you want to cloudify your application, you'll get a configuration database (or any
other storage system ;)).

So it means it is easy for you to get a host and a port...so it is easy
to deploy on all your server using the deployer: simply use the maven provisioning
then run the deployer on all your nodes and that's all!


### Doing it with camel?

If you are using a route to deploy/undeploy your applications
you can have a look to the proposed camel-openejb component:

* base code: http://svn.apache.org/repos/asf/tomee/sandbox/camel/camel-openejb/
* proposed to be added to camel: https://issues.apache.org/jira/browse/CAMEL-4935