Tomcat Integration
This document is a guide for deploying ServiceMix on Apache Tomcat.
Pre-Installation Requirements
The following software environment is recommended to deploy ServiceMix on the Tomcat application server.
Environment:
- 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 was used to write this document:
- Windows XP
- Tomcat 5.5
- Java 5
Deploying ServiceMix on Tomcat
- Apache Tomcat must be downloaded and installed. For instructions please see: url
- 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:
where
cd [servicemix_install_dir]\tooling\servicemix-web maven war
servicemix_install_dir
is the directory to which ServiceMix was downloaded. - To deploy the WAR file,
servicemix-web.war
, copy it to the Tomcatwebapps
directory. For example, in Windows:wherecd [servicemix_install_dir]\tooling\servicemix-web\target copy servicemix-web.war [tomcat_install_dir]\webapps
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:
- Stop Tomcat.
- 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