117 lines
7.3 KiB
Markdown
117 lines
7.3 KiB
Markdown
# iCDB 旧服务器会话失联:分析、恢复步骤与分支改动
|
||
|
||
分支:`codex/icdb-lost-session-diagnostics`,基于 `a11eb3c`(`v0.2.2-beta.1`)。
|
||
|
||
## 错误的含义和影响范围
|
||
|
||
现场消息为:
|
||
|
||
```text
|
||
The last server session on different server machine lost the connection
|
||
to the database. Please use iCDB Project Backup 'Repair project'
|
||
functionality to fix this issue.
|
||
Machine: [200091-CBB]
|
||
Session: [2026-10-24 08.22.29-10308]
|
||
```
|
||
|
||
原生 iCDB 检测到先前服务器会话的数据库状态需要检查/修复。这不是
|
||
“当前网络连接已经恢复就可以继续”的提示,也不能仅凭它认定端口被 Windows 保留。
|
||
`Machine` 和 `Session` 是故障记录中的原服务器、会话标识,不能当作当前进程 PID。
|
||
|
||
用户贴出的路径包含 `5:\5ymbolLibsReusableBlockssymb`,存在文字识别/转录歧义。
|
||
本机隔离样本确实存在 `SymbolLibs\__ReusableBlocksSymb\icdb.dat`:如果现场原文
|
||
指向这个结构,问题影响的是中心库共享符号数据库,而非单个 CBB 的
|
||
`ReusableBlocksLP\<CBB>\Work\database`。必须以现场原始日志为准,不能自动把
|
||
`5:` 改成 `S:`,或根据 CBB 名称推导修复目标。
|
||
|
||
异常关闭、原服务器/网络存储断开、写库期间复制工程、跨机器访问不一致的
|
||
路径,都可能涉及此类状态。现有消息不能区分这些原因,也不能证明
|
||
“校验失败一定导致损坏”;数据库异常本身同样会导致校验失败。共享符号库
|
||
出问题时,不同失败 CBB 可能只是访问了同一个有问题的数据库。
|
||
|
||
## 现场恢复步骤
|
||
|
||
1. 停止批量校验,核对 `200091-CBB` 和其他访问同一中心库的客户端。
|
||
正常关闭占用该目标的 Library Manager、PCB、原理图/符号编辑会话,并确认
|
||
原数据库服务器的实际状态;只看本机没有 PCB 或 TCP 探测失败不足以确认独占。
|
||
2. 在会话正常关闭后保留完整、一致的工程/中心库副本。共享库问题需包括
|
||
`.lmc`、相关 `SymbolLibs` 数据库、原有 `ProjectBackup`/数据库备份和日志。
|
||
工具日常的 `backup/` 排除了 `database` 等目录,网络操作还可能跳过备份,
|
||
因而不能把它当作这次修复所需的完整回滚副本。
|
||
3. 使用现场相同 Mentor 版本的 **iCDB Project Backup**,先核对打开的工程或
|
||
备份存储确实关联报错数据库,再执行 **Project → Repair**(错误提示称为
|
||
`Repair project`)。如果目标是共享符号库,而工具无法识别对应库/存储,
|
||
应由库管理员按该版本支持的库恢复流程处理,不能改选无关的 Work PRJ。
|
||
4. 保留原生工具的修复输出及 `Project Repair` 备份,确认修复结果。
|
||
不通过删除 `sAddress.adr`、锁文件、`icdb.dat`,也不通过强杀数据库服务器
|
||
来代替 Repair。如果原生修复失败,再依据原生日志选择一致备份恢复。
|
||
5. 正常重新打开原先失败的目标,先复测一个 CBB,检查本轮原生日志、
|
||
Project Integration、Save/Close 和进程释放,再以 `IsVerifiedReuseBlock`
|
||
返回 `READY/raw=1` 确认校验成功。之后再扩大批次。
|
||
|
||
本机已确认原生入口:
|
||
|
||
```text
|
||
%SDD_HOME%\iCDB\win32\bin\iCDBProjectBackup.exe
|
||
```
|
||
|
||
只读检查其命令行帮助显示 `-p <project file>`、`-ver`、`-h`;菜单资源确认存在
|
||
`Project → Repair`。没有查到公开的直接 Repair 命令行开关,因此本分支没有
|
||
编造 `-repair` 参数,也没有自动投递写库修复命令。曾在本机既有隔离样本上
|
||
打开原生管理界面进行入口检查,未执行 Repair;本机没有用户本次故障库,
|
||
未在 `200091-CBB` 或现场网络库上执行恢复。
|
||
|
||
## 代码修复
|
||
|
||
- 在内容检查输出、实时弹窗和本轮 `PCBLogFile.txt`、`ForwardAnnotation.txt`、
|
||
`MsgBoxResponse.log`、`PartPkg.log` 中识别完整的服务器会话失联消息。
|
||
- 分类为 `ICDB_REPAIR_REQUIRED`,保留原始错误和 `Machine/Path/Session`,
|
||
区分共享符号库、Work 工程数据库及不能确定的目标;写入
|
||
`diagnostics/icdb-recovery.json` 并在失败清单显示恢复说明。
|
||
- 该错误优先于通用打开失败、JobPrefs 错误及清理失败;即使内容检查同时
|
||
输出成功文字和退出码 0,也不能变成 PASS。标记 `safe_to_continue=False`,
|
||
后续条目标记 SKIPPED,沿用现有会话、证据、网络映射保留机制。
|
||
- 将当前日志与启动前检查点比较,支持追加、截断、等长/增长重写、UTF-16
|
||
及 UTF-8;恢复识别每次最多读取两个 128 KiB 片段。不能确认日志新旧时
|
||
保留原始失败,不据旧记录推荐本轮修复。重写后保留的同一历史会话不作为
|
||
新证据;可验证的追加则允许识别同一会话再次报错。
|
||
- 通用 `Could not run server` 不再直接推断端口保留并提示重启 WinNAT。
|
||
启动前独立端口绑定探测保留原逻辑。
|
||
|
||
## 验证和边界
|
||
|
||
原分支基线:`python -m pytest -q`,383 项通过。
|
||
新增回归包括原错误、共享库身份、内容检查停止队列、多行集成日志、
|
||
日志重写及历史错误隔离、编码、证据写入失败和监督器失败摘要。
|
||
|
||
诊断修复阶段验证(后续生命周期修复见下方链接):
|
||
|
||
- 全量 Python 测试 **417 项通过**,含 34 项新增回归;仍有基线已有的
|
||
一条 pywinauto STA COM 模式提示。
|
||
- 两组 PowerShell 测试、`python -m compileall -q src tests`、
|
||
`git diff --check` 通过。
|
||
- 只读解析仓库留存的真实 TUNER_R836_A 现场日志,正确提取到机器 `EDA03`、
|
||
`S:\ReusableBlocksLP\TUNER_R836_A\Work\database` 及会话
|
||
`2025-01-21 14.44.46-2323356`。该记录仅用于解析验证,不代表本次现场故障。
|
||
- 独立代码复查发现的集成日志遗漏、通用端口建议覆盖具体原因、历史日志
|
||
重写误判、不可读/超出窗口的基线问题,均补充回归并通过复核。
|
||
|
||
本分支修复自动化的错误识别、误导性建议和失败后的继续执行风险,
|
||
现在还会在目标明确、会话完全释放且完整备份成功时,自动调用同版本原生
|
||
Project → Repair,并只在原生诊断、Project Repair 备份、目标数据库关闭等
|
||
证据全部满足时重试一次校验。共享符号库路径没有 PRJ 入口时会明确阻断,
|
||
不会猜测或改修某个 CBB 的 Work 数据库。
|
||
|
||
这次在新复制的 IP101GR 工程上完成了真实隔离验证:Repair 菜单确认、完整
|
||
备份、原生 `dbcheck`/数据库日志、`Project Repair` ZIP 校验和数据库关闭均
|
||
成功;Repair worker 退出码为 0,随后才允许重试。该验证没有接触生产库。
|
||
|
||
仍然**没有修复现场受损数据库,也没有在 `200091-CBB` 上执行恢复**。
|
||
恢复识别仅覆盖已知日志末尾的有限窗口;错误出现在窗口外、相同历史会话
|
||
在重写时被原样重报、超出基线窗口的大日志发生重写、以及现场不同日志位置/格式,
|
||
仍需结合完整原生日志确认。这些不能确认新旧的情况不会自动提升为本轮修复诊断。
|
||
|
||
用户后续确认事故版本为 r4 或更早。失败强杀根因、正常关闭修复、自动 Repair
|
||
范围和 448 项最终回归详见
|
||
[失败生命周期与恢复验证](../releases/2026-10-27-icdb-failure-lifecycle-and-recovery.md)。
|