使用Java Service Wrapper在Linux下配置Tomcat应用

前言

Java Service Wrapper是Tanuki Software的一个产品，可以将Java应用注册成Windows或Linux服务，使其可以随系统开机启动，同时可以监控Java应用的状态，使其在出异常状况时自动启动，其具体特性请参考官方文档Overview of Wrapper features ，本文记录了笔者在官方文档指导下在Linux环境下用Java Serivice Wrapper配置Tomcat应用的实践。

前提

• Suse Linux 64位
• Java 8 Download
• Tomcat 8 Download
• Java Service Wrapper Linux 64bit Download

安装部署

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应用，证明应用正常启动。