Author: chirino
Date: Fri Sep 29 11:02:34 2006
New Revision: 451366
URL: http://svn.apache.org/viewvc?view=rev&rev=451366
Log:
Latest export from confluence
Modified:
incubator/servicemix/site/main/tomcat-integration.html
Modified: incubator/servicemix/site/main/tomcat-integration.html
URL:
http://svn.apache.org/viewvc/incubator/servicemix/site/main/tomcat-integration.html?view=diff&rev=451366&r1=451365&r2=451366
==============================================================================
--- incubator/servicemix/site/main/tomcat-integration.html (original)
+++ incubator/servicemix/site/main/tomcat-integration.html Fri Sep 29 11:02:34
2006
@@ -112,18 +112,17 @@
<!--
<div class="pagetitle">Tomcat Integration</div>
-->
- <DIV class="wiki-content">
-<H2><A name="TomcatIntegration-TomcatIntegration"></A>Tomcat Integration</H2>
-<P>The following guide explains how to deploy ServiceMix 2.0.x on the <SPAN
class="nobr"><A href="http://tomcat.apache.org/"; title="Visit page outside
Confluence" rel="nofollow">Apache Tomcat<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> application
server. This guide provides instructions specifically for ServiceMix 2.0.x
release. For ServiceMix 1.1 and ServiceMix 2.0 instructions, refer to <A
href="tomcat-integration-for-servicemix-11-and-20.html" title="Tomcat
Integration for ServiceMix 1.1 and 2.0">Tomcat Integration for ServiceMix 1.1
and 2.0</A>.</P>
+ <DIV class="wiki-content"><H2><A
name="TomcatIntegration-TomcatIntegration"></A>Tomcat Integration</H2>
+<P>The following guide explains how to deploy ServiceMix 3.0.x on the <SPAN
class="nobr"><A href="http://tomcat.apache.org/"; title="Visit page outside
Confluence" rel="nofollow">Apache Tomcat<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> application
server. This guide provides instructions specifically for ServiceMix 3.0.x
release. For ServiceMix ServiceMix 2.0.1 instructions, refer to <A
href="tomcat-integration-for-servicemix-201.html" title="Tomcat Integration for
ServiceMix 2.0.1">Tomcat Integration for ServiceMix 2.0.1</A>.</P>
<H3><A
name="TomcatIntegration-PreInstallationRequirements"></A>Pre-Installation
Requirements</H3>
<UL>
- <LI>Java Developer Kit (JDK) 1.4.x or greater to run ServiceMix (to
build ServiceMix, JDK 1.5.x or greater is required)</LI>
+ <LI>Java Developer Kit (JDK) 1.5.x or greater to run ServiceMix</LI>
<LI>The JAVA_HOME environment variable must be set to the directory
where the JDK is installed, e.g. <TT>c:\Program Files\Java\jdk1.5.xx</TT>.</LI>
- <LI>Maven 1.0.2 or greater (required when installing source or
developer releases).</LI>
+ <LI>Maven 2.0.4 or greater (required when installing source or
developer releases).</LI>
<LI>Apache Tomcat version 5.5</LI>
- <LI>ServiceMix 2.0.x</LI>
+ <LI>ServiceMix 3.0.x</LI>
</UL>
@@ -132,7 +131,7 @@
<LI>Windows XP</LI>
<LI>Tomcat 5.5</LI>
<LI>Java 5</LI>
- <LI>ServiceMix 2.0.x</LI>
+ <LI>ServiceMix 3.0</LI>
</UL>
@@ -143,76 +142,73 @@
<OL>
<LI>Apache Tomcat must be downloaded and installed. For instructions
please see the <SPAN class="nobr"><A href="http://tomcat.apache.org/";
title="Visit page outside Confluence" rel="nofollow">Tomcat<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> web
site.</LI>
<LI>By default, Tomcat uses port 8080. It is important to note if your
Tomcat installation is on another port, such as port 80; this information will
be used in a later step.</LI>
- <LI>Download the ServiceMix source code. Please see the <SPAN
class="nobr"><A href="http://www.servicemix.org/Getting%20Started"; title="Visit
page outside Confluence" rel="nofollow">Getting Started<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>
guide for instructions.</LI>
+ <LI>Download the ServiceMix distribution. Please see the <A
href="getting-started.html" title="Getting Started">Getting Started</A> guide
for instructions.</LI>
<LI>Create the WAR file:
<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">cd [servicemix_install_dir]\tooling\servicemix-web
-maven war</PRE>
+<PRE class="code-java">cd [servicemix_install_dir]\examples\servicemix-web
+mvn install</PRE>
</DIV></DIV>
-<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix
was downloaded and installed.</P></LI>
- <LI>To deploy the WAR file, <TT>servicemix-web.war</TT>, copy it to the
Tomcat <TT>webapps</TT> directory. For example, on a Windows system:
+<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix
was downloaded and installed.</P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="warningMacro"
border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD
valign="top"><IMG
src="http://goopen.org/confluence/images/icons/emoticons/forbidden.gif";
width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B
class="strong">For ServiceMix 3.0</B><BR>
+<P>If you use ServiceMix 3.0, you need to modify the <TT>pom.xml</TT> file in
the \examples\servicemix-web directory.<BR>
+Lines 79-83 should be modified as following:</P>
<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">cd
[servicemix_install_dir]\tooling\servicemix-web\target
-copy servicemix-web.war [tomcat_install_dir]\webapps</PRE>
+<PRE class="code-xml"><SPAN class="code-tag"><dependency></SPAN>
+ <SPAN class="code-tag"><groupId></SPAN>org.mortbay.jetty<SPAN
class="code-tag"></groupId></SPAN>
+ <SPAN class="code-tag"><artifactId></SPAN>jetty<SPAN
class="code-tag"></artifactId></SPAN>
+<SPAN class="code-tag"></dependency></SPAN></PRE>
+</DIV></DIV>
+<P>For ServiceMix 3.0.1 or later, this step is not
necessary.</P></TD></TR></TABLE></LI>
+ <LI>To deploy the WAR file, <TT>servicemix-web-xxx.war</TT>, copy it to
the Tomcat <TT>webapps</TT> directory. For example, on a Windows system:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd
[servicemix_install_dir]\examples\servicemix-web\target
+copy servicemix-web-*.war [tomcat_install_dir]\webapps</PRE>
</DIV></DIV>
<P>where <TT>tomcat_install_dir</TT> is the directory in which Tomcat was
installed.
<BR clear="all"></P></LI>
- <LI>To deploy the ServiceMix WAR file, stop and start Tomcat.
+ <LI>Start Tomcat if it was not already running
<BR clear="all">
The output in the Tomcat console window should show ServiceMix starting.
Output will be similar to the following:
<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">INFO: Deploying web application archive
servicemix-web.war
-Nov 1, 2005 11:03:54 AM org.springframework.web.context.ContextLoader
initWebApplicationContext
-INFO: Root WebApplicationContext: initialization started
-Nov 1, 2005 11:03:54 AM
org.springframework.beans.factory.xml.XmlBeanDefinitionReader
loadBeanDefinitions
-INFO: Loading XML bean definitions from ServletContext resource
[/WEB-INF/applicationContext.xml]
-Nov 1, 2005 11:03:55 AM org.springframework.core.CollectionFactory
<clinit>
-INFO: JDK 1.4+ collections available
-Nov 1, 2005 11:03:55 AM org.springframework.core.CollectionFactory
<clinit>
-INFO: Commons Collections 3.x available
-Nov 1, 2005 11:03:55 AM
org.springframework.context.support.AbstractRefreshableApplicationContext
refreshBeanFactory
-INFO: Bean factory <SPAN class="code-keyword">for</SPAN> application context
[Root WebApplicationContext]:
org.springframework.beans.factory.support.DefaultListableBeanFactory defining
beans [jencks,broker,transactionManager,jmsFactory,jbi]; root of BeanFactory
hierarchy
-Nov 1, 2005 11:03:55 AM
org.springframework.context.support.AbstractApplicationContext refresh
-INFO: 5 beans defined in application context [Root WebApplicationContext]
-Nov 1, 2005 11:03:55 AM
org.springframework.context.support.AbstractApplicationContext initMessageSource
-INFO: Unable to locate MessageSource with name 'messageSource':
using <SPAN class="code-keyword">default</SPAN> [EMAIL PROTECTED]
-Nov 1, 2005 11:03:55 AM
org.springframework.context.support.AbstractApplicationContext
initApplicationEventMulticaster
-INFO: Unable to locate ApplicationEventMulticaster with name
'applicationEventMulticaster': using <SPAN
class="code-keyword">default</SPAN> [EMAIL PROTECTED]
-Nov 1, 2005 11:03:55 AM
org.springframework.ui.context.support.UiApplicationContextUtils initThemeSource
-INFO: No ThemeSource found <SPAN class="code-keyword">for</SPAN> [Root
WebApplicationContext]: using ResourceBundleThemeSource
-Nov 1, 2005 11:03:55 AM
org.springframework.beans.factory.support.DefaultListableBeanFactory
preInstantiateSingletons
-INFO: Pre-instantiating singletons in factory
[org.springframework.beans.factory.support.DefaultListableBeanFactory defining
beans [jencks,broker,transactionManager,jmsFactory,jbi]; root of BeanFactory
hierarchy]
-Nov 1, 2005 11:03:55 AM
org.springframework.beans.factory.support.AbstractBeanFactory getBean
-INFO: Creating shared instance of singleton bean 'jencks'
-Nov 1, 2005 11:03:56 AM
org.springframework.beans.factory.support.AbstractBeanFactory getBean
-INFO: Creating shared instance of singleton bean 'broker'
-...</PRE>
-</DIV></DIV>
-<P><B>NOTE:</B> The console output is also logged in
<TT>tomcat_home_dir\logs\catalina.xxxx-xx-xx.log</TT>.</P></LI>
+<PRE class="code-java">INFO: Deploying web application archive
servicemix-web-3.0-incubating.war
+Sept. 29, 2006 19:49:40 org.apache.catalina.loader.WebappClassLoader
validateJarFile
+INFO:
validateJarFile(c:\java-bin\apache-tomcat-5.5.20\webapps\servicemix-web-3.0-incubating\WEB-INF\lib\servlet-api-2.5-6.0.0rc4.jar)
- jar not loaded. See Servlet Spec 2.3, section 9.7.2. Offending class:
javax/servlet/Servlet.class
+INFO - jetty - Logging to [EMAIL PROTECTED] via
org.apache.servicemix.http.jetty.JCLLogger
+INFO - JBIContainer - ServiceMix 3.0-incubating JBI
Container (ServiceMix) is starting
+INFO - JBIContainer - For help or more informations please
see: http:<SPAN class="code-comment">//incubator.apache.org/servicemix/
+</SPAN>INFO - ConnectorServerFactoryBean - JMX connector available at:
service:jmx:rmi:<SPAN class="code-comment">///jndi/rmi://localhost:1099/jmxrmi
+</SPAN>INFO - ComponentMBeanImpl - Initializing component:
#SubscriptionManager#
+INFO - DeploymentService - Restoring service assemblies
+INFO - ComponentMBeanImpl - Initializing component:
servicemix-http
+INFO - ComponentMBeanImpl - Initializing component: echo
+INFO - ComponentMBeanImpl - Initializing component: timer
+INFO - SimpleThreadPool - Job execution threads will use class
loader of thread: ContainerBackgroundProcessor[StandardEngine[Catalina]]
+INFO - QuartzScheduler - Quartz Scheduler v.1.5.2 created.
+INFO - RAMJobStore - RAMJobStore initialized.
+INFO - StdSchedulerFactory - Quartz scheduler
'DefaultQuartzScheduler' initialized from <SPAN
class="code-keyword">default</SPAN> resource file in Quartz <SPAN
class="code-keyword">package</SPAN>: 'quartz.properties'
+INFO - StdSchedulerFactory - Quartz scheduler version: 1.5.2
+INFO - ComponentMBeanImpl - Initializing component: inputSender
+INFO - ComponentMBeanImpl - Initializing component: inputReceiver
+INFO - ComponentMBeanImpl - Initializing component: outputSender
+INFO - ComponentMBeanImpl - Initializing component: jmsTrace
+INFO - ComponentMBeanImpl - Initializing component: trace
+ERROR - ClientFactory - Cound not start ClientFactory:
javax.naming.NamingException: Context is read only.
+INFO - QuartzScheduler - Scheduler
DefaultQuartzScheduler_$_NON_CLUSTERED started.
+INFO - JBIContainer - ServiceMix JBI Container (ServiceMix)
started</PRE>
+</DIV></DIV></LI>
</OL>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro"
border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD
valign="top"><IMG
src="http://goopen.org/confluence/images/icons/emoticons/information.gif";
width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B
class="strong">ERROR - ClientFactory</B><BR>
+<P>The log will display an error. Do not worry, this error will not affect
ServiceMix.<BR>
+This will be fixed in a later release.</P></TD></TR></TABLE>
+
<H3><A
name="TomcatIntegration-TestingtheServiceMixDeploymentonTomcat"></A>Testing the
ServiceMix Deployment on Tomcat</H3>
<P>To ensure that ServiceMix is running on Tomcat, do any of the following:</P>
<OL>
- <LI>Check the Tomcat console output or the Tomcat log files (see above)
to confirm that the servicemix-web is starting without errors.</LI>
- <LI>ServiceMix's default port is 1099. From another window run
netstat and search for port 1099.
-<BR clear="all">
-From a Windows console, type:
-<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">netstat -an|find <SPAN
class="code-quote">"1099"</SPAN></PRE>
-</DIV></DIV>
-<P><BR clear="all">
-<B>OR</B>
-<BR clear="all">
-<BR clear="all">
-From a Unix command shell, type:</P>
-<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">netstat -an|grep 1099</PRE>
-</DIV></DIV>
-<P><BR clear="all"></P></LI>
- <LI>Run the ServiceMix JMX Console. To do this, enter the following URL
in a web browser: <SPAN class="nobr"><A
href="http://localhost:8080/servicemix-web"; title="Visit page outside
Confluence" rel="nofollow">http://localhost:8080/servicemix-web<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.
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.<BR>
+ <LI>Check the Tomcat console output to confirm that the servicemix-web
is starting without errors.</LI>
+ <LI>Run the ServiceMix JMX Console. To do this, enter the following URL
in a web browser: <SPAN class="nobr"><A
href="http://localhost:8080/servicemix-web-3.0-incubating/"; title="Visit page
outside Confluence"
rel="nofollow">http://localhost:8080/servicemix-web-3.0-incubating/<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.
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.<BR>
Try using the JMX console. For example, perform the following steps. Note:
this is optional.
<OL>
<LI>Click on "Catalina".</LI>
@@ -227,7 +223,7 @@
</LI>
<LI>An http binding example is supplied. To run the example program
perform the following steps:
<OL>
- <LI>From a browser, enter the URL <SPAN class="nobr"><A
href="http://localhost:8080/servicemix-web/examples"; title="Visit page outside
Confluence"
rel="nofollow">http://localhost:8080/servicemix-web/examples<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif";
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>.
<B>NOTE:</B> If Tomcat is using a different port, such as port 80, substitute
the correct port number for 8080 in the URL.
+ <LI>From a browser, enter the URL <SPAN class="nobr"><A
href="http://localhost:8080/servicemix-web-3.0-incubating/examples";
title="Visit page outside Confluence"
rel="nofollow">http://localhost:8080/servicemix-web-3.0-incubating/examples<SUP><IMG
class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif"; height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>. <B>NOTE:</B>
If Tomcat is using a different port, such as port 80, substitute the correct
port number for 8080 in the URL.
<BR clear="all">
<BR clear="all">
<IMG src="tomcat-integration.data/httpbindingexample2.0.jpg" align="absmiddle"
border="0">
@@ -254,10 +250,10 @@
<a href="javascript:hideChildren()">Hide Children</a></span>
</div>
<div class="greybox" id="children" style="display: none;">
- <a
href="http://goopen.org/confluence/display/SM/Tomcat+Integration+for+ServiceMix+1.1+and+2.0";
title="Tomcat Integration for ServiceMix 1.1 and 2.0">Tomcat Integration for
ServiceMix 1.1 and 2.0</a>
+ <a
href="http://goopen.org/confluence/display/SM/Tomcat+Integration+for+ServiceMix+2.0.1";
title="Tomcat Integration for ServiceMix 2.0.1">Tomcat Integration for
ServiceMix 2.0.1</a>
<span class="smalltext">(ServiceMix)</span>
<br>
- <a
href="http://goopen.org/confluence/display/SM/Tomcat+Integration+for+ServiceMix+2.0.1";
title="Tomcat Integration for ServiceMix 2.0.1">Tomcat Integration for
ServiceMix 2.0.1</a>
+ <a
href="http://goopen.org/confluence/display/SM/Tomcat+Integration+for+ServiceMix+1.1+and+2.0";
title="Tomcat Integration for ServiceMix 1.1 and 2.0">Tomcat Integration for
ServiceMix 1.1 and 2.0</a>
<span class="smalltext">(ServiceMix)</span>
<br>
</div>
@@ -270,8 +266,8 @@
</DIV>
<DIV id="site-footer">
Added by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=lmalgeri";>Lisa
Malgeri</A>,
- last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet";>Guillaume
Nodet</A> on May 11, 2006
- (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=2050&originalId=5125";>view
change</A>)
+ last edited by <A
href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet";>Guillaume
Nodet</A> on Sep 29, 2006
+ (<A
href="http://goopen.org/confluence/pages/diffpages.action?pageId=2050&originalId=13882";>view
change</A>)
(<A
href="http://goopen.org/confluence/pages/editpage.action?pageId=2050";>edit
page</A>)
</DIV>
![http://goopen.org/confluence/images/icons/linkext7.gif"](http://goopen.org/confluence/images/icons/linkext7.gif"){kind=link}
![http://goopen.org/confluence/images/icons/emoticons/forbidden.gif"](http://goopen.org/confluence/images/icons/emoticons/forbidden.gif"){kind=link}
![http://goopen.org/confluence/images/icons/emoticons/information.gif"](http://goopen.org/confluence/images/icons/emoticons/information.gif"){kind=link}