troubleshoot — 逐工具检索台账与已知坑¶
用途：记录每个工具的联网预检索结论及其落地方式，避免跨会话重复检索、避免"搜过就忘"。 约定：每条结论必须标注来源可信度，并写明落到哪里（配置 / precheck 检查项 / SOP 步骤 / 仅登记）。
可信度档位：【官方】=厂商文档；【社区】=论坛/博客经验帖（仅供参考，以实测为准）； 【未找到】=检索无可靠资料，待实测确认。
硬约束（检索不得突破）：来源锁定、危险目标推导、幂等三态三项校验无跳过开关； 任何"加参数绕过校验"的建议一律不采纳。
批 1 通用预检索（2026-09-28，覆盖全部 spf 型工具）¶
| # | 结论 | 可信度 | 落地方式 |
|---|---|---|---|
| 1 | Installer 5.0：执行 SynopsysInstaller_v5.0.run 生成 setup.sh；以 root 运行需 -install_as_root |
社区 | SOP 步骤（本工程走 -dir 非交互解包，等价路径） |
| 2 | 批处理：batch_installer -list -o <模板> → installer -batch_installer -config <模板> -target <路径> |
官方(新版) | 旧工程实现已采用（-list + -config -target），沿用 |
| 3 | .spf 文件名不可改，改名后 Installer 不识别 |
官方 | 红线：介质文件名不得改动；介质校验按原名比对 |
| 4 | 安装历史记录在 <安装目标>/.installer；报"已存在安装"但目录已删时，删该隐藏目录重跑 |
官方 | 纳入 rollback/cleanup 目标；precheck 检查半装态 |
| 5 | snps_container_v1.0_common.spf 对 2017/2018 工具不需要：容器化能力自 P-2019.06 起引入，我们的 N/O/K 系列不是 container-enabled |
官方+社区 | 配置：不装 snps_container；该 1.0G 包列为介质裁剪候选 |
| 6 | 官方平台路线图：N-2017.12 / O-2018.06 仅列 RHEL 6.6+/7.x，RHEL 9 / Ubuntu 24.04 属非官方支持 | 官方 | 运行期风险登记（安装期不受阻） |
| 7 | Ubuntu 的 /bin/sh 是 dash：Installer 脚本若用 bash 语法会报错 |
社区 | SOP：一律显式 bash 调用；precheck 增 本机 /bin/sh 指向 检查项 |
| 8 | GUI 模式需 libXss.so.1（libXScrnSaver） |
社区 | 不适用（本工程只用 batch 模式，无 GUI） |
| 9 | 常见缺失库：/lib64/ld-lsb-x86-64.so.3、libpng12.so.0、libXp.so.6、libXm(motif)、libtiff.so.3、libnsl.so.1 |
社区 | 依赖前置清单（与 Cadence 实测清单取并集）；verify 的 ldd 判定覆盖 |
| 10 | Ubuntu 24.04/glibc 2.39 移除 pthread_yield、VCS 链接需 -lsnpsmalloc -lvfs -Wl,--no-as-needed、VCS_ARCH_OVERRIDE=linux64 |
社区 | 属编译/运行期，安装期不涉及；记入后续使用注意（附录） |
| 11 | VCS 与 Verdi 必须同发行版配对 | 社区 | 已符合：VCS-MX N-2017.12-SP2 + Verdi N-2017.12-SP2 同期 |
| 12 | Verdi 的 PLI 库（share/PLI/VCS/LINUX64）需进 LD_LIBRARY_PATH；工具 setup 脚本 shebang 为 csh |
社区 | modulefile/环境变量阶段处理；依赖前置含 tcsh（Cadence 批次已装） |
SCL / license¶
| # | 结论 | 可信度 | 落地方式 |
|---|---|---|---|
| 13 | SCL 经同一 Installer 装 scl_v2018.06（common+linux64），产物在 scl/<ver>/linux64/bin（lmgrd/snpslmd/lmutil） |
官方 | 基础批安装步骤 |
| 14 | hostid 用 lmutil lmhostid（加密狗加 -flexid -long） |
官方 | license 阶段 |
| 15 | 启动 lmgrd -c <license> -l <log>；客户端设 SNPSLMD_LICENSE_FILE=<port>@<host>（优先于 LM_LICENSE_FILE）；日志目录 /usr/tmp/.flexlm 需存在 |
官方+社区 | SCL 步骤与 precheck |
| 16 | FlexNet 常见错误码：-14 找不到 SERVER 主机名（DNS/hosts）；-15 连不上（lmgrd 未起/端口错）；-18/-21/-25 版本不匹配 | 官方+社区 | RUNBOOK 排障表 |
| 17 | SCL 服务端官方支持列表到 RHEL/Rocky 8.4+，9.x 不在列（非官方支持） | 官方 | 风险登记（31.29 若为 Rocky 9 需实测） |
| 18 | SCL 向后兼容历史工具版本，2018.06 服务 2017/2018 工具可行 | 官方 | 支撑"用 scl_v2018.06"的决策 |
各工具额外前置（已知部分）¶
| # | 结论 | 可信度 | 落地方式 |
|---|---|---|---|
| 19 | VCS-MX/Verdi：需设 VCS_HOME/VCS_MX_HOME/VERDI_HOME + PATH |
社区 | modulefile 阶段 |
| 20 | SpyGlass：设 SPYGLASS_HOME + PATH，license 走 SNPSLMD_LICENSE_FILE |
社区 | modulefile 阶段 |
| 21 | TetraMAX 属 TestMAX/ATPG 家族；IDQ 是库验证工具，与 TetraMAX 无安装依赖（同介质三产品） | 官方(工具目录) | 配置：tx 介质按 -list 实测产品名分派 |
| 22 | HSPICE 官方支持 OS 更老（RHEL 6.6–7.3），新系统受第 6/9 条影响 | 官方 | 风险登记 |
| 23 | CustomSim/XA 命令为 xa，归 customsim 模块 |
官方 | modulefile 阶段 |
检索无可靠资料、留待实测¶
Missing destination directory、cannot find snps_container两类报错的具体处置- Synopsys 安装到 NFS 的专门注意事项（root-squash、锁）
- Synplify/Identify 的 license 特性细节
- Installer v5.0 的
-list/-config与新版参数的差异（新版文档为主，需以实机-h为准）
实测踩坑（2026-09-28 首次安装记录）¶
| # | 现象 | 根因 | 处置 | 已落到哪 |
|---|---|---|---|---|
| P1 | 8 个产品的 post-install 报 couldn't execute ...: no such file or directory，但脚本文件确实存在且可执行；batch_installer 仍返回 rc=0（只记 WARNING） |
Synopsys 的 post-install 脚本 shebang 为 #!/bin/csh -f，本机 Ubuntu 未装 csh/tcsh，execve 因此返回 ENOENT（"no such file or directory" 指的是解释器） |
apt install csh（提供 /bin/csh → bsd-csh）后补跑全部 11 条，均 rc=0 |
scripts/rerun_post_install.py；前置条件：本机须有 csh |
| P2 | fpga/identify 安装时 tclsh 满 CPU 空转、15 分钟无进展、目标目录不生成、/data 不再增长 |
该介质 EULA: 1，安装器交互索要 [[A]ccept|[D]ecline]；批处理喂入无效输入（yes）后被无限重问 |
生成最终 cfg 时把 EULA: 1 置 0（预接受），并令子进程 stdin=DEVNULL |
scripts/batch_install.py（re.sub + DEVNULL）；注释已写明 |
| P3 | batch_installer 退出码 0，但日志含 ERROR: 行（post-install 失败被吞） |
安装器对 post-install 失败只记 ERROR/WARNING，不影响 rc | 回查判据改为「解析日志里的实际目标目录 + 检测 ERROR 行」，不再只看 rc |
scripts/batch_install.py 回查逻辑 |
| P4 | 产品名 ≠ 安装目录名 | 介质内产品定义如此：tx 装入 syn/、txs 装入 txs/；pt 的产品名是 pts、ppower 是 pwr；verdi 的 RELEASES 串带产品名前缀（Verdi_N-2017.12-SP2）；spyglass 只有 common 平台；fpga 平台是 linux 而非 linux64 |
目标路径一律以安装器日志 Installing ... product X to Y 为准，不按产品名拼路径 |
scripts/batch_install.py；config/synopsys_install.yaml 的树锚点待按实装路径登记 |
| P5 | 7z 无法解 synopsysinstaller_v5.0.rar（Unsupported Method） |
该 RAR5 用了 7z 未实现的压缩方法；本机亦无 unrar/bsdtar | apt install unrar 后解出正常 |
前置条件：本机须有 unrar |
新增前置条件（须进 precheck）：本机需具备 csh、unrar、tclsh 与 perl。
逐工具检索（每批开工前追加）¶
| 批次 | 工具 | 检索词 | 结论 | 落地 |
|---|---|---|---|---|
| — | （待批 1 开工时填写） |
来源：
/home/rain/Documents/eda_tools_ins/Synopsys/synopsys_install_2018/docs/troubleshoot.md｜ 最后更新：2026-09-28 03:54（由build/sync.py同步，请勿在站点侧修改）