Tomcat Integration
The following guide explains how to deploy ServiceMix on the Apache Tomcat application server.
Pre-Installation Requirements
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\Java\jdk1.5.xx
. - 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 produce this document:
- Windows XP
- Tomcat 5.5
- Java 5
Deploying ServiceMix on Tomcat
Execute the following steps to deploy ServiceMix on Apache Tomcat. Note: this procedure will work on Unix platforms as well as the Windows platform, with the appropriate substitutions, such as using the backslash instead of forward slash.
- 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:
where
cd [servicemix_install_dir]\tooling\servicemix-web maven war
servicemix_install_dir
is the directory in which ServiceMix was downloaded and installed. - 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. - Stop and start Tomcat to deploy the ServiceMix WAR file.
- When Tomcat starts, if there are errors indicating missing classes perform the followng steps:
- Stop Tomcat.
- Install additional jar files in the deployed ServiceMix directory. The missing jar files are:
commons-collections-3.1.jar
andcommons-pool-1.2.jar
. These can be obtained by using a search engine and searching for them. Or they can found in your personal Maven repository directory, which is usually located inyour_home_dir\.maven\repository
. Specifically, {{your_home_dir\.maven\repository\commons-collections\jars and {{your_home_dir\.maven\repository\commons-pool\jars.copy commons-collections-3.1.jar [tomcat_install_dir]\webapps\servicemix-web\WEB-INF\lib copy commons-pool-1.2.jar [tomcat_install_dir]\webapps\servicemix-web\WEB-INF\lib
- Start Tomcat.
The Tomcat console output should show ServiceMix starting.
Testing the ServiceMix Deployment on Tomcat
- Run the ServiceMix JMX Console. To do this enter the following URL in a web browser: http://localhost:8080/servicemix-web