# 东方通(TongWeb)安装部署
TongWeb (opens new window)是北京东方通科技股份有限公司自主研发的、具有自主知识产权的、遵循JavaEE7 Web Profile规范的企业级应用服务器，SuccBI同样支持在TongWeb部署，步骤如下：
# TongWeb安装
# 上传并执行安装程序
上传TongWeb安装程序，如Install_TW7.0.4.1_Enterprise_Liunx.bin至服务器机器，并赋予可执行权限：
chmod +x Install_TW7.0.4.1_Enterprise_Liunx.bin
执行如下命令，按照指示信息开始安装：
./Install_TW7.0.4.1_Enterprise_Liunx.bin –i console
当日志中出现如下一行，没有异常信息，说明TongWeb启动成功：
[2020-12-28 11:57:24] [INFO] [core] [TongWeb server startup complete in 7839 ms.]
# 启动TongWeb
启动TongWeb需要进入TongWeb/bin目录，执行如下命令：
./startservernohup.sh
相同的，执行stopserver.sh即可停止TongWeb
启动后访问http://TongWebIP:9060/console 进入TongWeb控制台，默认用户名、密码为thanos、thanos123.com，界面如下图：
# WEB容器配置
TongWeb支持在控制台中配置WEB容器，类似于在Tomcat中修改Tomcat/conf中的配置。
# 字符集配置
在控制台左侧导航区点击WEB容器配置>容器配置，将默认请求参数解码字符集、默认应答编码字符集均修改为UTF-8
在控制台左侧导航区点击HTTP通道管理，选择tong-http-listener，在其他设置中将URL编码格式修改为UTF-8
# 端口号修改
同样在tong-http-listener中，修改监听端口即可，默认为8088
# 部署SuccBI应用
在控制台左侧导航区点击应用管理，进入应用部署界面，点击部署应用
部署文件选择版本更新中获取的war文件，上传完毕后，点击开始部署，进入应用属性配置界面
以下属性按需配置：
- 应用名称：部署后
应用管理界面显示的名称 - 应用前缀：即访问系统URL的上下文根
- 其他属性：均选择默认配置即可
点击下一步，设置虚拟主机为默认的server后，即可完成部署，在应用管理界面新增了SuccBI应用
# 配置启动参数
与tomcat启动环境变量一致，在控制台左侧导航区点击启动参数配置，在JVM参数中配置JVM内存
在其他JVM参数中配置JVM扩展参数，必须参数配置如下，更多参数参考环境变量
-Dfile.encoding=UTF-8
-Djava.awt.headless=true
-Dsucc.workdir=/path/to/workdir（请修改这个路径）
-Dsucc.localWebAddress=http://ip:port
TIP
在TongWeb中默认端口号为管理控制台的9060，而不是部署应用的监听端口，因此必须通过-Dsucc.localWebAddress来指定SuccBI的访问地址，否则在系统中会出现无法查看仪表板的情况，例如-Dsucc.localWebAddress=192.168.3.50:8088
# 完成部署
启动参数配置完成后，重启Tongweb，此时SuccBI应用也会同时启动，至此TongWeb下的SuccBI部署已完成，访问http://TongWebIP:端口/上下文根 进入初始化界面
# 集群部署
- 按照本文内容，在集群节点服务器分别安装TongWeb并部署SuccBI
- 按照集群部署中的步骤，配置并加入集群即可
# 常见问题
# 请求路径出现乱码
问题原因：
TongWeb容器中的默认字符集均为GBK，SuccBI使用UTF-8，导致请求路径转码不正确
解决方法：
手动修改TongWeb字符集配置至UTF-8，可参考字符集配置
# 可视化查看界面出现编译错误
问题原因：
在TongWeb中默认端口号为管理控制台的9060，而不是部署应用的监听端口，会导致获取端口错误
解决方法：
通过-Dsucc.localWebAddress来指定SuccBI的访问地址，可参考配置启动参数