【转】Wrapper配置详解及高级应用

转载地址：http://286.iteye.com/blog/1921414?utm_source=tuicool&utm_medium=referral

  将一个简单的程度如HelloWorld 的应用包装秤Wrapper 服务并不复杂，甚至可以认为非常简单。但是实际项目应用过程中我们的程序一般较庞大，运行环境也较复杂。

        通过Wrapper 配置文件的分析与配置进一步了解构建Wrapper 服务需要注意的关键点及重要部分。

首先，打开conf 文件夹下的wrapper.conf配置文件，此配置文件时Wrapper 的主配置文件也是关键配置文件，下面开始一项一项的开始分析。

 

        1.文件编码及子配置文件
        文件头部包含了配置文件编码格式，子配置文件等相关信息，如下所示：

Xml代码  收藏代码
  1. #文件编码，每个配置文件起始位置必须指定该文件的编码格式  
  2. encoding=UTF-8  
  3.   
  4. # 如果包含配置文件出现问题可以使用debug调试模式，去掉一个"#"，格式为#include.debug  
  5. #include.debug  
  6.   
  7. # 包含子配置文件，可以是配置信息也可以是许可信息  
  8. include ../conf/wrapper-license.conf  
  9. include ../conf/wrapper2.conf  
  10.   
  11. # 是否开启许可文件debug模式  
  12. wrapper.license.debug=TRUE  

 

 

        通过子配置文件的配置可以使主配置文件关联最多10级子配置，例如：wrapper.conf 包含 wrapper2.conf ，wrapper2.conf 包含wrapper3.conf ..... wrapper9.conf 包含wrapper10.conf，文件结构如下：

Xml代码  收藏代码
  1. wrapper.conf  
  2.     |-wrapper2.conf  
  3.         |-wrapper3.conf  
  4.               .....  
  5.             |-wrapper9.conf  
  6.                 |-wrapper10.conf  

 

        也就是说配置文件嵌套层级最大可达10级，引用一张官方图片可以很好的说明：



        如果子配置文件不存在时，那么它将被忽略，不会导致程序运行错误。

 

 

        2.Wrapper 语言设置

        通过这两项的设置可以指定Wrapper 的语言种类，可以在Wrapper 官网下到这些语言包支持，目前不支持中文。

Xml代码  收藏代码
  1. # 指定Wrapper语言，默认使用系统语言  
  2. wrapper.lang=en_US  
  3.   
  4. #指定Wrapper 语言资源位置，如果该文件不存在则默认设置为en_US  
  5. wrapper.lang.folder=../lang  

 

 

        3.Wrapper Java 相关属性配置

        (1)java运行环境设置

Xml代码  收藏代码
  1. # Java 程序配置：  
  2. #   (1)默认使用PATH环境变量配置信息则使用下列配置形式  
  3. wrapper.java.command=java  
  4.   
  5. #   (2)如果想单独配置运行程序，则可采用此种配置方式  
  6. set.JAVA_HOME=/java/path  
  7. wrapper.java.command=%JAVA_HOME%/bin/java  
  8.   
  9. # java程序日志级别  
  10. wrapper.java.command.loglevel=INFO  

 

        (2)程序入口

Xml代码  收藏代码
  1. # Java Main class，也就是程序入口    
  2. #该类需要实现WrapperListener 接口并保证WrapperManager 得到初始化(调用WrapperManager.start(WrapperListener listener, String[] args) 方法)。  
  3. wrapper.java.mainclass=com.helloworld.hello.HelloWorld  

 

        (3)类库设置

Xml代码  收藏代码
  1. # Java Classpath配置，必须从序号"1"开始，添加新的jar包后序号递增  
  2. wrapper.java.classpath.1=../lib/wrapper.jar  
  3. wrapper.java.classpath.2=../lib/hello.jar  
  4.   
  5. # Java 类库路径 (Wrapper.DLL 或 libwrapper.so 依赖文件的存放位置)  
  6. wrapper.java.library.path.1=../lib  

 

        (4)JVM相关配置

Xml代码  收藏代码
  1. # 32/64位选择，true为自动选择  
  2. wrapper.java.additional.auto_bits=TRUE  
  3.   
  4. # Java附加参数  
  5. wrapper.java.additional.1=  

 

        附加参数即为java命令可选参数，如下所示： 

Params代码  收藏代码
  1. -d32          use a 32-bit data model if available  
  2.   
  3. -d64          use a 64-bit data model if available  
  4. -server   to select the "server" VM  
  5.       The default VM is server.  
  6.         
  7. -cp <class search path of directories and zip/jar files>  
  8. -classpath <class search path of directories and zip/jar files>  
  9.       A : separated list of directories, JAR archives,  
  10.       and ZIP archives to search for class files.  
  11. -D<name>=<value>  
  12.       set a system property  
  13. -verbose[:class|gc|jni]  
  14.       enable verbose output  
  15. -version      print product version and exit  
  16. -version:<value>  
  17.       require the specified version to run  
  18. -showversion  print product version and continue  
  19. -jre-restrict-search | -jre-no-restrict-search  
  20.       include/exclude user private JREs in the version search  
  21. -? -help      print this help message  
  22. -X            print help on non-standard options  
  23. -ea[:<packagename>...|:<classname>]  
  24. -enableassertions[:<packagename>...|:<classname>]  
  25.       enable assertions  
  26. -da[:<packagename>...|:<classname>]  
  27. -disableassertions[:<packagename>...|:<classname>]  
  28.       disable assertions  
  29. -esa | -enablesystemassertions  
  30.       enable system assertions  
  31. -dsa | -disablesystemassertions  
  32.       disable system assertions  
  33. -agentlib:<libname>[=<options>]  
  34.       load native agent library <libname>, e.g. -agentlib:hprof  
  35.         see also, -agentlib:jdwp=help and -agentlib:hprof=help  
  36. -agentpath:<pathname>[=<options>]  
  37.       load native agent library by full pathname  
  38. -javaagent:<jarpath>[=<options>]  
  39.       load Java programming language agent, see java.lang.instrument  
  40. -splash:<imagepath>  
  41.       show splash screen with specified image  

 

        内存大小设置：

Xml代码  收藏代码
  1. # Java Heap 初始化大小(单位：MB)  
  2. wrapper.java.initmemory=3  
  3.   
  4. # Java Heap 最大值(单位：MB)  
  5. wrapper.java.maxmemory=64  

 

        应用程序参数设置：

Xml代码  收藏代码
  1. # 应用程序参数，也就是main函数的String[] args参数值，序号需从"1"开始，例如：  
  2. wrapper.app.parameter.1=g21121  
  3. wrapper.app.parameter.2=http://286.iteye.com/  

  

        在main函数和start方法中添加了参数打印语句来观察参数是否已经传入，代码如下：

Java代码  收藏代码
  1. package com.helloworld.hello;  
  2.   
  3. import org.tanukisoftware.wrapper.WrapperListener;  
  4. import org.tanukisoftware.wrapper.WrapperManager;  
  5.   
  6. public class HelloWorld implements WrapperListener {  
  7.   
  8.     public static void main(String[] args) {  
  9.         // 打印参数  
  10.         for (String arg : args)  
  11.             System.out.println(arg);  
  12.         WrapperManager.start(new HelloWorld(), args);  
  13.     }  
  14.   
  15.     @Override  
  16.     public void controlEvent(int event) {  
  17.         System.out.println("controlEvent(" + event + ")");  
  18.         if ((event == WrapperManager.WRAPPER_CTRL_LOGOFF_EVENT) && (WrapperManager.isLaunchedAsService() || WrapperManager.isIgnoreUserLogoffs())) {  
  19.         } else {  
  20.             WrapperManager.stop(0);  
  21.         }  
  22.     }  
  23.   
  24.     @Override  
  25.     public Integer start(String[] args) {  
  26.         // 打印参数  
  27.         for (String arg : args)  
  28.             System.out.println(arg);  
  29.         System.out.println("hello world!");  
  30.         return null;  
  31.     }  
  32.   
  33.     @Override  
  34.     public int stop(int exitCode) {  
  35.         System.out.println("stop(" + exitCode + ")");  
  36.         return exitCode;  
  37.     }  
  38.   
  39. }  

 

        重新运行服务，结果如下：

Result代码  收藏代码
  1. root@TFS:/usr/local/wrapper/bin# ./hello console  
  2. Running helloWorld...  
  3. wrapper  | --> Wrapper Started as Console  
  4. wrapper  | Java Service Wrapper Community Edition 64-bit 3.5.20  
  5. wrapper  |   Copyright (C) 1999-2013 Tanuki Software, Ltd. All Rights Reserved.  
  6. wrapper  |     http://wrapper.tanukisoftware.com  
  7. wrapper  |   
  8. wrapper  | Launching a JVM...  
  9. jvm 1    | g21121  
  10. jvm 1    | http://286.iteye.com/  
  11. jvm 1    | WrapperManager: Initializing...  
  12. jvm 1    | g21121  
  13. jvm 1    | http://286.iteye.com/  
  14. jvm 1    | hello world!  
  15. jvm 1    | stop(0)  
  16. wrapper  | <-- Wrapper Stopped  

 

 

        4.Wrapper 日志配置

Xml代码  收藏代码
  1. # 是否显示debug日志  
  2. wrapper.debug=TRUE  
  3.   
  4. # 控制台信息输出格式  
  5. wrapper.console.format=PM  
  6.   
  7. # 控制台日志级别  
  8. wrapper.console.loglevel=INFO  
  9.   
  10. # 日志文件位置及名称  
  11. wrapper.logfile=../logs/wrapper.log  
  12.   
  13. # 日志文件输出格式  
  14. wrapper.logfile.format=LPTM  
  15.   
  16. # 日志文件日志级别  
  17. wrapper.logfile.loglevel=INFO  
  18.   
  19. # 限制日志文件大小，0为不限制，参数：k,m,g等  
  20. wrapper.logfile.maxsize=10m  
  21.   
  22. # 限制最大日志文件数，0为不限制  
  23. wrapper.logfile.maxfiles=0  
  24.   
  25. # syslog 日志级别  
  26. wrapper.syslog.loglevel=NONE  

 

 

        5.Wrapper 基本属性配置

Xml代码  收藏代码
  1. # 允许使用非连续编号的属性，例如：path的序号可以打乱  
  2. wrapper.ignore_sequence_gaps=TRUE  
  3.   
  4. # 如果pid文件已经存在则不启动程序  
  5. wrapper.pidfile.strict=TRUE  
  6.   
  7. # 控制台启动时显示的标题  
  8. wrapper.console.title=------------Wrapper Console------------  

 

 

        6.Wrapper JVM 检查

Xml代码  收藏代码
  1. # 检测JVM中的死锁线程（需要标准版Wrapper）  
  2. wrapper.check.deadlock=TRUE  
  3. #间隔，单位：秒  
  4. wrapper.check.deadlock.interval=10  
  5. #出现死锁时处理事件  
  6. wrapper.check.deadlock.action=RESTART  
  7. #信息输出级别，FULL:全部;SIMPLE:精简;NONE:无;  
  8. wrapper.check.deadlock.output=FULL  

 

        以下为wrapper.check.deadlock.action的事件类型：
Xml代码  收藏代码
  1. DEBUG :  
  2.     will cause a debug message to be logged. This is only really useful in helping to understand when the action is fired.  
  3. DUMP :  
  4.     will invoke a thread dump.  
  5. GC (Since ver. 3.5.7) :  
  6.     will invoke a full garbage collection sweep in the JVM. Be aware that doing this frequently can affect performance of the JVM as a full sweep will often cause all threads to freeze for the duration of the GC.  
  7. RESTART :  
  8.     will stop the current JVM and then restart a new invocation.  
  9. SHUTDOWN :  
  10.     will stop the JVM as well as the Wrapper.  
  11. USER_<n> (Professional Edition) :  
  12.     will cause a user defined event to be fired. This can be either the sending of an email, or the execution of an external system command. The command could be anything from performing clean up operations to raising an SNMP trap.  
  13. PAUSE :  
  14.     will pause the Java application if pausing is enabled and the JVM is running. See the wrapper.pausable property for details.  
  15. RESUME :  
  16.     will resume the Java application if it is in a paused state. This could be used if the JVM is not stopped when paused. See the wrapper.pausable property for details.  
  17. SUCCESS (Since ver. 3.5.5) :  
  18.     will tell the Wrapper to reset its internal failed invocation count and count the current JVM invocation as "successful". This is probably not useful in this context, but here for consistency with other properties.  
  19. NONE :  
 
 
        7.内存溢出检测
Xml代码  收藏代码
  1. # 内存溢出检测，Wrapper提供了几种不同的匹配机制  
  2. wrapperwrapper.filter.trigger.999=wrapper.filter.trigger.*java.lang.OutOfMemoryError  
  3. wrapper.filter.allow_wildcards.999=TRUE  
  4. wrapper.filter.action.999=NONE  
  5. wrapper.filter.trigger.1000=[Loaded java.lang.OutOfMemoryError  
  6. wrapper.filter.action.1000=NONE  
  7. wrapper.filter.trigger.1001=java.lang.OutOfMemoryError  
  8. #wrapper.filter.trigger.1001=Exception in thread "*" java.lang.OutOfMemoryError  
  9. #wrapper.filter.allow_wildcards.1001=TRUE  
  10. wrapper.filter.action.1001=RESTART  
  11. wrapper.filter.message.1001=The JVM has run out of memory.  
 
 
        8.Wrapper Email 通知设置(需要专业版Wrapper)
Xml代码  收藏代码
  1. # 邮件基本信息设置  
  2. wrapper.event.default.email.debug=TRUE  
  3. #smtp服务器地址  
  4. wrapper.event.default.email.smtp.host=  
  5. #smtp服务器端口  
  6. wrapper.event.default.email.smtp.port=25  
  7. #邮件主题  
  8. wrapper.event.default.email.subject=[%WRAPPER_HOSTNAME%:%WRAPPER_NAME%:%WRAPPER_EVENT_NAME%] Event Notification  
  9. #发件人地址  
  10. wrapper.event.default.email.sender=<Sender email>  
  11. #收件人地址  
  12. wrapper.event.default.email.recipient=<Recipient email>  
  13. # 指定文件内容  
  14. wrapper.event.jvm_restart.email.body=The JVM was restarted.\n\nPlease check on its status.\n  
 
Xml代码  收藏代码
  1. # 邮件日志相关配置  
  2. wrapper.event.default.email.attach_log=TRUE  
  3. wrapper.event.default.email.maillog.lines=50  
  4. wrapper.event.default.email.maillog.format=LPTM  
  5. wrapper.event.default.email.maillog.loglevel=INFO  
 
Xml代码  收藏代码
  1. # 触发事件，即当以下事件为true时发送邮件  
  2. wrapper.event.wrapper_start.email=TRUE  
  3. wrapper.event.jvm_prelaunch.email=TRUE  
  4. wrapper.event.jvm_start.email=TRUE  
  5. wrapper.event.jvm_started.email=TRUE  
  6. wrapper.event.jvm_deadlock.email=TRUE  
  7. wrapper.event.jvm_stop.email=TRUE  
  8. wrapper.event.jvm_stopped.email=TRUE  
  9. wrapper.event.jvm_restart.email=TRUE  
  10. wrapper.event.jvm_failed_invocation.email=TRUE  
  11. wrapper.event.jvm_max_failed_invocations.email=TRUE  
  12. wrapper.event.jvm_kill.email=TRUE  
  13. wrapper.event.jvm_killed.email=TRUE  
  14. wrapper.event.jvm_unexpected_exit.email=TRUE  
  15. wrapper.event.wrapper_stop.email=TRUE  
 

        以上是对wrapper.conf配置文件主要属性的介绍，Wrapper更多特性及应用还需要自己去结合文档深入学习，以下是Wrapper官网文档地址：
        http://wrapper.tanukisoftware.com/doc/english/properties.html

posted @ 2017-05-18 16:18  csshaw  阅读(1876)  评论(0)  编辑  收藏  举报