如何在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>