1. 概述编辑
1.1 版本
报表服务器版本 |
---|
11.0.2 |
1.2 应用场景
为了降低Websocket配置难度,11.0.2 及之后版本的报表工程,新增了一个容器Websocket方案。
无需任何用户操作,系统可自动使用Web容器自带的WebSocket进行连接,端口复用http端口。
相比于之前的socket.io方案,用户无需任何手动配置,无需额外开启端口。
2. 方案执行步骤编辑
容器Websocket方案的执行,需要满足以下一些条件和配置。
2.1 容器环境检验
容器Websocket方案,仅在以下容器环境中生效。若不满足容器环境校验,则使用socket.io方案。
容器 | 版本 |
---|---|
Tomcat | 支持Tomcat7.0.47~9.0 版本 |
WebLogic | Weblogic12c及以上版本 |
WebSphere | WebSphere9及以上版本 |
JBoss | eap6.4+ wildly9+ 其中eap6.4需要修改配置 |
TongWeb | TongWeb 6、TongWeb 7 版本 |
若当前工程所在容器环境不支持容器Websocket方案,则「管理系统>系统管理>常规」页面正常显示「WebSocket设置」。
若当前工程所在容器环境支持容器Websocket方案,则「管理系统>系统管理>常规」页面不显示「WebSocket设置」。
注:如需显示 HTTPS 设置项,超级管理员可通过「fine_conf_entity可视化配置插件」更改配置。重启服务器后设置生效。
修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。
配置项 | 修改规则 |
---|---|
FSConfig.loginConfig.forceRedirectAfterLogin | 参数值需为布尔型,默认为false false:登录后不强制跳转 true:登录后强制跳转 |
2.2 负载均衡配置
若无负载均衡配置,可直接使用容器化WebSocket方案。
若存在负载均衡配置,需要进行一些额外配置,否则无法使用容器化WebSocket方案。
若负载均衡配置不正确,则使用socket.io方案。
类型 | 配置 |
---|---|
nginx | 若未在Nginx中配置过ws配置,则可直接使用容器化WebSocket方案 若曾在Nginx中配置过ws配置,需要删除原ws配置,修改http配置,添加 proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $http_connection |
traefik | 无需额外配置,原ws配置保留/删除不影响容器化WebSocket方案生效 |
f5 | 无需额外配置,原ws配置保留/删除不影响容器化WebSocket方案生效 |
2.3 浏览器环境
容器化WebSocket方案支持 Chrome、FireFox、Edge、IE10 及以上版本浏览器。
容器化WebSocket方案不支持 IE9 及以下版本浏览器,需使用socket.io方案。