将mule部署到tomcat中,有两种部署方式:
1, 将Mule作为一个webApp应用,此时不需要修改tomcat的相关设置。
2, 将Mule作为tomcat的一个组件,此时需要修改tomcat的配置。
第二种方式部署时,
1)需要在conf/server.xml中增加<Listener className="org.mule.module.tomcat.MuleTomcatListener" />。
2)拷贝所有的mule\lib下除/boot外的所有文件夹到mule-libs下(在tomcat根目录下创建)。
3)拷贝mule-libs/mule/下的mule-module-tomcat-<version>.jar到tomcat根目录的lib目录下。
4)拷贝lib/boot/目录下的jcl104-over-slf4j-**.jar, log4j-1.2.*.jar, slf4j-api-**.jar, slf4j-log4j12-**.jar到mule-libs/opt目录下。
注意这里可能某些包不存在,需要使用maven下载。
同时可能出现错误信息,
java.lang.NoClassDefFoundError: org/tanukisoftware/wrapper/security/WrapperPermission
at org.mule.module.management.agent.JmxAgent.registerWrapperService(JmxAgent.java:339)
at org.mule.module.management.agent.JmxAgent$MuleContextStartedListener.onNotification(JmxAgent.java:676)
此时还需要拷贝mule/lib/boot下的wrapper.jar包。
本人采用的是第一种部署方式,部署比较方便,同时仍然按照第二种部署方式,将所有的mule相关jar包放入${TOMCAT_HOME}\mule-libs目录下,并在conf\catalina.properties文件中common.loader=下增加:
${catalina.home}/mule-libs,${catalina.home}/mule-libs/usr/*.jar,${catalina.home}/mule-libs/mule/*.jar,${catalina.home}/mule-libs/opt/*.jar
从而避免了对mule应用发布时,繁重的mule包池拷贝。
二、log4j的配置
1,下载jar包:
http://www.apache.org/dist/tomcat/tomcat-6/v6.0.36/bin/extras/tomcat-juli-adapters.jar
http://www.apache.org/dist/tomcat/tomcat-6/v6.0.36/bin/extras/tomcat-juli.jar
注意这里v6.0.36版本是当前最新版本,后续需要更新,否则路径不正确。
这里下载的文件是.zip后缀的,需要修改为.jar后缀。
http://www.apache.org/dist/logging/log4j/1.2.15/apache-log4j-1.2.15.zip
这里mule本身已经附带了log4j.jar,直接拷贝过来即可。
注意:针对log4的版本需要统一,否则在实际加载时,可能无法正常启动。
2,编写log4j.properties
# 设定logger的root level为DEBUG,指定的输出目的地(appender)为file
log4j.rootLogger=INFO, file , stdout
# 设定stdout控制台
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[%d{HH:mm:ss}] %5p %c{2} \"%m\"%n
# 设定输出位置,此处设定tomcat目录的logs下,文件名为bugmgrsys.log。
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=${catalina.home}/logs/projectLogs.log
log4j.appender.file.MaxFileSize=1024KB
# 设定制定的file使用的PatternLayout.
# 有关ConversionPattern中的转意字符的含义参考说明
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{HH:mm:ss} %-5p [%C] (%F:%L) - %m%n
3,部署文件
将tomcat-juli-adapters.jar,log4j-1.2.16.jar,log4j.properties复制到%TOMCAT_HOME%\lib下面.
将tomcat-juli.jar复制到%TOMCAT_HOME%\bin\下面.
至此,启动tomcat后,也可以在控制台看到mule的日志信息。
实际运行过程中输出的日志由对应app下的log4j.properties配置文件设置。因此,需要将上述的配置文件拷贝到mule应用的WEB_INF中,web.xml中增加相应的loglistener的配置即可。
在linux下,所有的日志自动都会输出到catalina.out文件中,包括输出到控制台的日志。
建议都输出到文件,而不是控制台,有一定性能提升。
三,应用部署
1,首先需要对工程转换为Dynamic Web Module,具体操作为:工程右击选择properties à Project Facets进行工程转换,勾选Dynamic Web Module,其他保持不变即可。
2,在web.xml文件中补充的相应内容为:
<web-app>
<display-name>MuleHelloTest</display-name>
<description>Mule Hello Test</description>
<context-param>
<param-name>org.mule.config</param-name>
<param-value>WEB-INF/mule-config.xml</param-value>
</context-param>
<!--
To use a Mule XML configuration file use this context listener
-->
<listener>
<listener-class>org.mule.config.builders.MuleXmlBuilderContextListener</listener-class>
</listener>
</web-app>
注意:此处listener应当配置为MuleXmlBuilderContextListener,而不是手册中描述的DeployableMuleXmlContextListener。否则会报重复启动错误:
org.mule.api.config.ConfigurationException: Already in lifecycle phase 'start', cannot fire the same phase twice (java.lang.IllegalStateException)2012-9-26 13:51:32 org.apache.catalina.core.ApplicationContext log
严重: Already in lifecycle phase 'start', cannot fire the same phase twice (java.lang.IllegalStateException)
org.mule.api.config.ConfigurationException: Already in lifecycle phase 'start', cannot fire the same phase twice (java.lang.IllegalStateException)
at org.mule.config.builders.AbstractConfigurationBuilder.configure(AbstractConfigurationBuilder.java:52)
…
3,将通过eclipse创建的mule project打成war包。工程右击选择Export àWAR file。导出路径为tomcat的WebApp目录。也可以自己实现ant脚本进行打包发布。
如果环境正常启动了,那么下面就可以正式开发基于mule的服务了!下一篇将介绍mule的一些基本概念和配置。