如何在Windows下把Apusic配置成系統服務
Apusic 應用服務器安裝好之后,系統只提供了Windows窗口啟動與命令行啟動兩種方式。但是系統上線后希望可以無人值守,因此需要把 Apusic 應用服務器的啟停放到Windows服務中。下面我將介紹如何操作,以及操作中存在的相關配置方式。
1. 手工操作需要的文件是apusicsvc.exe。
??? 這個文件在 Apusic 4.0.3中是%APUSIC_HOME%/bin目錄下。
??? 在 Apusic 5.0中是%APUSIC_HOME%/domains/mydomain/bin目錄下。
??? 這個文件是安裝和啟動服務的基礎。如果希望了解具體使用參數可以在命令行中輸入:
??? apusicsvc.exe/?
??? 具體的結果參考附錄一。
2. 下面是具體的幾種操作模式
2.1. 默認的操作。
安裝:apusicsvc.exe -install
移除:apusicsvc.exe -uninstall
配置:services.msc 查找服務名稱為 ApusicServer 的,此時服務為手動狀態,可以配置成自動狀態,也可以進行啟動與停止。
2.2. 使用APULOVE作為服務名稱,由-name參數支持。(Apusic 4.0.3的apusicsvc.exe不提供這個功能,現在這個功能必須采用不加橫杠的方式使用,問題已經提請研發部門修改)
安裝:apusicsvc.exe -install -name "APULOVE"
移除:apusicsvc.exe -uninstall APULOVE
配置:services.msc 查找服務名稱為 APULOVE 的,此時服務為手動狀態,可以配置成自動狀態,也可以進行啟動與停止。
說明:也可以替換APULOVE為其他名稱,這樣可以使系統啟動多個Apusic應用服務器實例。
2.3. 為 Apusic 服務提供java.exe的參數,關于java.exe的參數情況請參考“JVM啟動參數(轉)”。
2.3.1. java 標準參數例子:虛擬機執行模式-server / -client
安裝服務器啟動模式服務:apusicsvc.exe -install -server
移除服務:同2.1.
配置:同2.1.
2.3.2. java -X參數使用例子:Java heap size的配置。
安裝初始化Heap值的服務:apusicsvc.exe -install -Xms256M -Xmx256M
移除服務:同2.1.
配置:同2.1.
2.3.3. 這些參數是可以混合使用的。
apusicsvc.exe -install -server -Xms512M -Xmx512M
2.4. 為Apusic 服務提供Apusic應用服務器的啟動參數。現階段apusic應用服務器提供的參數有-root -config,具體使用說明可以參考應用服務器幫助文檔中的Apusic應用服務器管理手冊。
安裝指定啟動文件的服務:apusicsvc.exe -install -config C:\apusic\apusic-5.0\domains\mydomain\config\webonly.conf
移除服務:同2.1.
配置:同2.1.
說明:這個服務啟動時只擁有WEB容器,大大減少了系統啟動的速度和資源的消耗。
3. Apusic 服務啟動異常說明
3.1. 如果 Apusic 服務啟動時報錯,一般情況是提供的配置參數有錯誤,或者系統本身無法正常啟動才會造成服務無法正常啟動。現在報錯沒有什么提示,最簡單的辦法就是將服務移除,再重新添加比較好。添加前需要注意的是參數是否正確,以及系統本身是否可以正常啟動。
3.2. 如果在Apusic應用啟動過程中使用了網絡磁盤,系統會報找不到映射文件,因為網絡磁盤映射工作是先啟動服務再啟動Explorer.exe程序,然后再進行映射磁盤的,因此無論你在任何情況下啟動Apusic服務都無法正確訪問網絡映射的磁盤,特別要注意。
附錄一。
Apusic 5.0的使用說明。
C:\Apusic\apusic-5.0\domains\mydomain\bin>apusicsvc /?
Usage: apusicsvc [-options]
where options include:
??? -install [Apusic args...]
???????????????? install Apusic as windows service
??? -uninstall [Service Name]
???????????????? uninstall the Apusic service
where Apusic args include:
??? -cp -classpath <directories and zip/jar files separated by ;>
???????????????? set search path for application classes and resources
??? -D<name>=<value>
???????????????? set a system property
??? -X
???????????????? JVM non-standard options
??? -name <service name>
???????????????? set the service name of server
??? -root <directory>
???????????????? set the root directory of server
for example: apusicsvc -install
??? install Apusic as windows service without any startup params
C:\Apusic\apusic-5.0\domains\mydomain\bin>