---
order: 3
navTitle: 东方通(TongWeb)
---
# 东方通(TongWeb)安装部署

[TongWeb](http://m.tongtech.com/Application-Support/Application-Support-17.html)是北京东方通科技股份有限公司自主研发的、具有自主知识产权的、遵循JavaEE7 Web Profile规范的企业级应用服务器，SuccBI同样支持在TongWeb部署，步骤如下：

\[\[toc]]

## TongWeb安装{#install}

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

上传TongWeb安装程序，如`Install_TW7.0.4.1_Enterprise_Liunx.bin`至服务器机器，并赋予可执行权限：

```sh
chmod +x Install_TW7.0.4.1_Enterprise_Liunx.bin
```

执行如下命令，按照指示信息开始安装：

```sh
./Install_TW7.0.4.1_Enterprise_Liunx.bin –i console
```

当日志中出现如下一行，没有异常信息，说明TongWeb启动成功：

```sh
[2020-12-28 11:57:24] [INFO] [core] [TongWeb server startup complete in 7839 ms.]
```

### 启动TongWeb{#start}

启动TongWeb需要进入`TongWeb/bin`目录，执行如下命令：

```sh
 ./startservernohup.sh
```

相同的，执行`stopserver.sh`即可停止TongWeb

启动后访问http://TongWebIP:9060/console 进入TongWeb控制台，默认用户名、密码为`thanos`、`thanos123.com`，界面如下图：

![控制台首页](./images/2020-12-25-10-19-30.png)

## WEB容器配置{#container-config}

TongWeb支持在控制台中配置WEB容器，类似于在[Tomcat](./tomcat.md)中修改`Tomcat/conf`中的配置。

### 字符集配置{#haracter-set}

在控制台左侧导航区点击**WEB容器配置**>**容器配置**，将`默认请求参数解码字符集`、`默认应答编码字符集`均修改为`UTF-8`

![容器配置](./images/2020-12-25-11-02-57.png)

在控制台左侧导航区点击`HTTP通道管理`，选择`tong-http-listener`，在`其他设置`中将`URL编码格式`修改为`UTF-8`

![HTTP通道管理](./images/2020-12-25-11-03-46.png)

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

同样在`tong-http-listener`中，修改`监听端口`即可，默认为**8088**

![端口号修改](./images/2020-12-28-11-01-26.png)

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

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

![部署应用](./images/2020-12-25-10-23-49.png)

`部署文件`选择[版本更新](../../../whatsnew/README.md)中获取的war文件，上传完毕后，点击`开始部署`，进入应用属性配置界面

![应用属性配置](./images/2020-12-25-10-26-25.png)

以下属性按需配置：

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

点击`下一步`，设置虚拟主机为默认的`server`后，即可完成部署，在`应用管理`界面新增了SuccBI应用

![完成应用部署](./images/2020-12-25-10-39-46.png)

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

与[tomcat启动环境变量](./tomcat.md#env)一致，在控制台左侧导航区点击`启动参数配置`，在`JVM参数`中配置JVM内存

![JVM内存](./images/2020-12-28-14-28-15.png)

在`其他JVM参数`中配置JVM扩展参数，必须参数配置如下，更多参数参考[环境变量](../basic-install/jvm-sys-properties.md)

```sh
-Dfile.encoding=UTF-8
-Djava.awt.headless=true
-Dsucc.workdir=/path/to/workdir（请修改这个路径）
-Dsucc.localWebAddress=http://ip:port
```

![JVM参数](./images/2020-12-25-11-22-08.png)

:::tip
在TongWeb中默认端口号为管理控制台的`9060`，而不是部署应用的监听端口，因此必须通过`-Dsucc.localWebAddress`来指定SuccBI的访问地址，否则在系统中会出现无法查看仪表板的情况，例如`-Dsucc.localWebAddress=http://192.168.3.50:8088`
:::

## 完成部署{#complete}

启动参数配置完成后，重启Tongweb，此时SuccBI应用也会同时启动，至此TongWeb下的SuccBI部署已完成，访问http://TongWebIP:端口/上下文根 进入初始化界面

## 集群部署{#cluster}

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

## 常见问题{#faq}

### 请求路径出现乱码{#error-codes}

![请求路径出现乱码](./images/2020-12-28-14-29-55.png)

**问题原因：**

TongWeb容器中的默认字符集均为`GBK`，SuccBI使用`UTF-8`，导致请求路径转码不正确

**解决方法：**

手动修改TongWeb字符集配置至`UTF-8`，可参考[字符集配置](#haracter-set)

### 可视化查看界面出现编译错误{#compilation-errors}

![编译错误](./images/2020-12-28-14-32-18.png)

**问题原因：**

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

**解决方法：**

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