常见问题

# 功能和概念相关

# AASv9 有哪些功能？

AAS V9.0全面支持JakartaEE8技术规范，提供满足该规范的Web容器、EJB容器以及WebService容器等。主要由Web模块、EJB模块、基础模块、管理模块、其他模块等组成，同时具备可扩展性、兼容性和安全性。

# AASv9 有哪些版本？

AASv9 有标准版、企业版、安全加固版、行业专版、国防专版和专用机版，不同版本支持的功能和服务会有差异，对应的价格也会不同。

标准版：支持完整的JakartaEE8规范，提供集中管控功能，常用于集中管控场景。
三元分立版：支持完整的JakartaEE8规范，提供集中管控功能，常用于用户权限分立场景。
企业版：支持完整的JakartaEE8规范，提供集中管控、集群功能，常用于集中管控或需要集群实例场景。
安全加固版：支持完整的JakartaEE8规范，提供集中管控、集群管理以及实时安全防护功能，常用于安全防护要求高的应用部署场景。
行业专版：支持完整的JakartaEE8规范，提供集中管控等功能，支持大客户场地授权、订阅授权，常用于大客户专版场景。
国防专版：支持完整的JakartaEE8规范，提供集中管控等功能，同时不限IP授权，常用于军队、军工行业场景。
专用机版：支持完整的JakartaEE8规范，提供加签名的企业版功能；分为A版、B版，A版常用于普通授权专用机，B版常用于不限IP授权场景。

# 兼容性相关

# AASv9支持哪些JDK？

AASv9兼容各主流JDK，常用版本建议在JDK6-11之间。推荐使用JDK8。

Oracle JDK 6+
Open JDK 6+
IBM JDK 6+
毕昇 JDK 8+

# AASv9支持哪些操作系统？

AASv9兼容各主流操作系统，如下：

Linux：
- 国产操作系统：银河麒麟系列、中标麒麟系列、普华、中科红旗、深度等
- RedHat系列
- CentOS系列
- Suse Linux系列
Windows：
- Windows 7系列
- Windows 8系列
- Windows 10系列
- Windows 2003系列
- Windows 2008系列
- Windows 2012系列
Unix：
- HP Unix系列
- IBM AIX系列
- Solaris系列

# AASv9支持哪些数据库？

AASv9兼容各主流数据库，如MySQL、Oracle、SQLServer、DB2、达梦、人大金仓、神舟、高斯等等。通常情况下，数据库具备远程访问服务，且准备有对应的驱动文件，即可在AAS的【数据源】模块中配置数据源信息。

# 操作相关

# 如何安装、启动AASv9？

根据获取的安装包类型，使用对应方法安装；通常为AAS-V9.0.zip，将安装包拷贝至对应目录，解压即可完成安装。其他安装包类型参考《金蝶Apusic应用服务器v9安装部署》。

启动AASv9的方法有多种，通常为进入安装目录${APUSIC_HOME}/domains/mydomain/bin，执行startapusic.sh即可完成启动默认域操作。其他启动方式参考《金蝶Apusic应用服务器v9安装部署》。

# 如何停止、卸载AASv9？

停止AASv9的方法有多种，前端启动的话，通常为Ctrl + C即可完成停止域操作。其他停止方式参考《金蝶Apusic应用服务器v9安装部署》。

根据安装方式，卸载AASv9的方法有多种，压缩包解压方式安装的话，通常为删除整个安装目录即可完成卸载操作。其他卸载方式参考《金蝶Apusic应用服务器v9安装部署》。

# 如何访问AASv9管控平台？

通常情况下，浏览器直接访问http://[IP]:6888/admin 即可进入管控平台登录页面。需注意，管控默认为localhost可以访问，不能进行远程访问。如果需要远程其他地址访问，则需要配置系统参数-Dcom.apusic.webtool.allowHosts=172.24.5.66，值172.24.5.66是可以访问管控的ip地址，多个地址用逗号分隔,也可以在vm.options文件中写：com.apusic.webtool.allowHosts=172.24.5.66。如果是三元分立版本，参数改为com.apusic.admin.allowHosts。

# 如何设置和修改用户密码？

AASv9默认带有系统管理员角色用户，默认系统管理员用户为admin，初始化时需要设置用户密码，该密码需要牢记。如果是三元分立版本，默认有三个角色管理员用户，分别是超级系统管理员用户sysadmin、安全配置管理员用户security、安全审计管理员用户auditor，默认密码为1qazXSW@。

一般情况下，修改密码需要进入管控平台，【用户组】进行修改；三元分立版本需要使用安全配置管理员登录，在【用户管理】模块修改。注意，如果是初始管理员忘记密码，需要删除store/groups.db、users.db文件，重新启动初始化用户数据库；三元分立版本为SecureConsole/ 文件。

# 如何指定Java环境？

编辑${APUSIC_HOME}/bin/目录下的setenv(Windows为setenv.cmd)，JAVA_HOME=your_java_home_dir ：

JAVA_HOME=/opt/java/jdk1.8.0_281

保存后启动AAS。

# 如何修改运行内存大小？

方法一：系统管理员登录管控平台，进入【系统参数】，修改“启动最大堆内存”“启动最小堆内存”，保存，重启AAS。

方法二：修改启动文件startapusic(Windows为startapusic.cmd)，MEMORY_JVMOPTS，保存，启动AAS。

# 如何修改默认端口？

HTTP的默认端口为6888，HTTPS默认端口为6889。修改方法：

方法一：可进入配置文件apusic.conf，修改"com.apusic.net.Muxer"中的对应“PORT”或“SecurePort”的值，保存，启动AAS。

方法二：系统管理员登录管控平台，进入【服务面板】-【多路复用】，修改对应的端口值，保存，重启AAS。

# 如何开启HTTPS？

AAS默认带有安全证书以及配置值，开启HTTPS方法：

方法一：可进入配置文件apusic.conf，修改"com.apusic.net.Muxer"中的对应ATTRIBUTE ，NAME="SSLEnabled" ，将值改为"True"，保存，启动AAS。

方法二：系统管理员登录管控平台，进入【服务面板】-【多路复用】，勾选“开启SSL”，保存，重启AAS。

如果要修改证书信息，可对应修改参数值。详细信息参考《金蝶Apusic应用服务器v9用户手册》。

# 如何开启国密配置？

AAS支持配置国密证书。

需在apusic.conf配置文件中的Muxer服务中添加SSLProtocol属性，设置值为："SMv1.1"(旧版本为SM1.1), 并分别配置秘钥库和信任库。

<SERVICE CLASS="com.apusic.net.Muxer">
    <ATTRIBUTE NAME="Port" VALUE="6888"/>
    <ATTRIBUTE NAME="Backlog" VALUE="1024"/>
    <ATTRIBUTE NAME="Timeout" VALUE="30"/>
    <ATTRIBUTE NAME="LookAheadTimeout" VALUE="30"/>
    <ATTRIBUTE NAME="MaxWaitingClients" VALUE="200"/>
    <ATTRIBUTE NAME="WaitingClientTimeout" VALUE="5"/>
    <ATTRIBUTE NAME="SecurePort" VALUE="6889"/>
    <ATTRIBUTE NAME="MutualAuthPort" VALUE="6887"/>
    <ATTRIBUTE NAME="NeedClientAuth" VALUE="false"/>

    <ATTRIBUTE NAME="SSLEnabled" VALUE="true"/>
    <ATTRIBUTE NAME="SSLProtocol" VALUE="SMv1.1"/>

    <ATTRIBUTE NAME="KeyStore" VALUE="config/keystore.p12"/>
    <ATTRIBUTE NAME="KeyStoreType" VALUE="PKCS12"/>
    <ATTRIBUTE NAME="KeyPassword" VALUE="123456"/>
    
    <ATTRIBUTE NAME="TrustStore" VALUE="config/trust.p12"/>
    <ATTRIBUTE NAME="TrustStoreType" VALUE="PKCS12"/>
    <ATTRIBUTE NAME="TrustStorePassword" VALUE="123456"/>
</SERVICE>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

2.使用./startapusic.sh gm以国密模式启动AAS应用服务器。

# 如何修改线程池大小？

方法一：可进入配置文件apusic.conf，修改SERVICE"HTTPHandler"中的对应ATTRIBUTE ，保存，启动AAS。

方法二：系统管理员登录管控平台，进入【服务面板】-【HTTPHandler】，修改值，保存，重启AAS。

# 如何部署应用程序？

AAS提供多种部署应用程序方法，详看《金蝶Apusic应用服务器v9用户手册》。常用方法如下：

方法一：系统管理员登录管控平台，进入【应用管理】，“部署应用”。

方法二：将应用程序包拷贝至安装目录${DOMAIN_HOME}/applications 即可完成自动部署。

# 部署引用资源的应用提示找不到资源怎么办？

通常情况下，需要引用资源，如数据源、JMS消息等资源的应用程序，在部署应用程序前，需要先将资源环境配置完成，再部署应用程序，不然会出现找不到资源情况。需注意，JNDI名称需要对应。

# 出现乱码问题怎么办？

# 常用Apusic的解决方案

# Path和Query出现乱码

可以设置apusic.conf 下的webservice服务，增加属性URIEncoding，取值根据实际情况选择。如下选择了GBK的配置:

<ATTRIBUTE NAME="URIEncoding" VALUE="GBK" />

# 响应的设置

如果表单中通过Post方式提交的中文数据存在乱码，则可以在应用的web.xml里设置参数request.charsetencoding，取值根据实际情况选择。例子如下:

<context-param>
    <param-name>request.charsetencoding</param-name>
    <param-value>GBK</param-value>
</context-param>

1
2
3
4

如果表单数据通过get方式提交，则其内容的编码和Path及Query内容编码处理一致。

# JSP/servlet中解析form提交的汉字得到的是乱码

原因:

这种情况出现的可能性很多，如用户自己加了编码过滤器等，但根本原因是服务器解析Query和Data的参数时，没有指定对编码。

解决方法:

使用request.getParameter()前，先用request.setCharacterEncoding()指定编码，Apusic会根据设定的编码格式去编码Query 和Data，（Tomcat默认只是将这个值作为Query的编码）。最佳实践为写一个SerlvetFilter用这个方法统一设置编码格式。
new String("中文".getBytes("ISO-8859-1"),YOUR_ENCODING);

Tips:这里使用ISO-8859-1，并不是因为HTTP协议采用ISO-8859-1，而是因为ISO-8859-1是单字节编码，用它去getBtyes()，可以将不进行编码地将字节取出。

Apusic特有设置：见Apusic的解决方案一节

# 浏览器中看到的 Jsp/Servlet 页面出现乱码

原因:

可能有几种情况：

request.getParameter()获得的值本身就没正确编码。
使用了不合适的编码，如用ISO-8859-1去编码汉字。
响应头中没有Context-Type或Context-Type没有指定编码，浏览器不知道用何种编码显示页面。

解决方法:

response.setContentType("text/html;GBK"); response.setCharacterEncoding ("UTF-8"); response.setLocale(Locale.CHINESE);这三个方法可以设置Context-Type中的编码。
Apusic特有设置：见Apusic的解决方案一节

# 中文路径无法访问

原因:

应用服务器没有判断对Path的编码。如果Path采用UTF-8一般不会出现这种情况，而如果是其他编码格式，比如用户自己编码了，那么就可能出现找不到路径的情况。

解决方法:

采用英文路径。
Apusic特有设置：见Apusic的解决方案一节

# JSP源代码中的中文，编译后显示成乱码

原因:

JSP源文件采用的GBK编码,而编码时却指定UTF-8编码去编译。

解决方法:

指定编译使用的编码。指定的方式有两种，一种是在JSP页面的首行，加上<%@ page contentType="text/html;charset=GBK" pageEncoding="GBK" %>，其中pageEncoding指定的就是编码时采用的编码。另一种是在web.xml设置，类似于

<jsp-config>
    <jsp-property-group>
        <url-pattern>/*</url-pattern>
        <page-encoding>GBK</page-encoding>
    </jsp-property-group>
</jsp-config>

1
2
3
4
5
6

# 如何配置日志信息？

AAS的日志配置文件在conf/logging.xml中，可修改对应属性。

方法一：可进入配置文件logging.xml，修改对应参数值，保存，启动AAS。

方法二：系统管理员登录管控平台，进入【日志配置】，修改值，保存，重启AAS。

# 修改日志级别

AAS支持修改日志级别，详细信息请参考《金蝶Apusic应用服务器v9用户手册》。

方法一：可进入配置文件logging.xml，修改对应handler的"level"值，可设置值为ALL/DEBUG/INFO/NOTICE/WARNING/ERROR/FATAL。保存，启动AAS。

方法二：系统管理员登录管控平台，进入【日志配置】，修改值，保存，重启AAS。

# 修改日志文件名称或输出目录位置

AAS支持修改日志文件名称或输出目录位置，详细信息请参考《金蝶Apusic应用服务器v9用户手册》。

方法一：可进入配置文件logging.xml，修改对应"pattern"值，目录文件需要有权限。保存，启动AAS。

方法二：系统管理员登录管控平台，进入【日志配置】，修改”日志文件输出“中的”文件名产生模式“值，保存，重启AAS。

# 修改日志文件大小

AAS支持修改日志文件大小，详细信息请参考《金蝶Apusic应用服务器v9用户手册》。

方法一：可进入配置文件logging.xml，修改对应"limit"值。保存，启动AAS。

方法二：系统管理员登录管控平台，进入【日志配置】，修改”日志文件输出“中的”输出最大值(Byte)“值，保存，重启AAS。

# 如何清除应用的缓存？

删除deploy目录下面相关的文件。

# 许可证授权码过期或无效怎么办？

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

可以运行mydomain/bin目录下命令startapusic获取特征码，类似格式:

startapusic -ac [ethname or ip]

其中[ethname or ip]表示可以输入ip地址或者mac地址的名称，如可以输入常用ip地址172.24.1.116作为参数获取软件特征码(适用windows、linux)：

startapusic –ac 172.24.1.116

输出格式如下，Auth Code=右边的为软件特征码：

Auth Code=SZTY263537626

获取到特征码后再申请许可证。

编辑页面

← 产品动态等级保护指南→