安装部署

# 概述

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

# 基本介绍

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

# 术语

AAS：金蝶Apusic应用服务器

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

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

# 版本变更说明

本文档根据产品实际更新情况同步更新，最新版本将会包括历史版本内容或作出对应的修改说明。

日期	手册版本	适用产品	更新说明
2023年12月	V10P8A02F01	AAS标准版 V10	更新许可证授权码获取方式

# 系统环境要求

# 平台环境

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

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

操作系统	说明
Windows	Windows7、Windows10、Windows Server
Linux	CentOS、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	应用服务器配置文件所在的目录
lib	应用服务器JAR文件所在的目录
logs	应用服务器日志文件默认目录
plugins	应用服务器插件所在的目录
webapps	部署应用程序包的目录
temp	应用服务器临时文件存放的目录
work	存放JSP编译后产生的class文件
license.xml	产品包的授权文件

# 安装与卸载

# Java环境

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

[root@myRabbitA 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"

# 安装

准备安装包AAMS-V10.tar.gz或AAMS-V10.zip。

解压即安装成功。

执行 tar -zxvf AAMS-V10.tar.gz
或 unzip AAMS-V10.zip

1
2

# 卸载

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

# 许可证授权

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

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

# 普通授权

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

# 集中授权

集中授权指连接授权中心，进行统一授权。需要先搭建金蝶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

打印特征码信息，类似如下，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

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