金蝶天燕(ApusicAAS)安装部署

ApusicAAS (opens new window)是金蝶天燕云计算股份有限公司自主研发的、具有自主知识产权的、全面支持JakartaEE8/9的技术规范的企业级应用服务器，SuccBI同样支持在ApusicAAS部署，步骤如下：

• ApusicAAS安装{#install}
  • 上传并执行安装程序{#upload-install}
  • 启动ApusicAAS{#start}
• 默认域配置{#mydomain-config}
  • 端口号修改{#port}
  • JVM启动参数配置{#JVM-config}
  • 内存分配{#memory-config}
• 部署SuccBI应用{#deploy-succbi}
• 完成部署{#complete}
• 集群部署{#cluster}
• 常见问题{#faq}
  • 部署失败{#compilation-errors}

ApusicAAS安装

上传并执行安装程序

上传ApusicAAS安装程序，如AAS-V10.zip至服务器机器，解压即可：

执行如下命令，解压即为安装：

unzip AAS-V10.zip

启动ApusicAAS

启动ApusicAAS需要进入ApusicAAS/aas/bin目录，执行如下命令启动默认域，初次启动默认域时，会要求为audit、admin、secure账户设置密码，按提示输入即可：

 ./asadmin start-domain

#出现如下文字内容即代表启动成功
This domain requires an administrative password to be set before
the domain can be started. Please specify an administrative password.
Enter an administrative password for user "audit">
Enter an administrative password for user "audit" again>
Password for User audit has change Successfully!

Enter an administrative password for user "admin">
Enter an administrative password for user "admin" again>
Password for User admin has change Successfully!

Enter an administrative password for user "secure">
Enter an administrative password for user "secure" again>
Password for User secure has change Successfully!
Waiting for mydomain to start .....
Successfully started the domain : mydomain
domain  Location: /data/ApusicAS/aas/domains/mydomain
Log File: /data/ApusicAS/aas/domains/mydomain/logs/server.log
Admin Port: 6848
Command start-domain executed successfully.

如需停止ApusicAAS，则执行以下命令停止默认域：

 ./asadmin stop-domain

启动后访问https://ApusicAASIP:6848/ 进入ApusicAAS控制台，登录用户使用初始化时设置的admin账户密码，界面如下图：

默认域配置

ApusicAAS支持在控制台中配置默认域，类似于在Tomcat中修改Tomcat/conf中的配置。

端口号修改

在控制台左侧导航区点击配置>server-config>HTTP服务>HTTP监听程序，ApusicAAS默认存在三个监听端口：

• admin-listener：控制台端口6848
• http-listener-1：应用HTTP协议端口6888
• http-listener-2：应用HTTPS协议端口6887

在控制台点击HTTP监听程序页面的对应监听名称，修改端口中的内容保存即可

JVM启动参数配置

在控制台左侧导航区点击配置>server-config>JVM设置，点击上方JVM选项切换到参数配置界面

点击添加JVM选项必须参数配置如下，更多参数参考环境变量

-Dfile.encoding=UTF-8
-Dsun.jnu.encoding=UTF-8
-DLANG=zh_CN.UTF-8
-Dsucc.workdir=/path/to/workdir
-Dsucc.localWebAddress=http://ip:port

TIP

• 一些其他的JVM配置，如-Djava.awt.headless=true、-Djava.net.preferIPv4Stack=true，在ApusicAAS已默认存在，可在列表中查看
• 在ApusicAAS中默认端口号为管理控制台的6848，而不是部署应用的监听端口，因此必须通过-Dsucc.localWebAddress来指定SuccBI的访问地址，否则在部署应用时会出现异常部署失败，例如-Dsucc.localWebAddress=http://192.168.88.100:6888

内存分配

ApusicAAS最大内存默认已配置，大小为1024m，位置在JVM选项页面列表下方，最小内存无默认配置需自行添加，最大内存和最小内存具体大小要按照自身需求以及服务器实际配置修改

部署SuccBI应用

在控制台左侧导航区点击应用程序，进入应用程序部署界面，点击部署

部署文件使用版本更新中获取的war文件，可选择从ApusicAAS前台上传文件，也可以选择提前将文件上传到服务器进行选择，上传完毕后，会自动选择类型为Web应用程序

以下属性按需配置：

• 上下文路径：即访问系统URL的上下文根
• 应用程序名称：部署后应用程序界面显示的名称
• 其他属性：均选择默认配置即可

设置虚拟服务器为默认的server后，点击右上角确定开始部署，部署完成后在应用程序界面新增了SuccBI应用

完成部署

启动参数配置完成后，重启ApusicAAS，此时SuccBI应用也会同时启动，至此ApusicAAS下的SuccBI部署已完成，点击SuccBI应用右侧的访问，会列出应用的两个访问地址，择一访问即可

集群部署

1. 按照本文内容，在集群节点服务器分别安装ApusicAAS并部署SuccBI
2. 按照集群部署中的步骤，配置并加入集群即可

常见问题

部署失败

问题原因：

在ApusicAAS中默认端口号为管理控制台的6848，而不是部署应用的监听端口，会导致部署错误

解决方法：

通过-Dsucc.localWebAddress来指定SuccBI的访问地址，可参考JVM启动参数配置