---
url: /v6.2/tong-web-server-config.md
---
## 东方通 Webserver 配置说明

版本：TongWeb7.0.4.9_Enterprise_Linux

东方通 Webserver 可作为 hengshi 组件的容器使用，衡石服务内部使用的 Metadb、Engine、redis、minio、flink 组件需要自行准备，后续在配置项中完成相关配置

### 控制台配置

#### 部署前准备

1. 准备 Metadb、Engine、redis、minio、flink 服务组件，并获取衡石部署 War 包文件资源。

2. 准备 Java 运行时环境
   ![](/images/web-server/tong-web-java-env-config.png)

3. 配置 tongweb jvm 衡石内部使用组件配置信息
   ![](/images/web-server/tong-web-jvm-config.png)
   本图中相关配置信息参考根据实际的服务地址配置下列信息

```shell
# Metadb 连接信息
-DDB_URL=jdbc:postgresql://10.10.10.x:54320/hengshi?user=hengshi&password=hengshi202020
# Syslog 日志数据库连接信息
-DLOG_DB_URL=jdbc:postgresql://10.10.10.x:54320/syslog?user=syslog&password=syslog

# 引擎配置信息
-DENGINE_TYPE=greenplum
-DENGINE_DB=jdbc:postgresql://10.10.10.x:15432/hengshi?user=hengshi&password=hengshi202020

# redis 配置连接信息
-DREDIS_ADDRESS=redis://10.10.10.x:6379
-DREDIS_PASSWORD=foobared
-DREDIS_DATABASE=0

# minio 服务配置新
-DMINIO_ACCESS_KEY=hengshi
-DMINIO_SECRET_KEY=hengshi202020
-DOBJECT_SERVER_ENDPOINT=http://10.10.10.x:9000

# 截图服务组件
-DHENGSHI_SHOT_ROOT=/opt/hengshi/lib/hengshishot-1.1.24-linux-no-arch
-DENABLE_REFERENCE_DATASET=true
```

4. 正确配置 jvm 参数后，重启 TongWeb 服务器后生效配置参数

### 开始部署

1. 选择 **应用管理** -> **部署应用**
   ![](/images/web-server/tong-web-deploy.png)

2. 选择已经准备好的 war 包文件，上传 web 服务中 点击 **开始部署**
   ![](/images/web-server/tong-web-start-deploy.png)

3. 部署选项 **应用前缀** 设置为 **/**
   ![](/images/web-server/tong-web-applied-prefix.png)

4. 部署成功后可以通过 **http 访问** 进入服务界面

5. 部署后 启动、停止 操作可通过界面中按钮进行操作
   ![](/images/web-server/tong-web-start-stop.png)

### 命令行配置

编辑 \<tongweb_home>/bin/external.vmoptions 增加以下配置

```shell
#jvm_options
...
-DWebModuleOnly=ture
-Dcfg.file.path=${TongWeb_Base}/conf/config.properties


#java_home(确保jdk11或以上)
/usr/local/java
```

config.properties 内容如下

```shell
# Metadb 连接信息
-DDB_URL=jdbc:postgresql://10.10.10.x:54320/hengshi?user=hengshi&password=hengshi202020
# Syslog 日志数据库连接信息
-DLOG_DB_URL=jdbc:postgresql://10.10.10.x:54320/syslog?user=syslog&password=syslog

# 引擎配置信息
-DENGINE_TYPE=greenplum
-DENGINE_DB=jdbc:postgresql://10.10.10.x:15432/hengshi?user=hengshi&password=hengshi202020

# redis 配置连接信息
-DREDIS_ADDRESS=redis://10.10.10.x:6379
-DREDIS_PASSWORD=foobared
-DREDIS_DATABASE=0

# minio 服务配置新
-DMINIO_ACCESS_KEY=hengshi
-DMINIO_SECRET_KEY=hengshi202020
-DOBJECT_SERVER_ENDPOINT=http://10.10.10.x:9000

# 截图服务组件
-DHENGSHI_SHOT_ROOT=/opt/hengshi/lib/hengshishot-1.1.24-linux-no-arch
-DENABLE_REFERENCE_DATASET=true
```

正确配置 jvm 参数后，需重启 TongWeb 服务器后才能生效

#### 通过Commandstool 部署hengshi应用

进入到 \<tongweb_home>/bin 目录下执行

```shell
sh commandstool.sh

Use "exit" to exit and "help" for online help.
commandstool> deploy --contextroot=/ --applocation=/path/to/hengshi-sense-xxxx.war hengshi

# --contextroot: 应用前缀 eg. http://localhost:8088/hengshi
# --applocation: 客户端应用文件 eg. /path/to/hengshi-sense-xxxx.war
# hengshi: 部署的应用名称 eg. hengshi
```

成功部署后默认访问地址<http://localhost:8088>

> \[!CAUTION] 请注意
> 如果你是首次使用Commandstool工具，可能需要使用"change-admin-password" 修改密码

部署完成后如遇到http请求方法被禁止, 请检查WEB容器配置> HTTP通道管理 > tong-http-listener 中的配置是否有方法处于被禁止的列表
![](/images/web-server/tong-web-http-listener.png)
![](/images/web-server/tong-web-http-methods.png)

### 版本升级回滚说明

东方通 Webserver 部署的 hengshi 服务，由于使用外部 metadb 组件服务，升级前请备份 metadb 数据库，以防止存在版本回滚的需求
数据备份恢复可参考[单机/集群环境备份于恢复](backup-restore.md)