[朱远翔]如何在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服务启动异常说明
如果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>