记录报错、受影响页面、设备或 Tag、首次异常及最近正常时间，保留系统状态和相关日志。
文档手册
Mingcedar 现场排障
记录现象、时间和状态，逐层排查并单项修正。
先记录现象，再定位故障层级
记下出现时间和可见状态，再区分服务、连接、采集、路由、数据质量和操作结果。
先查看系统状态中的五项服务、数据库、Redis 和授权，再查看设备配置应用、连接、采集及 Tag 质量。某一层正常不代表后续层也正常。
报警、趋势、脚本或写入异常时，对照事件与命令记录、后续采集值及对应服务状态。结果未确认前不要重复下发设备命令。
安装后服务未启动、重启后没有自启
核对安装角色和五项运行服务，再检查数据库、Redis、日志和自启状态。
检查本机安装模式是否包含宿主服务。Windows 的 full 安装包含宿主和数据服务；host 使用同机已准备的数据服务。仅安装 database 或 client 不会提供完整运行入口。
Windows 在服务管理器核对 HQControl、HQControlIO、HQControlAlarm、HQControlTrend 和 HQControlScript；Linux 执行 sudo hqcontrolctl status 和 sudo hqcontrolctl health。结合未就绪服务的日志查找原因。
先确认数据库和 Redis 就绪，再访问 Portal 与 Screen 的实际 HTTPS 地址。服务恢复后，还要在系统状态、授权页和 Tag 诊断中分别确认平台、授权和采集结果。
控制面板状态不准、勾选后未生效或重启后没有拉起
以系统服务状态和系统状态页为准，核对自启设置是否保存并在重启后生效。
控制面板状态异常时，对照系统服务管理器或 hqcontrolctl、系统状态页及服务日志；图标不能单独证明服务就绪。
保存自启设置后，按部署方式检查服务启动配置；在维护窗口重启主机，再确认五项服务及数据库、Redis 是否恢复。仅看到进程启动，不代表全部服务已经就绪。
重启后部分服务不可用时，检查数据库、Redis、证书和启动日志。逐项修复并复查，避免反复重启整个运行单元。
管理端地址打不开或显示未就绪
先核对 Portal 地址、HTTPS 证书和 Web/App 服务，再检查数据库与 Redis 依赖。
使用安装时配置的 Portal HTTPS 地址访问管理端；Screen 使用独立入口。核对主机名、端口、DNS、反向代理和防火墙，避免把数据库或 Redis 端口当作网页入口。
证书警告或握手失败时，核对证书名称、有效期和客户端信任。页面无响应或显示未就绪时，检查 Web/App 服务状态及日志，并确认数据库和 Redis 可用。
先确认管理端可以登录，再打开一个运行画面验证 Screen 入口。设备连接、Tag 质量和报警趋势应分别检查，网页恢复不代表采集已经恢复。
数据库、TimescaleDB 或 Redis 异常
通过系统状态和日志区分 PostgreSQL/TimescaleDB 与 Redis 故障，再按部署方式恢复。
在系统状态页检查数据库和 Redis；无法访问时查系统服务与日志。核对地址、端口，区分未启动、连接失败和响应缓慢；网页故障不能证明数据库损坏。
核对磁盘空间、持久目录、凭据、证书及当前程序和数据库版本。历史数据异常时，同时检查 TimescaleDB 和 Trend 服务，不用缺口补零掩盖写入中断。
恢复或迁移数据库前保留一致性备份，并使用匹配版本的程序和数据库。依赖恢复后依次检查五项服务、画面、Tag 质量、报警与趋势；避免直接复制运行中的数据库目录。
检查连接成功，但列表仍显示离线
连接检查只验证目标可达；还要核对配置应用、采集责任、Tag 质量和更新时间。
在设备详情分别查看配置应用状态、PLC 连接和采集状态。连接检查是诊断步骤，不代表设备定义已应用，也不代表 Tag 已产生有效数据。
确认目标设备存在已启用的物理 Tag，并有可用 IO Owner 承担采集。备用、未采集、连接待确认和连接失败应分别处理。
按所选协议核对主机、端口、地址模式、证书或驱动等必要字段；S7Plus 还需确认采集主机已安装驱动。随后在 Tag 诊断中核对完整点名、类型、质量与更新时间。
修正配置后等待应用和首次有效采集，再比较 Tag 值与现场状态。质量 good 只表示该数据可用，不应单独作为设备在线或写入成功的证明。
两个站点都在采集，或远端站点没有设备信息
先核对部署模式是否受当前安装包支持，再检查远端能力范围与活动 IO Owner；普通站点互联不提供跨 PC 主备。
独立站点通过联邦共享选定能力。当前 dedicated-node 安装仅提供 IO，要求使用同机回环地址的数据服务，不支持连接远端数据库。跨 PC 主备须有与交付版本匹配且经验证的专门方案。
通过普通 LAN 连接查看远端报警时仅支持读取，按钮不可用不一定是账号权限问题。确认、搁置或解除搁置时，直接登录来源站点，并使用具有对应权限的账号。
在本站的站点连接中核对目标站点、通信方向、选用的 IO 能力和设备范围，再检查远端信任及权限。只有对方也需要使用本站能力时，才在对方另行配置相反方向。
在设备详情核对活动 IO Owner、所属运行单元和 PLC 定义。采集归属只在同一运行单元内协调；两个独立站点配置同一物理 PLC 不会自动互斥。应明确采集来源，停用不需要的重复配置，并通过 IO 共享读取来源数据。
确认实际 IO Owner、配置应用状态、驱动、凭据和网络连接。恢复后等待新的有效采集，再核对 Tag 质量、报警和趋势；已验证的同域接管方案还需检查租约与候选资格。对结果不明的写入先查记录，不直接重发。
PLC 连接、符号地址、IO Owner 或联邦状态异常
先分别检查 PLC 连接与 Tag 采集，以及联邦范围与 IO Owner，再处理交叉影响。
先按本页“PLC 连接”章节核对配置应用、协议字段、采集责任、Tag 质量和更新时间。连接检查通过不能代替这些检查。
再按“联邦与 IO Owner”章节核对站点关系、能力方向、设备范围及活动责任节点。远端画面能打开，不代表远端 IO 数据已被本站选用。
在线或离线激活失败
通过 /license 查看授权状态并执行在线或离线激活。当前试用按未激活进程的两小时有效期管理。
有效永久证书优先于试用。试用状态仅保存在进程内存，不作为持久授权；到期后停止授权保护的业务功能，需操作人员按授权流程处理。禁止以自动重启续期。
在线环境按授权页提交激活信息并检查结果；离线环境导出本机请求，取得签发结果后导入并核对产品、机器及授权状态。授权页可在未登录时访问，但不显示已使用的激活码。
无效、吊销、被修改或机器不匹配的证书不会回退到试用。换机时按新机器重新办理授权；保留签发与维护记录，不直接复用旧机授权。