2. 程式人生 > >Java Service Wrapper 將Java程式部署成系統服務

Java Service Wrapper 將Java程式部署成系統服務

阿新 • • 發佈：2018-11-23

在使用Java開發應用程式時，我們通常會打包成Jar包獨立執行，但是在實際生產環境中，伺服器重啟或出現異常時，程式往往不能重啟或隨伺服器開機啟動，所以我們可以採用Java Service Wrapper工具解決這一問題，Wrapper可以將我們的Java程式包裝成系統服務，這樣就可以隨著系統的執行而自動運行了。本文主要介紹使用Wrapper將Java程式裝成系統服務的方法，以linux系統為例。

1. 下載Wrapper

Wrapper下載地址：http://wrapper.tanukisoftware.com/doc/english/download.jsp
Wrapper幾乎支援所有的系統環境，目前最新版本為3.5.33，下載Linux x86 64bit版本，作者使用的是3.5.32版。

2. Java Service Wrapper目錄結構

解壓後目錄如下圖：
wrapper解壓後目錄

cmd 控制檯下輸入 tree /f 可以檢視wrapper的詳細目錄和檔案結構，顯示目錄結構如下：

│  README_de.txt        //說明
│  README_en.txt        //說明
│  README_es.txt        //說明
│  README_ja.txt        //說明
│
├─bin                   //執行檔案目錄
│      demoapp          //示例程式
│      testwrapper      //測試程式
│      wrapper          //主程式（重要）
 

│
├─conf                  //配置檔案目錄
│      demoapp.conf     //示例配置檔案
│      wrapper.conf     //主配置檔案（重要，檔名可改）
│
├─doc                   //說明文件目錄
│      index.html       //首頁
│      revisions.txt    //版本說明
│      wrapper-community-license-1.3.txt    //許可協議
│
├─lib                   //依賴類庫目錄 
│      libwrapper.so    //wrapper linux檔案(.so：使用者層的動態庫) 
 

│      wrapper.jar      //wrapper主程式(重要)
│      wrapperdemo.jar  //示例程式
│      wrappertest.jar  //測試程式
│
├─logs                  //日誌目錄
│      wrapper.log      //日誌檔案
│
└─src                   //原始碼目錄
    ├─bin              //執行程式目錄
    │    sh.script.in  //shell指令碼原始碼(重要)
    │
    └─conf            //配置目錄
        wrapper.conf.in //原始配置

3. 包裝Java 應用程式

這裡我們將Wrapper和StreamServer程式進行整合，將程式打包成可執行的Jar包之後按一下步驟操作，在打包時一定要選擇將程式的依賴包以子資料夾的形式打包，這樣才可以在wrapper的配置檔案中正確配置依賴檔案，如下：
Java程式打包成可執行Jar包

3.1 建立目錄結構

StreamServer
    ├─bin
    ├─conf
    ├─lib   
    ├─logs  
    └─src

複製Java Service Wrapper檔案到應用程式目錄
（1）複製/bin/wrapper到應用的bin目錄；
（2）複製/bin/testwrapper到應用的bin目錄；
（5）複製/src/conf/wrapper.conf.in到應用的conf目錄下；
（6）複製/lib/libwrapper.so到應用的lib目錄；
（7）複製/lib/wrapper.jar到應用的lib目錄；
複製自己的程式Jar包和依賴資料夾到src目錄下；
注：由於本程式使用了自定義的配置檔案config.properties和日誌配置檔案log4j.properties，而程式中配置檔案的引用路徑是/config/config.properties，所以需要將配置檔案config.properties和log4j.properties單獨拷貝出來，複製到src/config目錄下。

3.2 編輯testwrapper檔案

該檔案是應用程式的啟動入口，將檔案重新命名為程式名
#mv testwrapper StreamServer
修改檔案內容

 # Application
 APP_NAME="StreamServer"
 APP_LONG_NAME="StreamServer Application"
 # Wrapper
 WRAPPER_CMD="./wrapper"
 WRAPPER_CONF="../conf/wrapper.conf"

3.3 編輯wrapper.conf.in 檔案

重新命名wrapper.conf.in為wrapper.conf，所有java service wrapper配置項均在此設定，按以下步驟進行設定：

  • 檔案編碼及子配置檔案

檔案頭部包含了配置檔案編碼格式，子配置檔案等相關資訊，如下所示：

 #檔案編碼，每個配置檔案起始位置必須指定該檔案的編碼格式  
 encoding=UTF-8  

 # 如果包含配置檔案出現問題可以使用debug除錯模式，去掉一個"#"
 #include.debug  

 # 包含子配置檔案，可以是配置資訊也可以是許可資訊  
include ../conf/wrapper-license.conf  
include ../conf/wrapper2.conf  

 # 是否開啟許可檔案debug模式  
wrapper.license.debug=TRUE
  • Wrapper 語言設定

通過這兩項的設定可以指定Wrapper 的語言種類，可以在Wrapper 官網下到這些語言包支援，目前不支援中文。

 # 指定Wrapper語言，預設使用系統語言  
wrapper.lang=en_US  

 #指定Wrapper 語言資源位置，如果該檔案不存在則預設設定為en_US  
wrapper.lang.folder=../lang
  • java執行環境設定
    本程式使用PATH環境變數配置資訊
# Java 程式配置：  
#   (1)預設使用PATH環境變數配置資訊則使用下列配置形式  
wrapper.java.command=java  

#   (2)如果想單獨配置執行程式，則可採用此種配置方式  
#set.JAVA_HOME=/java/path  
#wrapper.java.command=%JAVA_HOME%/bin/java  

# java程式日誌級別  
wrapper.java.command.loglevel=INFO
  • 程式入口
    wrapper的主類，可以是org.tanukisoftware.wrapper.WrapperStartStopApp或WrapperSimpleApp
    WrapperStartStopApp可以設定應用程式的啟動和關閉入口
 # Java Main class，也就是程式入口    
#該類需要實現WrapperListener 介面並保證WrapperManager 得到初始化  
wrapper.java.mainclass=wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperStartStopApp
  • 類庫設定
# Java Classpath配置，必須從序號"1"開始，新增新的jar包後序號遞增  
wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../src/StreamServer.jar
wrapper.java.classpath.3=../src/StreamServer_lib/netty-all-4.0.45.Final.jar
wrapper.java.classpath.4=../src/StreamServer_lib/log4j-1.2.17.jar 
...

# Java 類庫路徑 (Wrapper.DLL 或 libwrapper.so 依賴檔案的存放位置)  
wrapper.java.library.path.1=../lib
  • JVM相關配置
 # 32/64位選擇，true為自動選擇  
wrapper.java.additional.auto_bits=TRUE  

# Java附加引數，若有log4j配置檔案，則要新增引數
wrapper.java.additional.1=-Dlog4j.configuration=../src/config/log4j.properties

附加引數即為java命令可選引數，如下所示：

-d32          use a 32-bit data model if available  

-d64          use a 64-bit data model if available  
-server   to select the "server" VM  
      The default VM is server.  

-cp <class search path of directories and zip/jar files>  
-classpath <class search path of directories and zip/jar files>  
      A : separated list of directories, JAR archives,  
      and ZIP archives to search for class files.  
-D<name>=<value>  
      set a system property  
-verbose[:class|gc|jni]  
      enable verbose output  
-version      print product version and exit  
-version:<value>  
      require the specified version to run  
-showversion  print product version and continue  
-jre-restrict-search | -jre-no-restrict-search  
      include/exclude user private JREs in the version search  
-? -help      print this help message  
-X            print help on non-standard options  
-ea[:<packagename>...|:<classname>]  
-enableassertions[:<packagename>...|:<classname>]  
      enable assertions  
-da[:<packagename>...|:<classname>]  
-disableassertions[:<packagename>...|:<classname>]  
      disable assertions  
-esa | -enablesystemassertions  
      enable system assertions  
-dsa | -disablesystemassertions  
      disable system assertions  
-agentlib:<libname>[=<options>]  
      load native agent library <libname>, e.g. -agentlib:hprof  
        see also, -agentlib:jdwp=help and -agentlib:hprof=help  
-agentpath:<pathname>[=<options>]  
      load native agent library by full pathname  
-javaagent:<jarpath>[=<options>]  
      load Java programming language agent, see java.lang.instrument  
-splash:<imagepath>  
      show splash screen with specified image

記憶體大小設定：

# Java Heap 初始化大小(單位：MB)  
wrapper.java.initmemory=3  

# Java Heap 最大值(單位：MB)  
wrapper.java.maxmemory=64
  • 應用程式引數設定：

WrapperStartStopApp的配置形式

# 應用程式引數，序號需從"1"開始
# 程式的主函式所在類入口
wrapper.app.parameter.1=com.stream.server.StreamServer
wrapper.app.parameter.2=1 
wrapper.app.parameter.3=true 
# 程式的關閉函式所在類入口
wrapper.app.parameter.4=com.stream.server.StreamServer
wrapper.app.parameter.5=true 
wrapper.app.parameter.6=1 
# 程式的關閉函式
wrapper.app.parameter.7=stop
  • Wrapper 日誌配置
# 是否顯示debug日誌  
#wrapper.debug=TRUE  

# 控制檯資訊輸出格式(格式檢視docs文件)  
wrapper.console.format=PM  

# 控制檯日誌級別  
wrapper.console.loglevel=INFO  

# 日誌檔案位置及名稱  
wrapper.logfile=../logs/wrapper.log

# 日誌檔案輸出格式  (格式檢視docs文件)  
wrapper.logfile.format=LPTM  

# 日誌檔案日誌級別  
wrapper.logfile.loglevel=INFO  

# 限制日誌檔案大小，0為不限制，引數：k,m,g等  
wrapper.logfile.maxsize=50m  

# 限制最大日誌檔案數，0為不限制  
wrapper.logfile.maxfiles=0  

# syslog 日誌級別  
wrapper.syslog.loglevel=NONE
  • Wrapper 基本屬性配置
# 允許使用非連續編號的屬性，例如：path的序號可以打亂  
wrapper.ignore_sequence_gaps=TRUE  

# 如果pid檔案已經存在則不啟動程式  
wrapper.pidfile.strict=TRUE  

# 控制檯啟動時顯示的標題  
wrapper.console.title[email protected].long.name@
  • Wrapper JVM 檢查
# 檢測JVM中的死鎖執行緒（需要標準版Wrapper）  
wrapper.check.deadlock=TRUE  
#間隔，單位：秒  
wrapper.check.deadlock.interval=60  
#出現死鎖時處理事件  
wrapper.check.deadlock.action=RESTART  
#資訊輸出級別，FULL:全部;SIMPLE:精簡;NONE:無;  
wrapper.check.deadlock.output=FULL

記憶體溢位檢測

# 記憶體溢位檢測，Wrapper提供了幾種不同的匹配機制  
wrapper.filter.trigger.1000=[Loaded java.lang.OutOfMemoryError
wrapper.filter.action.1000=NONE  
wrapper.filter.trigger.1001=java.lang.OutOfMemoryError  
#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.

3.4 完成

修改成功後的資料夾目錄結構如下：

├─bin
│      StreamServer
│      wrapper
│
├─conf
│      wrapper.conf
│
├─lib
│      libwrapper.so
│      wrapper.jar
│
├─logs
└─src
    │  StreamServer.jar
    │
    ├─config
    │      config.properties
    │      log4j.properties
    │
    └─StreamServer_lib
            java_websocket.jar
            log4j-1.2.17.jar
            log4j-api-2.0-rc1.jar
            log4j-core-2.0-rc1.jar
            netty-all-4.0.45.Final.jar
            slf4j-api-1.7.5.jar
            slf4j-log4j12-1.7.5.jar

4. 部署成系統服務

將上面的StreamServer資料夾移動到linux伺服器/opt目錄下

4.1 賦予服務執行許可權

chmod 775 /opt/StreamServer/bin/StreamServer
chmod 775 /opt/StreamServer/bin/wrapper

4.2 讓服務Server開機自動執行

ln -s /opt/StreamServer/bin/StreamServer /etc/init.d/StreamServer
#新增系統服務，此時服務會被在/etc/rc.d/rcN.d中賦予K/S入口了
chkconfig --add StreamServer

4.3 測試

執行命令：service StreamServer start|stop|restart|status
程式執行時，Java Service Wrapper在/opt/StreamServer/logs/目錄下產生wrapper.log日誌

注意：
1）若StreamServer 需要訪問mysql資料庫，則要檢視開機啟動順序是否在mydqld服務之前，若在之前應進行如下操作
刪除服務新增之後/etc/rc2.d,rc3.d,rc4.d,rc5.d中的StreamServer服務啟動命令檔案，將該命令檔案的啟動順序改到mysqld服務之後，S+數字 該數字在mysqld服務之後
刪除地址軟連結使用 rm -rf symbolic_name
ln -s /etc/init.d/StreamServer /etc/rc3.d/S90StreamServer
ln -s /etc/init.d/StreamServer /etc/rc5.d/S90StreamServer

2）執行出現錯誤 /bin/sh^M: bad interpreter:沒有那個檔案或目錄解決
錯誤分析:
因為我在windows下編輯的指令碼，所以有可能有不可見字元。
指令碼檔案是DOS格式的, 即每一行的行尾以\n\r來標識, 其ASCII碼分別是0x0D, 0x0A.
可以有很多種辦法看這個檔案是DOS格式的還是UNIX格式的, 還是MAC格式的

解決方法是使用dos2unix命令轉一下，即輸入： dos2unix 檔名
dos2unix /opt/SocketServer/bin/StreamServer
dos2unix /opt/SocketServer/bin/wrapper

參考：
Java Service Wrapper使用總結
Wrapper配置詳解及高階應用
Java Service Wrapper簡介與使用

相關推薦

使用Java Service Wrapper將jar包安裝成Windows服務

部署 detect cap xxx face port exception script 參考 在windows上運行jar包，需要在工作目錄下使用命令行運行jar包，這樣會出現一個命令行窗口。而且這個命令行窗口有可能會不小心被關閉，且服務器啟動後需要人為去點擊開啟。 對於

Java Service Wrapper 將Java程式部署成系統服務

在使用Java開發應用程式時，我們通常會打包成Jar包獨立執行，但是在實際生產環境中，伺服器重啟或出現異常時，程式往往不能重啟或隨伺服器開機啟動，所以我們可以採用Java Service Wrapper工具解決這一問題，Wrapper可以將我們的Java程式包裝成系統服務，這樣就可以隨著系統

詳解Maven項目利用java service wrapper將Java程序生成Windows服務

XML mac linear font english resources mat 必須 parameter 在項目的開發中，有時候需要將Java應用程序打包成Windows服務，我們就直接可以通過windows的服務來啟動和關閉java程序了。 本博文將通過有兩種方法實現

利用Java Service wrapper 將Tomcat做成windows服務

選擇下載社群版，但只支援32位windows 解壓到隨便哪裡都行， 此處解壓到D盤路徑為D:/wrapper-windows-x86-32-3.5.20  如版本為其它注意更換 tomcat路徑為：D:\apache-tomcat-6.0.20 1，將D:/wrappe

[Windows] 如何將應用程式註冊為系統服務

將任何應用程式註冊成後臺服務程式，即：系統啟動後該程式可以自動啟動，並且在前臺不要出現執行視窗。 解決辦法：需要使用Windows提供的兩個工具instsrv.exe和srvany.exe。（Windows 2003資源工具包帶有） instsrv：把win32程式變成系

Java Service Wrapper 淺談

系統 問題 可靠 但是 jar包 監聽端口 很多 就是 企業 　　在實際開發過程中很多模塊需要獨立運行，他們並不會以web形式發布，傳統的做法是將其壓縮為jar包獨立運行，這種形式簡單易行也比較利於維護，但是 一旦服務器重啟或出現異常時，程序往往無法自行修復或重啟。解決服務

Java Service Wrapper 使用（windows）

項目 ftw 1.5 install lin 1.5.0 class eight .class 1 簡介 最近項目中需要做一個Windows系統服務，記錄一下使用過程。 Java Service Wrapper 可以將

java用Json將父類轉成子類

將父類物件用 JSONObject.toJSONString(father)轉成String， 再用JSONObject.parseObject 轉成子類物件 Son son2= JSONObject.parseObject(JSONObject.toJSONString(father),S

Java使用PegDown將markdown檔案轉成html格式

maven依賴： <dependency> <groupId>org.pegdown</groupId> <artifactId>pegdown</artifactId> <versio

【TCP三次握手過程】Java Service Wrapper簡介與使用 --- 學習中

ava Service Wrapper簡介與使用    在實際開發過程中很多模組需要獨立執行，他們並不會以web形式釋出，傳統的做法是將其壓縮為jar包獨立執行，這種形式簡單易行也比較利於維護，但是一旦伺服器重啟或出現異常時，程式往往無法自行修復或重啟。解決伺服器重啟的傳統做

Java之eclipse將工具類打成Jar包、使用jar包、以及刪除jar包

Eclipse如何匯出jar包？？？ 選中對應的工具類，右鍵==>Export... ==>選中Java目錄下的JAR File==>Next==>選擇匯出路徑==>Fi

Java Service Wrapper: JVM exited while loading the application

Java Service Wrapper: JVM exited while loading the application 使用Java Service Wrapper 將應用程式包裝為linux守護程式一直報錯：JVM exited while loading the app

[Wrapper]Java Service Wrapper簡介與使用 --- 學習中

   在實際開發過程中很多模組需要獨立執行，他們並不會以web形式釋出，傳統的做法是將其壓縮為jar包獨立執行，這種形式簡單易行也比較利於維護，但是一旦伺服器重啟或出現異常時，程式往往無法自行修復或重啟。解決伺服器重啟的傳統做法是編寫一段shell指令碼隨伺服器啟動而執行

將java程式做成windows系統服務

採用的Java Service Wrapper工具， 下載地址：  http://sourceforge.net/projects/wrapper/files/（當下最新版為3.5.6的）  步驟：  1、解壓縮java service wrapper包，假設目錄為：wrapper_home  2、建立一個目

java中如何將office檔案轉成pdf或者圖片（親測有效）

前段時間做專案時，需要將word文件在瀏覽器中開啟，一般的在瀏覽器中開啟word都是直接提示下載的，找了好久都是些pageoffice等的收費外掛，小專案成本要儘量壓縮，所以就放棄了這種收費的外掛了。突然想到有些瀏覽器能直接開啟pdf或者圖片，手機端也需要顯示圖片，所以可以

使用Java反射機制將Bean物件轉換成Map(駝峰命名方式 — 下劃線命名方式)

1、駝峰與下劃線方式名稱互相轉換工具類 public class CamelUnderlineUtil { private static final char UNDERLINE ='_'; public static String camelToUnderline(

java中怎樣將JSON字串還原成MAP

首先，你先確認你的字串是否是json格式的，如果是json格式，那你可以使用Gson.jar或json-lib-xx-jdk.jar兩個包來自動解析解析。 　　使用Gson更簡單些，只需要匯入一個包就可以，但是他如果使用Object解析到int型的話或自動轉成double型

java中如何將字元陣列轉換成字串,以逗號分割

String[] ary = {"abc", "123", "45"};  StringBuffer sb = new StringBuffer(); for(int i = 0; i < ary.length; i++) { sb. append(ary[i]..t

java中如何將字串陣列轉換成字串

如果是 “字串陣列” 轉 “字串”，只能通過迴圈，沒有其它方法 String[] str = {"abc", "bcd", "def"};StringBuffer sb = new StringBuffer();for(int i = 0; i < str.lengt

Java Service Wrapper-簡介與使用

   在實際開發過程中很多模組需要獨立執行，他們並不會以web形式釋出，傳統的做法是將其壓縮為jar包獨立執行，這種形式簡單易行也比較利於維護，但是一旦伺服器重啟或出現異常時，程式往往無法自行修復或重啟。解決伺服器重啟的傳統做法是編寫一段shell指令碼隨伺服器啟動而執行，但是這樣做只是治標，那麼我們想尋