安装部署

# 概述

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

# 基本介绍

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

# 术语

​ AAS：金蝶Apusic应用服务器

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

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

# 系统环境要求

# 平台环境

产品支持的平台环境。

表1：金蝶Apusic应用服务器V10.0.10标准版平台环境

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

# 系统环境

产品支持的系统环境。

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

系统组件系统要求
Java环境JDK11及以上
内存至少需要 512MB 的内存，建议1024MB以上
磁盘空间至少需要 1024MB 的磁盘空间，建议10G以上

# 产品清单

金蝶Apusic应用服务器V10.0.10标准版产品包说明，通常情况下打包成AAS-[aas_version]-[sp_version]-AE-[date].zip或AAS-[aas_version]-[sp_version]-AE-[date].tar.gz。详看产品清单说明。

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

产品包说明
AAS-V10.0.10-SP10-AE-20251128.zip/AAS-V10.0.10-SP10-AE-20251128.tar.gz金蝶Apusic应用服务器V10.0.10标准版安装包

产品包说明:

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

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

文件说明
bin应用服务器启动、停止等脚本所在的目录
conf应用服务器配置文件所在的目录
lib应用服务器JAR文件所在的目录
logs应用服务器日志文件默认目录
plugins应用服务器插件所在的目录
webapps部署应用程序包的目录
webapps-javaee部署支持JakartaEE9.1及以下版本的应用程序包的目录
temp应用服务器临时文件存放的目录
work存放JSP编译后产生的class文件
license.xml产品包的授权文件

# 安装与卸载

# Linux环境下安装

​ 准备安装包AAS-V10.0.10-SP10-AE-20251128.zip或AAS-V10.0.10-SP10-AE-20251128.tar.gz。

​ 执行解压命令，如unzip AAS-V10.0.10-SP10-AE-20251128.zip 。解压即安装成功。

image73

# Linux环境下卸载

​ 删除安装目录${APUSIC_HOME}/下所有文件即可完成卸载操作。

# Windows环境下安装

​ 准备安装包AAS-V10.0.10-SP10-AE-20251128.zip或AAS-V10.0.10-SP10-AE-20251128.tar.gz。

​ 解压即安装成功。

image82

# Windows环境下卸载

​ 删除安装目录${APUSIC_HOME}/下所有文件即可完成卸载操作。

# 许可证授权

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

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

# 普通授权

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

image1

# 集中授权

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

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

apusic_acls_enable=true
apusic_acls_authUrls=172.24.4.166: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 172.20.140.17
1

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

Auth Code=SZTY829584211
1

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

# 部署应用与启动

# 在Linux环境下

将应用程序打包文件，如examples.war，放置${APUSIC_HOME}/webapps/目录下；进入安装目录${APUSIC_HOME}/bin。

image2

​

1、前端状态启动执行apusic.sh run。

image77

2、后端状态下启动执行startapusic.sh 。

image78

3、部署JakartaEE9.0及以下版本相关Web规范的应用，只需要把应用拷贝到 webapps-javaee 目录下即可自动部署。

# 在 Windows环境下

1、将应用程序打包文件，如examples.war，放置${APUSIC_HOME}\webapps\目录下；进入安装目录${APUSIC_HOME}\bin执行apusic.bat run。

2、后端状态下启动执行startapusic.bat 。

3、部署JakartaEE9.0及以下版本相关Web规范的应用，只需要把应用拷贝到 webapps-javaee 目录下即可自动部署。

# 停止运行

# 在Linux环境下

1、Ctrl + C

前端启动状态下，可以直接Ctrl + C退出，停止应用服务器。

2、kill进程

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

3、stopapusic.sh

在后端启动状态下，进入安装目录${APUSIC_HOME}/bin，执行stopapusic.sh，即可停止运行。

# 在 Windows环境下

1、Ctrl + C

前端启动状态下，可以直接Ctrl + C退出，停止应用服务器。

2、stopapusic.bat

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

3、停止进程

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

# 访问应用程序

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

编辑页面 (opens new window)

← 快速入门→