Java Service Wrapper

淡淡的烟草味﹌ 2022-08-06 08:14 125阅读 0赞

参考文档：  
http://wrapper.tanukisoftware.com/doc/english/integrate-start-stop-nix.html  
目录  
Java Service Wrapper使用总结  
1.概述  
2.Java Service Wrapper目录结构  
\{WRAPPER\_HOME\}  
3.使用WrapperSimpleApp进行集成  
3.1 ams-collector-verify目录结构  
3.2 复制Java Service Wrapper文件到应用程序  
3.3 编辑sh.script.in文件  
（1）重命名sh.script.in  
（2）赋执行权限  
（3）编辑collector-verify属性  
3.4编辑wrapper.conf.in文件  
（1）重命名wrapper.conf.in  
（2）定位启动应用的Java命令  
（3）编辑wrapper.conf属性  
4.使用WrapperStartStopApp进行集成  
4.1Tomcat的目录结构  
4.2复制Java Service Wrapper文件到Tomcat  
4.3 编辑sh.script.in文件  
（1）重命名sh.script.in  
（2）赋执行权限  
（3）编辑tomcat属性  
4.4编辑wrapper.conf.in文件  
（1）重命名wrapper.conf.in  
（2）定位启动及关闭tomcat的Java命令  
（3）编辑wrapper.conf属性  
5.安装及卸载服务  
5.1安装服务  
5.2卸载服务  
6.配置对内存溢出进行监控  
  
  
  
  
1.概述  
Java Service Wrapper可为应用程序提供以下功能：  
（1）把应用安装为Windows服务或Linux守护进程；  
（2）监测JVM运行情况，对于程序原因或内存溢出导致的虚拟机崩溃实现自动重启；  
（3）记录运行日志；  
  
2.Java Service Wrapper目录结构  
以下列出需要复制到应用的文件：  
\{WRAPPER\_HOME\}  
\--/bin/wrapper  
\-- /src/bin/sh.script.in  
\--/src/conf/wrapper.conf.in  
\--/lib/libwrapper.so  
\--/lib/wrapper.jar  
  
Java Service Wrapper与应用集成时，需要把上述文件复制到应用中相应的目录，详情请见以下的两个集成。  
  
3.使用WrapperSimpleApp进行集成  
WrapperSimpleApp是Java Service Wrapper中最简单的集成方式，在该例子中，我们把它集成到我们的ams-collector-verify抓拍程序中。  
3.1 ams-collector-verify目录结构  
\{ams-collector-verify\}  
\--/bin  
\--/etc  
\--/lib  
\--logs  
  
3.2 复制Java Service Wrapper文件到应用程序  
（1）复制/bin/wrapper到应用的bin目录；  
（2）复制/src/bin/sh.script.in到应用的bin目录；  
（5）复制/src/conf/wrapper.conf.in到应用的etc目录下；  
（6）复制/lib/libwrapper.so到应用的lib目录；  
（7）复制/lib/wrapper.jar到应用的lib目录；  
  
3.3 编辑sh.script.in文件  
该文件可以看作是入口点，启动应用也是使用该脚本，按以下步骤进行操作：  
（1）重命名sh.script.in  
mv sh.script.in collector-verify;  
  
（2）赋执行权限  
例如在Linux下：chmod 755 collector-verify;  
  
（3）编辑collector-verify属性  
\#应用缩写  
APP\_NAME="collector-verify"  
\#应用全名  
APP\_LONG\_NAME="ams-collector-verify"  
\#wrapper配置文件所在位置  
WRAPPER\_CONF="../etc/wrapper.conf"  
  
3.4编辑wrapper.conf.in文件  
所有java service wrapper配置项均在此设置，按以下步骤进行设置：  
（1）重命名wrapper.conf.in  
mv wrapper.conf.in wrapper.conf  
  
（2）定位启动应用的Java命令  
  
当我们知道应用是如何启动的，我们才能将启动所需的参数，classpath及依赖包写入我们的wrapper.conf中；  
在ams-collector-verify应用中，启动应用的java程序如下：  
/usr/java/jdk1.6.0\_13/jre/bin/java -classpath  
/usr/local/ams-collector-verify/bin/commons-launcher.jar:  
/usr/local/ams-collector-verify/etc:  
/usr/local/ams-collector-verify/lib/ams-collector-verify-1.0.jar:  
...  
com.ce.collector.app.SnapApp  
  
从上面的命令可以看到，它包含两方面的信息：  
1)classpath参数加载了lib目录下的所有jar包；  
2)com.ce.collector.appSnapApp类是程序的入口点。  
  
（3）编辑wrapper.conf属性  
\#设置JAVA\_HOME  
set.JAVA\_HOME=/usr/java/jdk1.6.0\_13  
\#动态链接库放置在JAVA\_HOME/bin下，设置LD\_LIBRARY\_PATH变量  
set.LD\_LIBRARY\_PATH=%JAVA\_HOME%/bin:%LD\_LIBRARY\_PATH%  
\#设置java命令路径  
wrapper.java.command=%JAVA\_HOME%/bin/java  
\#设置classpath路径，设置的内容包括wrapper.jar，应用配置文件所在的路径，应启动时classpath包含的所有信息  
wrapper.java.classpath.1=../lib/wrapper.jar  
wrapper.java.classpath.2=../etc  
wrapper.java.classpath.3=../lib/ams-collector-verify-1.0.jar  
...  
\#wrapper.DLL及libwrapper.so所在的位置  
wrapper.java.library.path.1=../lib  
\#应用程序启动的类（带有main方法的类)  
wrapper.app.parameter.1=com.ce.collector.app.SnapApp  
\#设置控制台的名称  
wrapper.console.title=ams-collector-verify  
\#服务名称  
wrapper.name=ams-collector-verify  
\#服务的显示名称  
wrapper.displayname=ams-collector-verify  
\#服务的描述信息  
wrapper.description=collector-verify for ams system  
  
配置完成后，回到应用的bin目录下，试试利用collectory-verify脚本启动应用  
\[root@suhao03 etc\]\# cd ../bin  
\[root@suhao03 bin\]\# ./collector-verify start  
Starting ams-collector-verify...  
Waiting for ams-collector-verify....  
running: PID:8445  
  
可以到logs目录进一步查看应用启动的情况  
\[root@suhao03 bin\]\# cd ../logs/  
\[root@suhao03 logs\]\# tail -f wrapper.log  
  
停止应用可执行以下命令  
\[root@suhao03 bin\]\# ./collector-verify stop  
  
4.使用WrapperStartStopApp进行集成  
Tomcat应用服务器在启动时会开启一个服务端socket等待连接，而关闭时则通过连接触发应用的停止，类似这种应用则通过WrapperStartStopApp实现。  
4.1Tomcat的目录结构  
\{tomcat\_home\}  
\--/bin  
\--/conf  
\--/logs  
\--/temp  
\--/webapps  
\--/work  
  
4.2复制Java Service Wrapper文件到Tomcat  
（1）复制/bin/wrapper到Tomcat的bin目录；  
（2）复制/src/bin/sh.script.in到Tomcat的bin目录；  
（5）复制/src/conf/wrapper.conf.in到Tomcat的etc目录下；  
（6）复制/lib/libwrapper.so到Tomcat的lib目录；  
（7）复制/lib/wrapper.jar到Tomcat的lib目录；  
  
4.3 编辑sh.script.in文件  
该文件可以看作是入口点，启动应用也是使用该脚本，按以下步骤进行操作：  
（1）重命名sh.script.in  
mv sh.script.in tomcat;  
  
（2）赋执行权限  
例如在Linux下：chmod 755 tomcat;  
  
（3）编辑tomcat属性  
\#应用缩写  
APP\_NAME="tomcat"  
\#应用全名  
APP\_LONG\_NAME="Tomcat Application Server"  
  
4.4编辑wrapper.conf.in文件  
所有java service wrapper配置项均在此设置，按以下步骤进行设置：  
（1）重命名wrapper.conf.in  
mv wrapper.conf.in wrapper.conf  
  
（2）定位启动及关闭tomcat的Java命令  
打开bin/catalina.sh文件，分别找到启动及关闭的shell脚本，把shell脚本的内容echo到控制台，看看它是如何启动及关闭tomcat的：  
\[run\]  
echo "$\_RUNJAVA" $JAVA\_OPTS "$LOGGING\_CONFIG" $CATALINA\_OPTS \\  
\-Djava.endorsed.dirs="$JAVA\_ENDORSED\_DIRS" -classpath "$CLASSPATH" \\  
\-Dcatalina.base="$CATALINA\_BASE" \\  
\-Dcatalina.home="$CATALINA\_HOME" \\  
\-Djava.io.tmpdir="$CATALINA\_TMPDIR" \\  
org.apache.catalina.startup.Bootstrap "$@" start  
  
echo的结果为：  
/usr/java/jdk1.6.0\_13/bin/java  
\-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager  
\-Djava.util.logging.config.file=/usr/local/apache-tomcat-6.0.18/conf/logging.properties  
\-Djava.endorsed.dirs=/usr/local/apache-tomcat-6.0.18/endorsed -classpath :/usr/local/apache-tomcat-6.0.18/bin/bootstrap.jar  
\-Dcatalina.base=/usr/local/apache-tomcat-6.0.18  
\-Dcatalina.home=/usr/local/apache-tomcat-6.0.18  
\-Djava.io.tmpdir=/usr/local/apache-tomcat-6.0.18/temp  
org.apache.catalina.startup.Bootstrap start  
  
\[stop\]  
echo "$\_RUNJAVA" $JAVA\_OPTS \\  
\-Djava.endorsed.dirs="$JAVA\_ENDORSED\_DIRS" -classpath "$CLASSPATH" \\  
\-Dcatalina.base="$CATALINA\_BASE" \\  
\-Dcatalina.home="$CATALINA\_HOME" \\  
\-Djava.io.tmpdir="$CATALINA\_TMPDIR" \\  
org.apache.catalina.startup.Bootstrap "$@" stop  
  
echo的结果为：  
/usr/java/jdk1.6.0\_13/bin/java  
\-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager  
\-Djava.endorsed.dirs=/usr/local/apache-tomcat-6.0.18/endorsed -classpath :/usr/local/apache-tomcat-6.0.18/bin/bootstrap.jar  
\-Dcatalina.base=/usr/local/apache-tomcat-6.0.18  
\-Dcatalina.home=/usr/local/apache-tomcat-6.0.18  
\-Djava.io.tmpdir=/usr/local/apache-tomcat-6.0.18/temp  
org.apache.catalina.startup.Bootstrap stop  
  
（3）编辑wrapper.conf属性  
\#设置JAVA\_HOME  
set.JAVA\_HOME=/usr/java/jdk1.6.0\_13  
\#设置CATALINA\_HOME  
set.CATALINA\_HOME=/usr/local/apache-tomcat-6.0.18  
\#设置CATALINA\_BASE  
set.CATALINA\_BASE=/usr/local/apache-tomcat-6.0.18  
  
\#设置JAVA执行命令  
wrapper.java.command=%JAVA\_HOME%/bin/java  
  
\#设置classpath  
wrapper.java.classpath.1=%CATALINA\_BASE%/lib/wrapper.jar  
wrapper.java.classpath.2=%CATALINA\_HOME%/bin/bootstrap.jar  
  
\#设置lib  
wrapper.java.library.path.1=%CATALINA\_BASE%/lib  
  
\#添加tomcat启动时所在命令设置的-D参数  
wrapper.java.additional.1=  
\-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager  
wrapper.java.additional.2=  
\-Djava.util.logging.config.file=%CATALINA\_BASE%/conf/logging.properties  
wrapper.java.additional.3=  
\-Djava.endorsed.dirs=%CATALINA\_BASE%/endorsed  
wrapper.java.additional.4=  
\-Dcatalina.base=%CATALINA\_BASE%  
wrapper.java.additional.5=  
\-Dcatalina.home=%CATALINA\_HOME%  
wrapper.java.additional.6=-Djava.io.tmpdir=%CATALINA\_BASE%/temp  
  
\#添加应用参数  
wrapper.app.parameter.1=org.apache.catalina.startup.Bootstrap  
wrapper.app.parameter.2=1  
wrapper.app.parameter.3=start  
wrapper.app.parameter.4=org.apache.catalina.startup.Bootstrap  
wrapper.app.parameter.5=TRUE  
wrapper.app.parameter.6=1  
wrapper.app.parameter.7=stop  
  
\#日志文件所在位置  
wrapper.logfile=%CATALINA\_BASE%/logs/wrapper.log  
  
\#设置控制台的名称  
wrapper.console.title=tomcat  
\#服务名称  
wrapper.name=tomcat  
\#服务的显示名称  
wrapper.displayname=tomcat application server  
\#服务的描述信息  
wrapper.description=tomcat for ams system  
  
配置完成后，回到tomcat的bin目录下，试试用tomcat脚本启动服务器  
\[root@suhao03 etc\]\# cd ../bin  
\[root@suhao03 bin\]\# ./tomcat start  
Starting tomcat...  
Waiting for tomcat....  
running: PID:8445  
  
可以到logs目录进一步查看tomcat启动的情况  
\[root@suhao03 bin\]\# cd ../logs/  
\[root@suhao03 logs\]\# tail -f wrapper.log  
  
停止tomcat可执行以下命令  
\[root@suhao03 bin\]\# ./tomcat stop  
  
  
  
5.安装及卸载服务  
安装及卸载服务可以通过脚本的install及remove参数完成，想查看service wrapper提供的参数，可键入命令：  
\[root@suhao03 bin\]\# ./collector-verify -help  
Usage: ./collector-verify \[ console | start | stop | restart | condrestart | status | install | remove | dump \]  
Commands:  
console Launch in the current console.  
start Start in the background as a daemon process.  
stop Stop if running as a daemon or in another console.  
restart Stop if running and then start.  
condrestart Restart only if already running.  
status Query the current status.  
install Install to start automatically when system boots.  
remove Uninstall.  
dump Request a Java thread dump if running.  
  
  
5.1安装服务  
\[root@suhao03 bin\] ./collectory-verify install  
  
可以到/etc/rc.d/init.d目录看到增加了以下的符号链接：  
collector-verify -> /usr/local/ams-collector-verify/bin/./collector-verify  
  
5.2卸载服务  
\[root@suhao03 bin\] ./collectory-verify remove  
  
  
6.配置对内存溢出进行监控  
在某些情况下，当应用出现outofmemory时，我们希望它能立即重启，java service wrapper可以为我们实现这一点。  
打开conf/wrapper.conf文件，对以下内容进行设置  
wrapper.filter.trigger.1001=Exception in thread "\*" java.lang.OutOfMemoryError  
wrapper.filter.allow\_wildcards.1001=TRUE  
wrapper.filter.action.1001=RESTART  
wrapper.filter.message.1001=The JVM has run out of memory.