HQ VISU MINGXU INDUSTRIAL SYSTEMS
中 在线演示
HQ VISU
文档手册

服务器迁移与现场常见问题 | HQControl

现场问题排查不应从重装和修改数据库开始。应先按问题类型定位：迁移看备份清单，实时值看 IO/Redis/WebSocket，画面看 Screen Files 和菜单，授权看 `/license`。

迁移备份授权Tag 诊断画面文件端口边界
运维

使用前说明

现场问题排查不应从重装和修改数据库开始。应先按问题类型定位：迁移看备份清单，实时值看 IO/Redis/WebSocket，画面看 Screen Files 和菜单，授权看 `/license`。

运维 迁移不是复制整个目录

正式迁移至少要处理 PostgreSQL、config、screens/assets、screen-file-history 和授权记录。运行时依赖和安装程序文件可以从安装包恢复。

运维 先查状态，再改配置

系统状态页、Tag 诊断、画面文件页、菜单配置和授权页，基本覆盖大多数现场问题。先记录当前状态，再做修改。

运维 端口边界要清楚

客户访问 8080；PostgreSQL 15432、Redis 6379、Integration Script 19033 都是本机内部端口，不要暴露给客户机或公网。

迁移

迁移服务器要备份哪些内容

最少备份数据库、配置、画面资源和画面文件历史。换服务器时还要重新授权。

Windows 默认位置

默认安装根目录优先是 `D:\HQCONTROL`；如果 D 盘不是固定本地磁盘，会回退到 `C:\HQCONTROL`。按实际安装根目录替换盘符。

D:\HQCONTROL\config\hqcontrol.env
D:\HQCONTROL\config\hqcontrol.launcher.json
D:\HQCONTROL\config\install.manifest.json
D:\HQCONTROL\data\postgres\
D:\HQCONTROL\data\redis\
D:\HQCONTROL\screens\assets\
D:\HQCONTROL\data\screen-file-history\
D:\HQCONTROL\logs\          # 可选，排障留档
Linux 默认位置

默认安装根目录是 `/opt/hqcontrol`；如果安装时指定 `INSTALL_ROOT`，就把路径替换成实际安装根目录。

/opt/hqcontrol/config/hqcontrol.env
/opt/hqcontrol/data/postgres/
/opt/hqcontrol/data/redis/
/opt/hqcontrol/screens/assets/
/opt/hqcontrol/data/screen-file-history/
/opt/hqcontrol/logs/          # 可选，排障留档
迁移顺序

先记录旧服务器版本、`/settings`、`/license`、系统状态和画面目录；再备份 PostgreSQL、config、screens/assets、screen-file-history；新服务器安装后恢复数据，再重新处理授权。

  • 不要热复制 PostgreSQL 数据目录
  • 不要直接复用旧机器授权文件
  • 恢复后先查系统状态，再查 Tag、画面、报警、趋势和脚本
诊断

实时值、Tag 质量和画面问题排查入口

实时问题按链路查，不要把单个 Bad Tag 当成整台设备故障。

Tag bad / stale / unverified

设备连接正常但部分点异常时，先用 Tag 诊断和 Bad 检查复核。`unverified` 表示按需点尚未完成采集确认，不等于 good，也不等于 bad。

  • 检查地址模式和数据类型
  • 按需点没有订阅时不会常驻采集
  • 删除 Bad 点前先按当前 tag_latest 复核
实时值不刷新

按设备连接、采集 Owner、IO Worker、Redis、WebSocket、页面订阅顺序检查。反向代理场景必须启用 WebSocket upgrade。

  • 看系统状态里的 IO / Redis / WebSocket
  • 看 activeHotTags 和订阅来源
  • 看反向代理是否支持 WebSocket
画面空白或菜单打不开

先看画面文件页是否存在 `screens/assets/<screen-code>/index.html`，再看菜单目标路径和 `/settings` 里的公开主机名。

  • 画面文件页能看到入口 HTML
  • 菜单目标路径真实存在
  • 公开主机名不是旧 IP
边界

授权、脚本、端口和升级边界

这些边界是交付和运维必须讲清楚的内容。

授权边界

HQ VISU Designer 与 HQControl 是两套独立授权。HQControl 按平台统一授权，覆盖平台内功能、更新包和后续扩展能力，功能模块不拆成单独收费项。

Integration Script

Integration Script 提供 `ReadTag`、`ReadTags`、`WriteTag`，内置 HTTP、数据库、MQTT、WebSocket、加密等常用包，也可按项目安装第三方 Python 包。脚本执行器只监听本机 `127.0.0.1:19033`。

端口边界

正式安装后用户只访问 8080。PostgreSQL 15432、Redis 6379、Integration Script 19033 都是内部端口；IO State API 内置在 8080 下，没有独立 19031 端口。

覆盖升级

同机覆盖升级会保留配置、数据、日志、运行目录和运行时依赖。升级后确认 `schema_migration`、系统状态、画面 bundleVersion、Tag 诊断、报警趋势和脚本执行记录。