4.1. 启动和停止服务器

启动和停止服务器有以下几种方式:

4.1.1. 命令行启动或停止服务器

Apusic应用服务器与其他的Java应用程序一样,可以通过java命令启动,只是需要带有一些特定的参数。

在命令行使用java命令启动Apusic应用服务器的参数设置如下:

  • 指定Java堆内存的最大和最小值

    Java的虚拟机是基于堆栈的,缺省Apusic服务器启动时的堆内存最大和最小值都是64兆。这两个值可以在实际使用时根据实际情况指定,推荐使用的值如下:

    java -Xms128m -Xmx512m
  • 设置环境变量

    启动服务器时,需要使用-classpath设置启动Apusic服务器需要的Jar文件,包含位于Apusic应用服务器的安装目录下classes、sp、lib、common目录中的所有jar文件,如:apusic.jar、operamasks-impl.jar、mejb.jar、javaee.jar、elite.jar及其它。其中:

    apusic.jar:Apusic应用服务器的核心类;

    operamasks-impl.jar:Apusic贡献的Web开源框架;

    mejb.jar:实现JSR-77规范的管理EJB;

    javaee.jar:规范定义的javaee标准API

    elite.jar:Apusic贡献的开源动态语言实现

  • 指定服务器的目录

    如当前目录并非Apusic应用服务器的安装目录,需要启动服务器,则必须使用-root参数指定服务器的根目录。

  • 指定域主目录

    指定你需要启动的域主目录,可通过设置jvm参数指定,如-Dcom.apusic.domain.home=/usr/apusic/domains/mydomain

下面是使用java命令启动apusic应用服务器的示例

Linux(假定usr/apusic为服务器的安装目录,变量$CP的值包含前述启动服务器必需的JAR文件):

java -Xms128m -Xmx512m -XX:MaxPermSize=128m -Dcom.apusic.domain.home=/usr/apusic/domains/mydomain -classpath $CP com.apusic.server.Main -root /usr/apusic/

Windows(假定c:\apusic为服务器的安装目录,变量%CP%的值包含前述启动服务器必需的JAR文件):

java -Xms128m -Xmx512m -XX:MaxPermSize=128m -Dcom.apusic.domain.home=c:\apusic\domains\mydomain -classpath %CP% com.apusic.server.Main -root c:\apusic

另外,在Windows环境下,可使用 Apusic安装目录下的bin目录中的apusicw.exe命令启动服务器。

如需要停止以命令行或脚本方式启动的服务器,只需在命令提示符界面输入Ctrl+C即可。

4.1.1.1. 使用startapusic启动脚本

在Apusic服务器域主目录下的bin子目录中,提供了预设的启动脚本startapusic,可直接使用此脚本启动apusic应用服务器。

startapusic提供了多种启动参数,包括:

  • -d[ebug]: 以JDPA形式启动apusic,此时可使用支持JDPA的调试工具(例如Apusic Studio)对部署在服务器上的应用进行调试

  • -d[ebug]s:以JDPA形式启动apusic,并且一开始是suspend

  • -p[roduct]:以生产环境启动apusic,此时,JVM加上一些调整参数,譬如-server –Xms –Xmx等等

  • -v[erbose]:此时并不启动apusic,而只是把当前系统参数以及license信息显示出来

4.1.2. 开始菜单(限于Windows)

如果Apusic应用服务器通过安装程序安装在Windows平台上,则可以通过开始菜单中的快捷方式启动。

选择:开始->程序->Apusic应用服务器 5.1->启动服务器

即可。

[注意]注意

开始菜单中的启动服务器以及Apusic管理控制台(基于浏览器)的快捷方式面向的是mydomain下的服务器实例

4.1.3. Windows系统服务(限于Windows)

如Apusic应用服务器通过执行了服务器目录中/bin目录下的apusicsvc.exe如下:

apusicsvc.exe -installl name=myserver

则可将Apusic应用服务器作为Windows平台的系统服务进行管理,服务名称为myserver,如果未指定name,缺省使用ApusicServer。

选择:开始->设置->控制面板->管理工具->服务

在打开的服务面板窗口中,选择myserver项进行配置(myserver为安装服务时指定的服务名称,缺省为ApusicServer),如果服务器已启动,则可以选择停止ApusicServer服务,反之,则可以选择启动。

同时,可以指定是否禁用ApusicServer服务,或者设置启动类型为手动或者自动。

若需卸载服务,可使用命令行

apusicsvc.exe -uninstall myserver

卸载的服务名称为myserver,如果未指定,缺省使用ApusicServer

4.1.4. 使用firststep工具启动服务器

伴随Apusic应用服务器5.1发布的工具中包括一个firststep工具。可以通过它来启动应用服务器。详情请参考第 4.18.3 节 “firststep工具”

[注意]注意

firststep工具面向的是samples域下的服务器实例