安装部署

# 前言

本文档主要介绍金蝶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应用服务器安装目录

# 系统环境要求

# 平台环境

金蝶Apusic应用服务器兼容各类型操作系统，如下表所示。

表1：金蝶Apusic应用服务器V10标准版适应的操作系统

操作系统说明
WindowsWindows7、Windows10、Windows Server
LinuxCentOS、Ubuntu、SUSE、Redhat
国产平台银河麒麟系列、中标麒麟系列、普华、中科红旗、深度等

# 系统环境

金蝶Apusic应用服务器系统环境建议如下。

表2：金蝶Apusic应用服务器V10标准版系统环境

系统组件系统要求
Java环境JDK8及以上，针对HTTP2建议使用8U252以上
内存至少需要 512MB 的内存，建议1024MB以上
磁盘空间至少需要 1024MB 的磁盘空间，建议10G以上

# 产品清单

产品安装包通常打包为AAMS-[version].tar.gz或AAMS-[version].zip。

文中${APUSIC_HOME}表示应用服务器的安装目录。

表3：金蝶Apusic应用服务器V10标准版产品包

产品包说明
AAMS-[version].zip/AAMS-[version].tar.gz金蝶Apusic应用服务器V10标准版安装包

金蝶Apusic应用服务器V10标准版产品包说明。

表4：金蝶Apusic应用服务器V10标准版产品包说明

文件说明
bin应用服务器启动、停止等脚本所在的目录
conf应用服务器配置文件所在的目录
console应用服务器管控台所在的目录
lib应用服务器JAR文件所在的目录
logs应用服务器日志文件默认目录
plugins应用服务器插件所在的目录
store数据仓库目录，各类数据的集中存放地
webapps自动部署应用程序包的目录
webapps-console通过管控台部署应用程序包的目录
webapps-jakarta部署JakartaEE规范应用程序包的目录
temp应用服务器临时文件存放的目录
work存放JSP编译后产生的class文件
license.xml产品包的授权文件

# 安装与卸载

# Java环境

安装前，需要先确认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，如：

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=test1 --app-path="/opt/demo/test1.war"

# 访问应用程序

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

编辑页面 (opens new window)

← 快速入门→