---
order: 6
navTitle: 金蝶天燕(ApusicAAS)
---
# 金蝶天燕(ApusicAAS)安装部署

[ApusicAAS](https://www.apusic.com/list-117.html)是金蝶天燕云计算股份有限公司自主研发的、具有自主知识产权的、全面支持JakartaEE8/9的技术规范的企业级应用服务器，SuccBI同样支持在ApusicAAS部署，步骤如下：

\[\[toc]]

## ApusicAAS安装{#install}

### 上传并执行安装程序{#upload-install}

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

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

```sh
unzip AAS-V10.zip
```

### 启动ApusicAAS{#start}

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

```sh
 ./asadmin start-domain
```

```sh
#出现如下文字内容即代表启动成功
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，则执行以下命令停止默认域：

```sh
 ./asadmin stop-domain
```

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

![控制台首页](./images/2023-12-20-10-52-13.png)

## 默认域配置{#mydomain-config}

ApusicAAS支持在控制台中配置默认域，类似于在[Tomcat](./tomcat.md)中修改`Tomcat/conf`中的配置。

### 端口号修改{#port}

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

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

![端口号修改](./images/2023-12-20-11-03-47.png)

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

![HTTP](./images/2023-12-20-11-09-19.png)

### JVM启动参数配置{#JVM-config}

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

![JVM启动参数配置](./images/2023-12-20-11-12-22.png)

点击`添加JVM选项`必须参数配置如下，更多参数参考[环境变量](../basic-install/jvm-sys-properties.md)

```sh
-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`
  :::

### 内存分配{#memory-config}

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

![xmx内存分配](./images/2023-12-28-10-46-18.png)

![xms内存分配](./images/2023-12-28-11-23-37.png)

## 部署SuccBI应用{#deploy-succbi}

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

![部署应用](./images/2023-12-20-11-30-06.png)

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

![部署应用程序或模块](./images/2023-12-20-11-37-04.png)

以下属性按需配置：

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

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

![完成应用部署](./images/2023-12-20-11-44-22.png)

## 完成部署{#complete}

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

![访问应用地址](./images/2023-12-20-11-46-35.png)

## 集群部署{#cluster}

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

## 常见问题{#faq}

### 部署失败{#compilation-errors}

![部署失败](./images/2023-12-20-11-51-02.png)

**问题原因：**

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

**解决方法：**

通过`-Dsucc.localWebAddress`来指定SuccBI的访问地址，可参考[JVM启动参数配置](#JVM-config)