Page History

...

The following guide explains how to deploy ServiceMix 1.1 and ServiceMix 2.0 on the Apache Tomcat application server. For ServiceMix 2.0.1 and later releases, please refer to the Tomcat Integration document.

Pre-Installation Requirements

...

1. Check the Tomcat console output or the Tomcat log files (see above) and look for servicemix-web starting without any errors.
2. ServiceMix's default port is 1099. From another window run netstat and search for port 1099.
   From a Windows console, type:

   Code Block
   netstat -an|find "1099"

   
   OR
   
   From a Unix command shell, type:

   Code Block
   netstat -an|grep 1099

   
   
3. Run the ServiceMix JMX Console. To do this enter the following URL in a web browser: http://localhost:8080/servicemix-web^{Image Removed}. Note: your installation of Tomcat may not be running on port 8080. If that is the case, replace 8080 with the correct port number in the previous URL.
   Try using the JMX console. For example, perform the following steps. Note: this is optional.
   1. Click on "Catalina".
   2. Click on "Unknown".
   3. Click on the "JMXServlet WebModule" to get monitoring information about the JMX Servlet itself:
      
      
      
      
4. An http binding example is supplied. To run it on ServiceMix 1.1 do the following steps. To run it on ServiceMix 2.0 go to #2.0 steps.
   1. From a browser, enter the following URL: http://localhost:8080/servicemix-web/examples^{Image Removed}. Note: if Tomcat is using a different port, such as port 80, substitute the correct port number for 8080 in the URL.
      
      
      
      
   2. Click on the "perform a GET" link. If an HTTP 404 error occurs, go to the next step. If there is no error you will see:
      
      
      
      
   3. If there was an HTTP 404 error, the index.html file needs to be modified. The index.html file is located in the tomcat_install_dir\webapps\servicemix-web\examples directory. After editing the file, return to step 1.

      Code Block
      Change this line: <li><a href="/jbi/exampleUri?x=123&name=James&location=London">perform a GET</a> into the HTTP binding</li> to <li><a href="/servicemix-web/jbi/exampleUri?x=123&name=James&location=London">perform a GET</a> into the HTTP binding</li>

      
      
   4. Use the ServiceMix JMX Console to see monitoring information on the httpBinding example just run.
      1. From a browser, enter the following URL: http://localhost:8080/servicemix-web^{Image Removed}. Note: If Tomcat is not running on port 8080, substitute the correct port number for 8080.
      2. Click on "org.servicemix."
      3. Click on "org.servicemix.jbi.framework.ComponentMBeanImpl". In the right-hand frame, scroll to the right to see statistics for the httpbinding example.
         
         
         
         
         

5. Anchor
   2.0steps 2.0steps

   To run the httpBinding example for ServiceMix 2.0 perform the following steps:
   1. Before attempting to run the example program, first check that the{{HelloWorldComponent.class}} file exists. Do a directory listing of the following and look for the file.

      Code Block
      cd [tomcat_install_dir]\webapps\servicemix-web\WEB-INF\classes\org\servicemix\components
      Wiki Markup

      where {{\[tomcat_install_dir\]}} is the directory in which Tomcat is installed.
   2. If the file HelloWorldComponent.class does not exist and possibly the directory components does not exist either, perform the following steps. If the file exists, go to
      1. Create the components directory in the ServiceMix source distribution:

         Code Block
         cd [servicemix_install_dir]\tooling\servicemix-web\src\main\java\org\servicemix mkdir components

      2. Copy the HelloWorldComponent.java file to the components directory created above. The HelloWorldComponent.java file can be created by cutting and pasting the following code:

         Code Block

         package org.servicemix.components; import org.servicemix.components.util.TransformComponentSupport; import org.servicemix.jbi.jaxp.StringSource; import javax.jbi.messaging.MessageExchange; import javax.jbi.messaging.MessagingException; import javax.jbi.messaging.NormalizedMessage; public class HelloWorldComponent extends TransformComponentSupport { private String property; protected boolean transform(MessageExchange exchange, NormalizedMessage in, NormalizedMessage out) throws MessagingException { out.setContent(new StringSource("<hello>" + in.getProperty(property) + "</hello>")); return true; } public String getProperty() { return property; } public void setProperty(String property) { this.property = property; } }

      3. Rebuild the servicemix-web.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.
      4. Stop Tomcat.unmigrated-wiki-markup
      5. Remove the existing {{\[tomcat_install_dir\]\webapps\servicemix-web}} directory.
      6. Copy servicemix-web.war to the Tomcat webapps directory. For example, on a Windows system:

         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.
         
      7. Start Tomcat to deploy the ServiceMix WAR file.
         
   3. To run the example: from a browser, enter the following URL: http://localhost:8080/servicemix-web/examples^{Image Removed}. NOTE: If Tomcat is using a different port, such as port 80, substitute the correct port number for 8080 in the URL.
      
      
      
      
   4. Enter a name or some text in the text box (shown above) and click the Submit button. You will see: