问题说明

管理节点日志可能停在 LicenseManagerImpl 调用 genlicreq，安装器仅提示未收到 ready。若日志中出现 Failed to generate thumbprint: unexpected lsblk output: N，表示许可工具期望唯一根盘记录，但软 RAID、LVM thin/device-mapper等拓扑返回多条候选并退出。

现象

• 安装步骤 Start nologo management node 失败或等待1000秒后停止。
• management-server.log 最后停在 LicenseManagerImpl/genlicreq，没有 Java异常栈。
• 安装日志或手工证据出现 unexpected lsblk output: 2/3。

适用环境

• ZSphere 4.10.26、Hygon C86-4G、LVM thin/device-mapper根盘已验证。
• TIC-4987 还验证了软 RAID 1场景。
• 不是所有 LVM都会触发，也不能仅因使用 Hygon CPU就引用本篇。

可能原因

先从现有日志确认精确错误，再只读展示根挂载与块设备父链。没有 unexpected lsblk 时，仍需排查原生工具退出、CPU指令、OOM或其他 LicenseManager分支，不能直接重规划硬件。

问题定性

• 类型：已知产品 Bug/存储拓扑兼容问题。
• 已知问题：是；TIC-4987 Closed/Fixed，ZSV-11256与ZSTAC-79788截至2026-08-06仍Open/P1。
• 根因：genlicreq 对根盘识别采用单结果假设，复杂块设备拓扑使 lsblk返回多条根记录，工具非零退出；上层路径可能直接退出而无清晰业务错误栈。
• 影响版本：现场 4.10.26；没有正式 fixVersion证据，不得宣称已在某版本修复。
• 置信度：高，前提是日志关键词与拓扑证据同时命中。

排查步骤

检查一：检索许可工具错误

• 只读命令：

  grep -RniE 'LicenseManager|genlicreq|thumbprint|unexpected lsblk|management-node-ready' \
    /tmp/zstack_installation-*.log /usr/local/zstack/apache-tomcat*/logs 2>/dev/null
  journalctl -k --since '-30 min' | grep -Ei 'segfault|illegal instruction|trap|oom|java|genlicreq'

• 出现 unexpected lsblk output: N：继续确认存储拓扑。
• 只出现 illegal instruction/segfault：不属于本篇，转原生二进制/CPU兼容排查。
• 无任何明确错误：收集完整安装日志和进程/线程证据，不能定根因。

检查二：读取根挂载和块设备拓扑

• 只读命令：

  findmnt -no SOURCE,FSTYPE,OPTIONS /
  lsblk -P -o NAME,KNAME,PKNAME,TYPE,FSTYPE,MOUNTPOINT,UUID
  lsblk -s "$(findmnt -no SOURCE /)"

• 根文件系统经软 RAID或device-mapper映射到多个父设备，并与错误计数吻合：命中同类根盘识别缺陷。
• 根盘为单一普通分区且只返回一条：不能套用 TIC-4987，需要升级研发分析工具输出。

检查三：区分CPU相关问题

• 只读命令：

  lscpu
  uname -a
  dmesg -T | grep -Ei 'illegal instruction|segfault|trap' | tail -50

• 无指令异常且已出现 unexpected lsblk：根因是存储枚举，不是 Hygon硬件损坏。
• 有指令异常：需要独立兼容性分析。

处理建议

已有生产环境应向研发获取与当前版本严格匹配的 genlicreq和管理节点联合补丁，并按补丁说明备份、校验与回退；不能只替换二进制，因为管理节点可能校验其摘要。全新可重装环境可由客户重新规划：用硬 RAID向 OS暴露单一逻辑盘，系统根盘使用能保证唯一父链的普通分区/普通LVM，业务数据盘独立。禁止在线改造生产根LV、包装系统 lsblk 或使用来源不明的工具包。

长期方案

跟踪 ZSV-11256/ZSTAC-79788，使许可工具按根挂载设备的真实父链稳定生成指纹，并覆盖软RAID、LVM thin、device-mapper、多路径等拓扑。

补充信息

升级人工条件

• 无 unexpected lsblk 证据。
• 生产环境需要补丁或根盘改造。
• 多管理节点许可证/硬件指纹已变化。
• 出现 illegal instruction、segfault、OOM或许可证校验其他错误。

需要收集的信息

ZSphere/OS/CPU版本、完整安装日志、management-server.log、上述块设备输出、RAID/LVM设计、genlicreq报错原文和多管理节点状态。

相关问题

• TIC-4987，Closed/Fixed。
• ZSV-11256，Open/P1。
• ZSTAC-79788，Open/P1。
• 状态核验日期：2026-08-06。