---
order: 2
navTitle: BES
---
# BES安装部署

[BES Application Server](https://www.bessystem.com/product/0ad9b8c4d6af462b8d15723a5f25a87d/info)（以下简称BES），是北京宝兰德软件股份有限公司自主研发的、具有自主知识产权的、遵循Java EE规范的应用服务器，支持最新的行业标准，SuccBI同样支持在BES部署，步骤如下：

\[\[toc]]

## BES控制台安装{#console-install}

### 解压安装包{#unzip}

解压`BES-CLUSTER-9.5.2.zip`到指定目录：

```sh
mkdir /usr/local/BES-CONSOLE
tar -zxvf BES-CLUSTER-9.5.2.tar.gz -C /usr/local/BES-CONSOLE
```

### 启动控制台{#start-console}

1. `BES-CONSOLE/bin` 下执行`initstore.sh`初始化产品。
2. `BES-CONSOLE/bin` 下执行`startManagement`启动管理控制台。

启动后访问http://TongWebIP:6900/console 进入BES控制台，初始用户名和密码分别是`admin`、`B#2008_2108#es`，界面如下图：

![控制台界面](./images/2020-12-28-13-46-20.png)

## BES管理框架搭建{#build-frame}

BES对资源和应用的管理分为三级：主机、节点、实例

- 主机：安装运行BES的设备，可以是一台物理机，虚拟机或其他提供主机服务的设备。
- 节点：每个实例都需要托管到一台物理计算机上，BES新建了一个轻量级的托管代理进程（即节点管理器）来管理应用服务器实例的生命
  周期。
- 实例：web应用运行的载体，类似于整个Tomcat

### 添加主机{#add-host}

在控制台左侧导航区点击`主机管理`进入`主机列表`界面，点击`添加`，填写部署服务器的连接信息

![添加主机](./images/2020-12-25-14-18-09.png)

添加完成后可在列表中点击进入该主机，点击左下角`ping`按钮，确认能够正常连接

![ping](./images/2020-12-28-11-28-42.png)

### 添加节点{#add-node}

在控制台左侧导航区点击`节点管理`进入`节点列表`界面，点击`新建`，填写`节点名称`、`节点目录`、`JAVA_HOME`，其他默认即可

![添加节点](./images/2020-12-25-14-32-41.png)

新建完成后可在节点列表查看该节点，此时状态为`未安装`、`未注册服务`，点击上方的`安装`、`注册服务`按钮，安装BES并将其注册为系统服务，服务器重启后，节点会自动启动并将节点下所有实例一起启动。

![节点列表](./images/2020-12-28-11-33-22.png)

### 新建实例{#add-example}

在控制台左侧导航区点击`实例管理`进入`实例列表`界面，点击`新建`，填写实例信息，注意此处我们选择独立实例，其他默认即可

![新建实例](./images/2020-12-28-11-35-36.png)

新建完成后可在实例列表查看该实例，勾选后启动该实例即可

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

在控制台左侧导航区点击**应用管理**>**常用应用**，进入应用列表界面，点击`部署`，选择`分发模式`，上传[版本更新](../../../whatsnew/README.md)中获取的war文件

![部署SuccBI应用](./images/2020-12-25-17-28-55.png)

点击`下一步`，在`部署目标`中选择[已创建的实例](#add-example)

![部署目标](./images/2020-12-25-17-43-01.png)

点击`下一步`，在`部署属性`中配置`应用名称`、`应用前缀(即上下文根)`，其他属性默认即可

![部署属性](./images/2020-12-25-17-45-13.png)

## 配置实例{#config-example}

应用部署完成后，还需要对实例进行配置，例如修改端口号、配置JVM参数等，在`实例列表`点击[已创建的实例](#add-example)，进入实例配置界面

![配置实例](./images/2020-12-28-10-13-47.png)

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

BES应用默认端口号为18080，可在**基本信息**>**系统属性**中，修改`http-listener-1_port`

![修改端口号](./images/2020-12-28-10-15-35.png)

### 配置启动参数{#env}

与[tomcat启动环境变量](./tomcat.md#env)一致，切换上方标签页至`JVM`配置

此处可配置JDK目录、JVM最大/最小内存等基础配置
![JVM配置1](./images/2020-12-28-09-40-27.png)

`JVM选项`可配置扩展参数，必须参数配置见下表，更多参数参考[环境变量](../basic-install/jvm-sys-properties.md)

| JVM参数 | 值 |
| :---- |:----|
|-Dfile.encoding|UTF-8|
|-Djava.awt.headless|true|
|-Dsucc.workdir|/path/to/workdir（请修改这个路径）|

![JVM选项](./images/2020-12-28-18-56-58.png)

## 完成部署{#complete}

实例配置完成后，按照提示重新启动实例，此时SuccBI应用也会同时启动，至此BES下的SuccBI部署已完成，访问http://BES-IP:端口号/上下文根即可访问SuccBI，进入初始化界面。

## 集群部署{#cluster}

由于控制台中可直接对主机进行管理，因此部署集群节点只需要新建主机即可，具体步骤如下：

1. 按照本文内容，以集群节点服务器连接信息新建[主机](#add-host)、[节点](#add-node)、[实例](#add-example)，并在新实例中部署SuccBI应用
2. 按照[集群部署](../../cluster/README.md)中的步骤，配置并加入集群即可

部署完成的应用目标状态应如下图，在两个实例中都为`已启动`
![集群部署目标状态](./images/2020-12-28-10-29-31.png)

## 常见问题{#faq}

### 无法访问管理控制台

请检查防火墙是否关闭或者开放了`6900`端口。

### 远程节点创建失败

请检查远程节点所在主机用户名密码是否正确，远程机器是否开启了`ssh`服务。