快速入门

# 概述

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

# 产品介绍

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

# 产品包介绍

产品包包括以下内容：

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

# 术语

AAS：金蝶Apusic应用服务器

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

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

# 环境准备

# 平台环境

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

# 系统环境

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

# 安装与卸载

# Linux环境下安装

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

解压即安装成功。

# Linux环境下卸载

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

# Windows环境下安装

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

解压即安装成功。

# Windows环境下卸载

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

# 许可证授权

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

许可证位置为${APUSIC_HOME}/license.xml。

# 部署应用程序

本章节描述该产品快速部署应用程序操作。

# 前提条件

准备Web应用程序文件。

已安装并启动金蝶Apusic应用服务器。

# 操作步骤

# 在Linux环境下

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

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

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

# 在 Windows环境下

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

# 访问应用程序

访问http://[IP]:6888/[CONTEXT]。如下：

# 配置数据源

本章节描述该产品配置数据源操作。

# 前提条件

已安装金蝶Apusic应用服务器。

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

# 操作步骤

1.在${APUSIC_HOME}/config/apusic.conf中配置endpoint，如下：

<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="root"
    password="root" maxTotal="100" maxIdle="30" maxWaitMillis="10000" />

1
2
3

2.将数据源对应版本的驱动放置${APUSIC_HOME}/lib/ 目录下。

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

3.启动应用服务器，访问http://[IP]:PORT]/[CONTEXT]。

# 配置HTTPS

本章节描述该产品配置HTTPS操作。

# 证书格式为 JKS

# 前提条件

已安装金蝶Apusic应用服务器。

准备证书，如示例证书 arsp_server_keystore.jks。

# 操作步骤

1.在${APUSIC_HOME}/config/apusic.conf中配置endpoint，如下：

<endpoint name="ams-https" port="8443" protocol="HTTP/1.1" SSLEnabled="true" executor="http-thread-pool">
    <SSLHostConfig>
        <Certificate certificateKeystoreFile="conf/cert/arsp_server_keystore.jks" certificateKeystoreType="JKS"
            certificateKeystorePassword="changeit" />
    </SSLHostConfig>
</endpoint>

1
2
3
4
5
6

2.添加server引用：

    <servers>
        <server name="ams-server" services="ams-service" endpoints="ams-https
        " executors="http-thread-pool"/>
    </servers>

1
2
3
4

3.启动应用服务器，访问https://[IP]:8443/[CONTEXT]。

# 证书格式为 PEM

# 前提条件

已安装金蝶Apusic应用服务器。

准备证书，如示例证书 private_key.pem、public_key.pem、chain.pem。

# 操作步骤

1.在${APUSIC_HOME}/config/apusic.conf中配置endpoint，如下：

<endpoint name="ams-https" port="8443" protocol="HTTP/1.1" SSLEnabled="true" executor="http-thread-pool">
    <SSLHostConfig>
        <Certificate certificateKeyFile="conf/cert/private_key.pem" certificateKeyPassword="changeit"
            certificateFile="conf/cert/public_key.pem" certificateChainFile="conf/cert/chain.pem" type="RSA" />
    </SSLHostConfig>
</endpoint>

1
2
3
4
5
6
7

2.再添加server引用：

    <servers>
        <server name="ams-server" services="ams-service" endpoints="ams-https" executors="http-thread-pool"/>
    </servers>

1
2
3

3.启动应用服务器，访问https://[IP]:8443/[CONTEXT]。

# 日志配置

# 系统日志

在${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/ 。

编辑页面

← 安装部署用户手册→