Page History

...

The following is the platform which has been testedwas used to produce this document:

• Windows XP
• Tomcat 5.5
• Java 5
  Note: the following procedure will work on Unix platforms as well with the appropriated substitutions, such as using backslash instead of forward slash.

Deploying ServiceMix on Tomcat

1. Apache Tomcat must be downloaded and installed. For instructions please see the Tomcat web site.
2. By default Tomcat uses port 8080. Please note if your installation has Tomcat on another port, such as port 80.
3. Download and build the ServiceMix source code. Please see the Getting Started guide for instructions.
   Note: ServiceMix must be BUILT as well as downloaded.
4. Create the WAR file:

   Code Block
   cd [servicemix_install_dir]\tooling\servicemix-web maven war

   where servicemix_install_dir is the directory in which ServiceMix was downloaded and installed.
5. To deploy the WAR file, servicemix-web.war, copy it to the Tomcat webapps directory. For example, in Windows:

   Code Block
   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.
   
6. Stop and start Tomcat to deploy the ServiceMix WAR file.
7. If there are errors when Tomcat starts:
   1. Stop Tomcat.
   2. Install additional jar files in the deployed ServiceMix directory. The missing jar files are: commons-collections-3.1.jar and commons-pool-1.2.jar. These can be obtained from:

      Code Block

      copy commons-collections-3.1.jar tomcat_install_dir\webapps\servicemix-web\WEB-INF\lib - this worked
      copy commons-pool-1.2.jar tomcat_install_dir\webapps\servicemix-web\WEB-INF\lib
      (code)
8. Run the ServiceMix JMX Console. To do this enter the following URL in a web browser: http://localhost:8080/servicemix-web