Tomcat Integration

The following is a guide for deploying ServiceMix on the Apache Tomcat application server.

The recommended software environment is:

Java Developer Kit (JDK) 1.4.x or greater.
The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g. c:\Program Files\jsdk.1.4.2-09.
Maven 1.0.2 or greater (required when installing source or developers' releases).
Apache Tomcat version 5.5

The following is the platform which has been tested:

Apache Tomcat must be downloaded and installed. For instructions please see the Tomcat web site.
By default Tomcat uses port 8080. Please note if your installation has Tomcat on another port, such as port 80.
Download and build the ServiceMix source code. Please see the Getting Started guide for instructions.
Note: ServiceMix must be BUILT as well as downloaded.
Create the WAR file:
```
cd [servicemix_install_dir]\tooling\servicemix-web
maven war
```
where servicemix_install_dir is the directory to which ServiceMix was downloaded.
To deploy the WAR file,servicemix-web.war, copy it to the Tomcat webapps directory. For example, in Windows:
```
cd [servicemix_install_dir]\tooling\servicemix-web\target
copy servicemix-web.war [tomcat_install_dir]\webapps
```
where tomcat_install_dir is the directory in which tomcat was installed.
Start Tomcat to deploy the ServiceMix WAR file.
If there are errors when Tomcat starts:
1. Stop Tomcat.
2. Install additional jar files in the deployed ServiceMix directory. > 1. tomcat_dir\webapps\servicemix-web\WEB-INF\lib - this worked

Run the ServiceMix JMX Console. To do this enter the following URL in a web browser: http://localhost:8080/servicemix-web