金蝶AAS (Apusic Application Server) v10 部署SuperMap iServer 2025 详细教程

一、软件版本

• 操作系统: CentOS Linux release 8.3.2011

• JDK:11.0.18（从iServer11.2.1开始，由于升级pac4j安全框架，JDK需要升级到11版本，如果不用iServer，可以还是使用JDK8版本）

• 金蝶AAS：AAS-V10-sp2

• SuperMap iServer 2025（12.0.0）https://support.supermap.com/DownloadCenter/DownloadPage.aspx?id=2967

  此外，部署iServer 2025对Linux系统有要求（GLIBC≥2.28、GCC≥8.3的 Linux(x64) 操作系统），具体请查看https://help.supermap.com/iServer/zh/Install_Uninstall/SystemConfig/softrequire.htm

二、金蝶AAS部署流程

2.1 安装JDK

2.1.1. 下载JDK到/opt下解压，并将目录重命名jdk

tar -zxf jdk-11.0.18_linux-x64_bin.tar.gz
mv jdk-11.0.18 jdk

2.1.2 将JDK环境变量配置环境变量中

编辑/etc/profile

vi /etc/profile

增加：

export JAVA_HOME=/opt/jdk
export JRE_HOME=/opt/jdk/jre
export CLASSPATH=$JAVA_HOME/lib:$JRE_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH

2.1.3 编辑完成检查JDK是否配置正确

看到以下信息JDK完成配置

[root@bms-86b7-0001 opt]# java -version
java version "11.0.18" 2023-01-17 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.18+9-LTS-195)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.18+9-LTS-195, mixed mode)

2.2 部署金蝶AAS

本次直接使用绿色版（免安装版）AAS-V10-sp2 ，上传软件包到/opt目录

2.2.1 给金蝶软件包赋予执行权限

chmod 755 AAS-V10-sp2.zip

2.2.2 解压软件包

unzip AAS-V10-sp2.zip -d /opt/AAS-V10

2.2.3 配置License

将获取的许可license.xml 放到 /opt/AAS-V10/ApusicAS/aas目录下

2.2.4 启动金蝶AAS

cd /opt/AAS-V10/ApusicAS/bin/
./asadmin start-domain

注：首次启动时需要设置 3 个管理员密码

2.2.5 访问管理控制台

打开浏览器, 输入金蝶AAS控制台地址：https://IP地址:6848/

输入之前设置的管理员密码：admin/[自己设置的密码]

2.2.6 停止金蝶AAS

cd /opt/AAS-V10/ApusicAS/bin/
./asadmin stop-domain

三、SuperMap iServer 部署

3.1 解压SuperMap iServer War包

unzip supermap-iserver-2025-war.zip

可以把本次所需的2个包拷贝到/opt/support_2025下，剩下的都删除
（support_2025为自己创建的目录，创建命令mkdir /opt/support_2025）

[root@bms-86b7-0001 support_2025]# pwd
/opt/support_2025
[root@bms-86b7-0001 support_2025]# ll
total 3259024
-rwxr-xr-x.  1 root root 1844759634 Jun 26 20:38 iserver.war
-rwxr-xr-x.  1 root root 1492466928 Jun 26 20:47 support_linux_x64.tar.gz

3.2 安装SuperMap iServer依赖

tar -zxf support_linux_x64.tar.gz 
cd support_linux_x64
./dependencies_check_and_install.sh install -y

3.3 配置试用许可

cd /opt/support_2025/support_linux_x64/SuperMap_License/Support
tar -xvf aksusbd-8.31.1.tar
cd aksusbd-8.31.1
./dinst

3.4 解压组件并重新配置环境变量

cd /opt/support_2025/support_linux_x64/objectsjava/
tar -zxf bin.tar.gz
mv Bin bin

编辑/etc/profile，

vi /etc/profile

增加UGO_HOME/SUPERMAP_ROOT/LD_LIBRARY_PATH/PATH，最终自定义环境变量如下：

export JAVA_HOME=/opt/jdk
export JRE_HOME=/opt/jdk/jre
export CLASSPATH=$JAVA_HOME/lib:$JRE_HOME/lib
export UGO_HOME=/opt/support_2025/support_linux_x64/objectsjava
export SUPERMAP_ROOT=/opt/support_2025/support_linux_x64
export LD_LIBRARY_PATH=$UGO_HOME/bin:$LD_LIBRARY_PATH
export PATH=$UGO_HOME/bin:$JAVA_HOME/bin:$PATH

然后检查是否缺少依赖，如下输出代表不缺少依赖，如果有缺少先补足依赖

cd /opt/support_2025/support_linux_x64/objectsjava/bin
source /etc/profile
ldd libWrapjC* | grep not

四、金蝶AAS配置

4.1 启动金蝶AAS

cd /opt/AAS-V10/ApusicAS/bin/
./asadmin start-domain

4.2 部署SuperMap iServer War包

打开浏览器, 输入金蝶AAS控制台地址：https://IP地址:6848/，使用admin用户登录后，点击应用程序，部署

选择iserver.war包，取消隐式 CDI，点击确定

此时部署成功后，iServer服务还是无法访问，服务报错404

4.3 解决依赖冲突问题

需要在SuperMap iServer应用目录/opt/AAS-V10/ApusicAS/aas/domains/mydomain/applications/iserver/WEB-INF文件夹中新增apusic-web.xml文件，

cd /opt/AAS-V10/ApusicAS/aas/domains/mydomain/applications/iserver/WEB-INF
vi apusic-web.xml

apusic-web.xml文件内容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<aas-web-app error-url=""><class-loader delegate="false"><property name="ignoreParentsFiles" value="true"></property><property name="ignoreClassPrefix" value="org.glassfish.jersey"></property><property name="ignoreResources" value="META-INF/services/org.glassfish.jersey.server.spi.ComponentProvider;META-INF/services/org.glassfish.jersey.servlet.internal.spi.ServletContainerProvider"></property></class-loader>
</aas-web-app>

4.4 重启金蝶AAS

cd /opt/AAS-V10/ApusicAS/bin/
# 停止
./asadmin stop-domain
# 启动
./asadmin start-domain

再次打开浏览器, 输入金蝶AAS控制台地址：https://IP地址:6848/，使用admin用户登录

五、验证SuperMap iServer

点击应用程序中部署的iserver

可以使用http或https方式访问（端口不同）

六、常见问题

1. JVM如何修改

2. 部署应用时，报Exception during lifecycle processing java.io.IOException: org.xml.sax.SAXParseException

答：AAS V10 对应用的描述文件 web.xml 是做严格的规范检测，如果文件内容有问题，如标签库的顺序没有符合标准，部署时会报错，但是能够通过设置，对 web.xml不校验或者检验后给出错误提示但是继续部署。

XML 验证选项说明：
·1.完全：报错并且不部署失败
·2.解析：报告错误，继续部署
·3.无：不报告错误，继续部署

3. 修改配置后，如何确定需要重启才生效，查看服务器状态，如显示必须重启时需要重启才能生效。

答：点击“必须重新启动”链接，会打开必须重新启动界面，界面上会显示修改了哪些属性，并且也能在界面上点击【重新启动】按钮重启应用服务器

4. 如何查看金蝶AAS版本

[root@bms-86b7-0001 bin]# cd /opt/AAS-V10/ApusicAS/bin
[root@bms-86b7-0001 bin]# ./asadmin version
NCLS-ADMIN-00010
Version string could not be obtained from Server [localhost:6848].
(Turn debugging on e.g. by setting AS_DEBUG=true in your environment, to see the details.)
Using locally retrieved version string from version class.
Version = Apusic Application Server  10.0.0  (build 202012221614)
Command version executed successfully.

（转发请注明出处：http://www.cnblogs.com/zhangyongli2011/ 如发现有错，请留言，谢谢）