常见问题

# 功能和概念相关

# AASv10 有哪些功能？

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

# AASv10 有哪些版本？

AASv10 有企业版、安全加固版、行业专版、敏捷版，不同版本支持的功能和服务会有差异，对应的价格也会不同。

  • 企业版：支持完整的JakartaEE规范，提供集中管控功能，常用于集中管控场景。
  • 安全加固版：支持完整的JakartaEE规范，提供集中管控以及实时安全防护功能，常用于安全防护要求高的应用部署场景。
  • 行业专版：支持完整的JakartaEE规范，提供集中管控等功能，支持大客户场地授权、订阅授权，常用于大客户专版场景。
  • 敏捷版：支持JakartaEE Web规范，支持统一配置、统一日志；分为容器版、嵌入式版，行业专版，容器版主要应用于容器平台，如K8s等；嵌入式版主要为SpringBoot开发工程；行业专版主要用于大客户场地授权、订阅授权。

# 兼容性相关

# AASv10支持哪些JDK？

AASv10兼容各主流JDK，常用版本建议在JDK8以上。推荐使用JDK8。

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

# AASv10支持哪些操作系统？

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

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

# AASv10支持哪些数据库？

AASv10兼容各主流数据库，如MySQL、Oracle、SQLServer、DB2、达梦、人大金仓、神舟、高斯等等。

# 操作相关

# 如何安装、启动AASv10？

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

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

# 如何停止、卸载AASv10？

停止AASv10的方法有多种通常进入安装目录${APUSIC_HOME}/bin，执行asadmin stop-domain 即可完成启动默认域操作。其他停止方式参考《金蝶Apusic应用服务器v10安装部署》。

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

# 如何访问AASv10管控平台？

通常情况下，浏览器直接访问https://[IP]:6848 即可进入管控平台登录页面。

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

AASv10默认有三个角色管理员用户，分别是系统管理员用户admin、安全配置管理员用户secure、安全审计管理员用户audit，默认密码为初始化时设置的密码。

修改用户密码方法如下：

​ 方法 1: 如果某个非安全管理的用户，如 admin 密码忘记了，通过安全管理员登录管控平台，为该用户重置密码。

​ 方法 2: 如果某个管理员包括安全管理员和系统管理员密码忘记了，但是其他用户密码知道，就可以拷贝安装路径下 mydomain/config/admin-keyfile 中的其他用户的密码，替换需要修改密码的 用户的密码。需要重启系统才生效。

​ 方法 3: 如果某个管理员包括安全管理员密码忘记了，系统管理员的密码还记得，使用系统管理员 如admin 登陆管理，进入【配置管理】-【server-config】-【安全服务】-【安全域】-【admin-realm】-【管理用户】页面，点击用户名称编辑用户，可以修改用户密码。

​ 方法 4: 修改 mydomain/config/admin-keyfile 文件里面对应的用户的密码，使用如下密码替换"{SSHA256}iU4Ef2uGWYh3V+BQjpW5f8BTbgGWzKp7pfrNU020Nu2l9YLEwCWOpA=="，重置为空密码，重启系统，需要重新设置密码。

# 如何指定Java环境？

编辑${APUSIC_HOME}/config/asenv.conf, 增加 AS_JAVA 变量：

AS_JAVA=/opt/java/jdk1.8.0_281
1

保存后启动AAS。

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

方法一：系统管理员登录管控平台，进入【配置管理】-【server-config】-【JVM配置】-【JVM选项】，修改“-Xmx”的值，保存，重启AAS。

方法二：修改配置文件domain.xml中的jvm-options项 -Xmx的值，保存，启动AAS。

# 如何修改默认端口？

方法一：修改配置文件domain.xml，network-listeners对应的network-listener中的“port”的值，保存，启动AAS。

方法二：系统管理员登录管控平台，进入【配置管理】-【server-config】-【网络配置】-【监听程序】，修改对应监听程序的端口号，保存，重启AAS。

# 如何开启国密配置？

AAS支持配置国密证书。详细信息参考《金蝶Apusic应用服务器v10用户手册》。

​ 1.开启国密支持。domain.xml 中 java-config 的<jvm-options>-Dcom.apusic.security.ssl.EnableGMTLS=false</jvm-options>中的 false 改为 true。

​ 2.配置证书信息。domain.xml 文件中 network-config/protocols/protocol 子元素。在所需要的端口对应的 protocol 中，设置 security-enabled 属性为"true"，添加 ssl 子元素，并设置 sm11-enabled 属性为"true"，并添加对应的 keystore, truststore 相关属性。如下所示:

 <protocol name="http-listener-2" security-enabled="true">
 <http max-connections="250" default-virtual-server="server">
 <file-cache></file-cache>
 </http>
 <ssl classname="com.sun.enterprise.security.ssl.ApusicSSLImpl"
 sm11-enabled="true"
 key-store-type="PKCS12"
 key-store="${com.apusic.aas.instanceRoot}/config/keystore.p12"
 key-store-password="fdjaio%^&2123f"
 client-auth="want"></ssl>
 </protocol>
1
2
3
4
5
6
7
8
9
10
11

​ 3.启动AAS。

# 如何修改线程池大小？

方法一：可进入配置文件domain.xml，修改thread-pools中对应的thread-pool的对应参数，如"max-thread-pool-size"为最大线程池大小，保存，启动AAS。

方法二：系统管理员登录管控平台，进入【配置管理】-【server-config】-【线程池】，修改对应的线程池信息，保存，重启AAS。

# 如何部署应用程序？

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

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

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

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

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

# 出现乱码问题怎么办？

问题一: 访问应用的 html 文件，出现中文乱码问题。

解决方法:

需要在 domains/mydomain/config/default-web.xml 中加入一个 fileEncoding 项。

<init-param>
    <param-name>fileEncoding</param-name>
    <param-value>utf-8</param-value>
</init-param>
1
2
3
4

问题二: 应用使用 JSP include html 文件，访问应用时中文出现乱码。

解决方法:

需要在 web.xml 中设置 html 文件的编码。

<jsp-config>
    <jsp-property-group>
        <display-name>JSPConfiguration</display-name>
        <url-pattern>*.html</url-pattern>
        <page-encoding>UTF-8</page-encoding>
    </jsp-property-group>
</jsp-config>
1
2
3
4
5
6
7

通用解决方法:

添加 apusic-web.xml 到应用的 WEB_INF 目录下。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE aas-web-app PUBLIC "-//Apusic.com//DTD Apusic Application Server 10.1 Servlet3.0//EN" "http://apusic.com/dtds/apusic-web-app_3_0-1.dtd">
<aas-web-app>
    <class-loader delegate="false"/>
    <locale-charset-info>
        <parameter-encoding default-charset="UTF-8"/>
    </locale-charset-info>
</aas-web-app>
1
2
3
4
5
6
7
8

# 如何配置日志信息？

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

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

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

# 修改日志级别

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

方法一：可进入配置文件logging.properties，修改对应属性的"level"值 ，可设置值为ALL/OFF/FINEST/FINER/FINE/CONFIG/INFO/WARNING/SEVERE/ALERT/EMERGENCY。保存，启动AAS。

方法二：系统管理员登录管控平台，进入【配置管理】-【server-config】-【日志配置】-【日志级别】，修改对应值，保存。一般实时生效。

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

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

方法一：可进入配置文件logging.properties，修改对应"com.apusic.enterprise.server.logging.ApusicFileHandler.file"值 ，目录文件需要有权限。保存，启动AAS。

方法二：系统管理员登录管控平台，进入【配置管理】-【server-config】-【日志配置】-【一般信息】，修改”日志文件“值，保存，重启AAS。

# 修改日志文件大小

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

方法一：可进入配置文件logging.xml，修改对应"com.apusic.enterprise.server.logging.ApusicFileHandler.rotationLimitInBytes"值或"com.apusic.enterprise.server.logging.ApusicFileHandler.rotationTimelimitInMinutes" 。保存，启动AAS。

方法二：系统管理员登录管控平台，进入【配置管理】-【server-config】-【日志配置】-【一般信息】，修改"文件滚动限制"或"文件滚动时间限制"值，保存，重启AAS。

# 如何清除应用的缓存？

删除${DOMAIN_HOME}/osgi-cache/felix目录下面相关的文件。

# 如何设置类加载顺序？

AAS支持设置类加载顺序，详细信息请参考《金蝶Apusic应用服务器v10用户手册》。

一般设置方法为部署应用时，设置属性"类加载策略"，勾选父类加载器优先，不勾选子类加载器加载。

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

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

image4.png

如果是节点出现授权问题，可查看日志，日志会打印出对应的特征码，拷贝特征码提供至天燕对接人员重新申请对应许可证。

编辑页面 (opens new window)

← 功能清单→