前言
Java Service Wrapper是Tanuki Software的一个产品,可以将Java应用注册成Windows或Linux服务,使其可以随系统开机启动,同时可以监控Java应用的状态,使其在出异常状况时自动启动,其具体特性请参考官方文档Overview of Wrapper features ,本文记录了笔者在官方文档指导下在Linux环境下用Java Serivice Wrapper配置Tomcat应用的实践。
前提
安装部署
Java安装到/usr/local/java8/ 具体步骤略
Tomcat安装到/usr/local/tomcat/ 具体步骤略
将Java Web应用打成war包,拖到tomcat/webapps/下 具体步骤略
解压缩Java Service Wrapper压缩包到/usr/local/wrapper/,开始安装wrapper文件:
bin目录
复制以下文件到tomcat/bin目录:
/usr/local/wrapper/bin/wrapper
/usr/local/wrapper/src/bin/sh.script.in
脚本文件sh.script.in重命名为你的应用名,如ABC。
用编辑器打开ABC,找到APP_NAME,将值改成与文件名一致,APP_LONG_NAME的值改为应用长名。
APP_NAME="ABC"
APP_LONG_NAME="ABC Application Server"
保存关闭文件,给脚本文件ABC授执行权限
lib目录
复制以下文件到tomcat/lib目录:
/usr/local/wrapper/lib/libwrapper.so
/usr/local/wrapper/lib/wrapper.jar
conf目录
复制wrapper.conf到tomcat/conf目录,编辑wrapper.conf文件:
//配置java路径,根据具体环境配置,可以用绝对路径,也可以使用环境变量
set.JAVA_HOME=/usr/local/java8/
set.CATALINA_HOME=/usr/local/tomcat
set.CATALINA_BASE=/usr/local/tomcat
wrapper.java.command=/usr/local/java8/bin/java //JVM参数。将应用正常启动时所配置的参数复制过来。具体步骤:
// 1.命令行启动应用
// 2.用ps –ef | grep tomcat找到应用进程
// 3.复制该进程的参数,将-D开头的参数逐条配置到下面
wrapper.java.additional.=-Djava.util.logging.config.file=%CATALINA_HOME%/conf/logging.properties
wrapper.java.additional.=-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
wrapper.java.additional.=-Djava.endorsed.dirs=%CATALINA_HOME%/common/endorsed
wrapper.java.additional.=-Dcatalina.base=%CATALINA_BASE%
wrapper.java.additional.=-Dcatalina.home=%CATALINA_HOME%
wrapper.java.additional.=-Djava.io.tmpdir=%CATALINA_BASE%/temp //类路径。与获取JVM参数方式相同,将类路径逐条配置到下面
wrapper.java.classpath.=%CATALINA_HOME%/bin/bootstrap.jar
wrapper.java.classpath.=%CATALINA_HOME%/bin/tomcat-juli.jar
wrapper.java.classpath.=%CATALINA_HOME%/lib/wrapper.jar //lib路径。
wrapper.java.library.path.=%CATALINA_HOME%/lib //Wrapper集成主类。有4种集成方式,适合tomcat这样启动使用一个类,
//停止使用另一个类的应用的是WrapperStartStopApp类
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperStartStopApp //tomcat应用参数,无需修改
wrapper.app.parameter.=org.apache.catalina.startup.Bootstrap
wrapper.app.parameter.=
wrapper.app.parameter.=start
wrapper.app.parameter.=org.apache.catalina.startup.Bootstrap
wrapper.app.parameter.=TRUE
wrapper.app.parameter.=
wrapper.app.parameter.=stop
安装服务
进入/usr/local/tomcat/bin/目录,修改脚本文件ABC,设置随系统启动
//设置服务随系统启动
USE_UPSTART=true
保存退出,以root权限执行
$ sudo ./ABC install
应用将注册为upstart服务
Notice: 只对Wrapper 版本3.4.0之后有效
测试
执行命令
service start | stop | restart | status
之后到tomcat/logs/目录下查看wrapper.log,没有异常就是成功。
重启机器,登录后查看进程里有ABC在运行,证明随系统启动正常,或者访问Java Web应用,证明应用正常启动。