快速入门

# 前言

本文档主要介绍金蝶Apusic应用服务器V10标准版快速入门，提供了系统环境要求、安装方法、基本使用等功能，适用于使用金蝶Apusic应用服务器进行开发的开发人员、生产环境的系统管理员、运维人员等。

# 适用对象

本手册主要面向对象为使用金蝶Apusic应用服务器进行应用开发的开发人员，生产环境的系统管理员，应用发布人员，技术运维人员等。具备以下技能可能会更好理解和使用金蝶Apusic应用服务器用户手册内容：

  • 熟悉Linux常用命令
  • 基本的系统管理任务
  • 安装和管理软件

# 相关文档

了解更多AAS-V10标准版产品相关的信息，请参阅以下AAS-V10产品手册文档集：

序号手册文档说明
1金蝶Apusic应用服务器V10标准版安装手册详细介绍如何在各操作系统上安装AAS，以及AAS服务启停操作，产品的注册过程
2金蝶Apusic应用服务器V10标准版快速入门简单介绍了如何快速上手使用AAS
3金蝶Apusic应用服务器V10标准版用户手册详细介绍AAS相关功能的使用和操作说明，指导用户对系统进行安装部署、功能操作、参数配置、日常运维及问题自查
4金蝶Apusic应用服务器V10标准版管控台用户手册详细介绍AAS管控台相关功能的使用和操作说明，指导用户通过可视化管控台进行操作
5金蝶Apusic应用服务器V10标准版命令行操作指南详细介绍AAS通过命令行进行操作使用
6金蝶Apusic应用服务器V10标准版监控指标文档详细介绍AAS各类型监控指标
7金蝶Apusic应用服务器V10标准版API文档详细介绍AAS的API信息

# 技术支持

金蝶Apusic应用服务器产品提供全面的技术支持服务，您可以通过以下方式获得技术支持：

  • 网址：www.apusic.com
  • 电话：400-855-5800
  • 邮箱：support@apusic.com
  • 金蝶云社区：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技术支持时，请提供如下信息：

  1. 您的姓名
  2. 公司信息与联系方式
  3. 操作系统及其版本
  4. 产品版本号
  5. 出现异常及错误的日志、截图等详细信息

# 产品介绍

金蝶Apusic应用服务器V10标准版是一款符合JAVAEE规范的Web应用服务器，属于轻量级应用服务器，通常用于应用系统高效开发场合。

# 术语

​ AAS：金蝶Apusic应用服务器

​ AE：金蝶Apusic应用服务器标准版产品标识

​ APUSIC_HOME：金蝶Apusic应用服务器安装目录

# 环境准备

安装前，需要先确认java环境。JDK版本建议在1.8.0_201及以上，查看JDK版本命令如下：

[user@test bin]# java -version
java version "1.8.0_212"
Java(TM) SE Runtime Environment (build 1.8.0_212-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.212-b10, mixed mode)
1
2
3
4

支持指定 JAVA 运行环境，通过在apusic.sh或apusic.bat设置，在开头添加JAVA_HOME，如在apusic.sh中设置：

set JAVA_HOME="/opt/java/jdk1.8.0_271"
1

# 安装

准备安装包AAMS-V10.0.8-SP12-AE-20260701.tar.gz 或 AAMS-V10.0.8-SP12-AE-20260701.zip，拷贝至有权限的目录，进行解压。

解压即安装成功。

执行 tar -zxvf AAMS-V10.0.8-SP12-AE-20260701.tar.gz
或 unzip AAMS-V10.0.8-SP12-AE-20260701.zip
1
2

# 卸载

删除安装目录${APUSIC_HOME}/下所有文件即可完成卸载操作。卸载将会丢失当前AAS所有已配置的文件，请谨慎操作。

# 许可证授权

AAS需要有对应的许可证才能正常使用，通常情况下，金蝶天燕会根据用户购买的产品版本配套对应的许可证，如果在使用过程中出现许可证过期或无效等问题，建议优先联系对接的天燕服务人员，重新申请对应许可证。

产品授权方式分为普通授权和集中授权。

# 普通授权

普通授权指根据IP、域名等方式生成license.xml文件，将授权文件放置安装目录下，${APUSIC_HOME}/license.xml。

image1

如若安装有管控平台，系统管理员admin登录管控平台，点击右上角的授权图标，点击“更新授权”，上传可用的授权文件，保存即可完成更新。重启AAS后新授权文件生效。

# 集中授权

集中授权指连接授权中心，进行统一授权。需要先搭建金蝶Apusic授权中心，操作方式可参考《金蝶Apusic许可授权中心用户手册》，或联系金蝶天燕技术支持人员。

在系统环境中配置环境变量，或在AAS安装目录根目录创建acls.properties文件，添加以下参数：

apusic_acls_enable=true
apusic_acls_authUrls=127.0.0.1:6886
apusic_acls_ns=apusic
apusic_acls_tenant=ApusicTest
1
2
3
4

连接参数说明：

表5：金蝶Apusic许可授权中心连接参数说明

参数名 参数值说明
apusic_acls_enable 是否开启授权中心认证，取值为true或false，为true则表示开启授权中心认证。没有该参数或该参数值为false，都表示没有开启授权中心认证；
apusic_acls_authUrls 授权中心的地址，可设置多个授权地址，格式为ip1:port1,ip2:port2，如果一个授权地址链接失败，会轮询其他的地址；如果开启授权中心认证，则为必填参数，其中端口为授权中心的https端口；
apusic_acls_ns 设置该实例所属的命名空间名称，可选参数；默认值为public，具体的命名空间可以在授权中心管理控制台-系统管理-授权管理查看。
apusic_acls_tenant 设置该实例所属的租户名称，可选参数。

AAS启动时将会自动连接到Apusic授权中心。

# 获取特征码

如果在使用过程中出现许可证过期或无效等问题，建议优先联系对接的天燕服务人员，重新申请对应许可证。重新申请对应许可证时，需要将产品的特征码(auth code)提供到天燕对接人员。

在${APUSIC_HOME}/bin，执行apusic.sh -ac [ethname or ip]，[ethname or ip]取值为ip地址或者网卡名称，类似如下:

apusic.sh -ac 127.0.0.1
1

打印特征码信息，类似如下，Auth Code=特征码内容：

Using APUSIC_BASE:   /opt/AAS/AAMS-V10.0.0
Using APUSIC_HOME:   /opt/AAS/AAMS-V10.0.0
Using APUSIC_TMPDIR: /opt/AAS/AAMS-V10.0.0/temp
Using JRE_HOME:        /usr/local/java/jdk1.8.0_231/jre
Using CLASSPATH:       /opt/AAS/AAMS-V10.0.0/bin/bootstrap.jar:/opt/AAS/AAMS-V10.0.0/bin/aas-juli.jar
Using APUSIC_OPTS:
Auth Code=SZTY829390371
1
2
3
4
5
6
7

获取特征码后再提供特征码申请授权文件。

# 嵌入式部署方式获取特征码

在与springboot整合的方式下，没有获取特征码的apusic命令，需要依赖用户的应用进行获取。

如果已经有临时的授权文件可以启动应用，则先把授权文件移除，然后在启动命令中增加JVM参数apusic-ac，取值为ip地址或者网卡名称，类似如下,eth3为测试机器的网卡名称，需要根据实际的网络信息修改:

java -Dapusic-ac=eth3 -jar boot-quickstart-1.0.jar
1

由于没有授权文件，应用启动会停止，在停止前会打印特征码信息，类似如下，Auth Code=特征码内容：

Auth Code=SZTY263537626
license is invalid.
1
2

# 启动

# 在Linux环境下

安装完成并更新授权文件后，进入安装目录${APUSIC_HOME}/bin，执行apusic.sh run。

也可执行./startapusic.sh 启动服务。

# 在 Windows环境下

安装完成并更新授权文件后，进入安装目录${APUSIC_HOME}\bin，执行apusic.bat run。

也可执行startapusic.bat 启动服务。

# 停止

# 在Linux环境下

​ 1、Ctrl + C

​ 前端启动状态下，可以直接Ctrl + C退出，停止AAS。

​ 2、stopapusic.sh

​ 进入安装目录${APUSIC_HOME}/bin，执行stopapusic.sh。

​ 3、kill进程

​ 可以通过kill [进程号] 方式停止

# 在 Windows环境下

​ 1、Ctrl + C

​ 前端启动状态下，可以直接Ctrl + C退出，停止AAS

​ 2、stopapusic.bat

​ 进入安装目录${APUSIC_HOME}\bin，执行stopapusic.bat。

​ 3、停止进程

​ 可以打开任务管理器，找到对应进程，停止运行。

# 访问管控平台

启动时默认启动管控平台，在浏览器中访问系统地址：https://127.0.0.1:6848/aas-console。

使用系统管理员账号登录：

  • 用户名：admin
  • 密码：Apusic@123

注意：首次登录强制修改密码。

image1

# 部署应用

# 自动部署

金蝶Apusic应用服务器支持自动部署应用，应用程序打包文件，如test1.war，放置${APUSIC_HOME}/webapps/目录下，启动应用服务器即可完成部署。

# 管控台部署

金蝶Apusic应用服务器支持通过管控台部署应用，系统管理员登录管控平台，进入【应用管理】-【应用列表】，点击“部署应用”，根据步骤上传应用，确认部署即可完成部署操作。

# 命令行部署

金蝶Apusic应用服务器支持通过命令行部署应用，进入安装目录${APUSIC_HOME}/bin，执行 ./aascli.sh ，输入用户名和密码，执行app deploy --app-name=<name> --app-path=<app-path>

# 访问应用程序

在客户端，如浏览器，访问格式通常为http://[IP]:[port]/[应用上下文路径]，如http://127.0.0.1:6888/test1 。

或通过管控平台，进入【应用管理】-【应用列表】，点击对应的应用列表的操作“访问”跳转可访问链接，点击链接进行访问。

注意：如果应用自行定义访问URL，需要根据应用实际进行访问。

# 卸载应用

# 管控台卸载

可通过管控台卸载应用，系统管理员登录管控平台，进入【应用管理】-【应用列表】，点击需要卸载的应用列表中的操作“卸载”，确认卸载即可完成卸载操作。

注意：卸载应用将会导致该应用无法访问，请谨慎操作。

# 命令行卸载

支持通过命令行卸载应用，进入安装目录${APUSIC_HOME}/bin，执行 ./aascli.sh ，输入用户名和密码，执行app delete <name>

# 配置数据源

# 前提条件

准备数据源环境以及对应版本的驱动。

# 管控台配置

可通过管控台配置数据源，系统管理员登录管控平台，进入【资源管理】-【数据源】，点击“新建”，输入数据源信息，按步骤执行，点击保存即可配置。

注意：名称需要唯一，且需要与应用定义的JNDI名称一致。

# 配置文件设置

也可以修改配置文件设置，编辑${APUSIC_HOME}/config/context.xml，添加数据源配置信息，如下：

<Resource name="jdbc/test" auth="Container" type="javax.sql.DataSource" driverClassName="com.mysql.jdbc.Driver"
    url="jdbc:mysql://127.0.0.1:3306/test_platform?useUnicode=true&characterEncoding=utf-8" username="[YOUR_USERNAME]"
    password="[YOUR_PASSWORD]" maxTotal="100" maxIdle="30" maxWaitMillis="10000" />
1
2
3

同时需要将数据源对应版本的驱动放置${APUSIC_HOME}/lib/ 目录下。

注意：在代码中要引用 jndi 需要加上前缀：java:comp/env，如上面的数据源的：java:comp/env/jdbc/test。

# 日志配置

金蝶Apusic应用服务器提供日志配置功能，可登录管控平台进入【日志服务】-【日志配置】模块配置日志信息。

# 系统日志

登录管控平台进入【日志服务】-【日志配置】-【系统日志配置】设置。或在${APUSIC_HOME}/config/logging.properties中配置日志相关信息。

日志文件默认位置为${APUSIC_HOME}/logs/ 。

# 访问日志

登录管控平台进入【日志服务】-【日志配置】-【访问日志配置】设置。或修改配置文件，可配置在 application 或者 service 里面。配置在 host 里面则该 host 下的应用访问都会被记录日志。

<Valve className="com.apusic.ams.valves.AccessLogValve" directory="logs" prefix="access_log" suffix=".txt"
    pattern="common" />
1
2

日志文件默认位置为${APUSIC_HOME}/logs/ 。

编辑页面 (opens new window)

← 用户手册→