You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Next »

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.

  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:
    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:
    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. When Tomcat starts, if there are errors indicating missing classes perform the followng steps:
    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 by using a search engine and searching for them. Or they can found in your personal Maven repository directory, which is usually located in your_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 
      
    3. Start Tomcat.
      The Tomcat console output should show ServiceMix starting.

Testing the ServiceMix Deployment on Tomcat

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