SOP — Synopsys 老 IC Compiler（ICC）安装与 ICC2 Milkyway 路线验证¶
变更批次：2026-09-29｜执行结果：安装成功（21 棵树）；ICC2 Milkyway 路线转换成功、NDM 分组未通（LIB-105）
目录¶
1 背景｜2 目标｜3 前置条件｜4 影响范围｜5 分步操作｜6 验证｜7 回滚｜8 风险说明｜附录 A–E
1. 背景¶
ICC2（icc2/O-2018.06-SP1）在把 Milkyway 参考库转成 NDM 时，需要调用老 IC Compiler 的
icc_shell 作为转换后端；工具树内此前只有 icc2，因此报：
LIB-090: App option 'lib.configuration.icc_shell_exec' must be specified
当时（SAED32 PDK 装载轮）的处置是改走 LEF 路线（.tf + 标准单元 LEF），已实测可用；
Milkyway 路线作为遗留项登记在项目根 HANDOFF 待办 #5。
本轮把已上传的介质 synopsys2018/ic_compiler_vO-2018.06-SP1/（857M，EST 包：common.spf +
linux64.spf + checksum_info.txt）装入既有工具树，补齐 icc_shell，并把该入口登记进
eda2018/1.0.lua，使客户端可直接取用。
2. 目标¶
- 工具树新增第 21 棵树
/data/nfs/tools/synopsys/icc/O-2018.06-SP1，属主root:root、u=rwX,go=rX，与既有 20 棵树一致 - 六台 work 与 31.28 经
/tools（ro）可见，icc_shell可执行；31.28 上icc_shell -version可运行 module load synopsys && module load eda2018/1.0后icc_shell在 PATH 中- ICC2 侧消除
LIB-090；Milkyway 路线尽力实测并如实登记结果（不强求通过） - 全流程幂等：复跑零变更
3. 前置条件¶
| 类别 | 条件 | 检查方式 |
|---|---|---|
| 介质完整性 | 两个 spf 的 POSIX cksum 与 size 与 checksum_info.txt 一致 |
cksum icc_vO-2018.06-SP1_{common,linux64}.spf |
| 安装器 | scratch/installer/batch_installer 已解包（v5.0，来源锁定） |
ls -l <工程>/scratch/installer/batch_installer |
| 本机工具 | csh、unrar、tclsh、perl |
command -v csh unrar tclsh perl |
| 权限 | 目标树属 root:root 755，普通用户不可写；sudo -n 免密可用 |
stat -c '%U:%G %a' /data/nfs/tools/synopsys、sudo -n true |
| 磁盘 | /data 可用 ≥ 3G（ICC 实装 1.5G，解包峰值约 3.4G） |
df -B1G --output=avail /data |
| 客户端 | 六台 + 31.28 的 /tools 已挂载（只读） |
ssh root@<ip> 'ls /tools/synopsys \| wc -l' |
关键前置（本轮踩坑得出）：安装器拒绝以 root 运行（见步骤 2），因此必须准备一条 "普通用户 + 目标目录临时可写"的路径。
4. 影响范围¶
- 目标主机：仅操作机（本机，NFS 服务端）。客户端只读可见，不需要停服、无窗口期要求
- 变更对象：
/data/nfs/tools/synopsys/下新增icc/（1.5G）与.installer/icc/记录； 改synopsys_install_2018/config/synopsys_install.yaml（纯增量两行）； 改/data/nfs/modulefiles/synopsys/eda2018/1.0.lua（entries 加一行 + help 一行） - 不影响：既有 20 棵树的内容、Slurm/LSF 队列、用户数据、PDK 数据树、license 服务
- 客户端动作：无（module 与工具树均为 NFS 只读消费，改动即时可见）
- 验证动作：在 31.28 上跑
icc2_shell（前台，无调度器作业影响）
5. 分步操作¶
实现体：安装复用 synopsys_install_2018/scripts/batch_install.py（配置驱动、幂等）；
module 入口用本主题 apply_module_entry.py（默认预演、--apply 才改写、写前备份、幂等）。
步骤 0：预检（只读）¶
df -B1G --output=avail /data / # 预期 /data 余量 ≥ 80G
sudo -n true && echo sudo-ok # 预期 sudo-ok
command -v csh unrar tclsh perl # 预期四条路径齐全
cd /home/rain/Documents/eda_tools_ins/Synopsys/synopsys2018/ic_compiler_vO-2018.06-SP1
cksum icc_vO-2018.06-SP1_common.spf icc_vO-2018.06-SP1_linux64.spf # 对照 checksum_info.txt
stat -c '%U:%G %a %n' /data/nfs/tools/synopsys # 预期 root:root 755
预期：cksum 与 checksum_info.txt 完全一致（实测：3986662226 397588480、1393929515 500234240）。
失败判断：cksum 不符 → 介质不可信，无跳过开关，重新获取介质后再继续。
步骤 1：生成安装 cfg（只读扫描介质 → 写 cfg）¶
-list 只读介质、不写目标；随后由 build_final_cfg 生成最终 cfg（写 TARGETDIR、
平台白名单取自介质实存 spf、EULA 置 0 预接受）。
cd /home/rain/Documents/eda_tools_ins/Synopsys/synopsys_install_2018/scratch/installer
./batch_installer -list \
-source /home/rain/Documents/eda_tools_ins/Synopsys/synopsys2018/ic_compiler_vO-2018.06-SP1 \
-o /home/rain/Documents/eda_tools_ins/Synopsys/synopsys_install_2018/config/generated/icc_template.cfg
# 等价实现体（含 build_final_cfg 与 EULA 处理）：
# <工程>/.venv/bin/python scripts/batch_install.py --only icc --dry-run
预期（实测）：products=['icc']、release=O-2018.06-SP1、platforms=['common','linux64']。
失败判断：PRODUCTS 为空或平台只剩 windows → 介质目录不对，检查 media.products.icc.dir。
步骤 2：临时授权（安装器拒绝 root，目标树属 root）¶
坑（本轮实测，最重要的一条）：以 root 直接跑安装器会被拒并 rc=1：
WARNING: The Installer must not be run from a root user account.
To run installer as root [not recommended]; please re-invoke installer with the -install_as_root switch.
厂商明确 not recommended（可能导致工具无法正常运行），故不采用 -install_as_root，
改走"普通用户安装"：目标树属 root:root 755，需临时给安装用户写权限。
用 POSIX ACL 而非改属主——更精准，且回收即回滚：
sudo -n setfacl -m u:rain:rwx /data/nfs/tools/synopsys /data/nfs/tools/synopsys/.installer
getfacl -p /data/nfs/tools/synopsys | grep -v '^#' # 预期出现 user:rain:rwx
预期：user:rain:rwx 就位（.installer 亦需授权，安装器要在其下写 icc/O-2018.06-SP1 记录）。
失败判断：文件系统未启用 ACL（setfacl: Operation not supported）→ 退回
sudo chown rain:rain <两个目录>（只改目录本身），装完再 chown root:root 收敛。
步骤 3：执行安装（普通用户）¶
cd /home/rain/Documents/eda_tools_ins/Synopsys/synopsys_install_2018
.venv/bin/python scripts/batch_install.py --only icc
坑（本机环境侧）：本机 Trae 沙箱不允许进程写 /data/nfs/tools/synopsys/icc
（报 TRAE Sandbox Error: hit restricted）。需在沙箱外以提权通道执行；
因安装器又拒绝 root，故以 sudo -u rain（提权后降回普通用户）方式运行：
sudo -n -u rain /home/rain/Documents/eda_tools_ins/Synopsys/synopsys_install_2018/.venv/bin/python \
scripts/batch_install.py --only icc
预期（实测）：约 30 秒完成，末行 [icc] OK（1 棵树就绪）；日志
logs/install_icc_<时间戳>.log 内含
Installation for O-2018.06-SP1 release of product icc has finished successfully.，
且无 ERROR 行（ICC 无 post-install csh 脚本，故不涉及 P1 类静默失败）。
失败判断：日志出现 ERROR: 或目标目录缺失 → 见第 7 章；rc=0 但零树就绪同样判失败。
步骤 4：ACL 回收与权限收敛¶
# 回收临时授权（ACL 条目即回滚点）
sudo -n setfacl -x u:rain /data/nfs/tools/synopsys /data/nfs/tools/synopsys/.installer
# 属主/权限与既有 20 棵树对齐（安装产物初始为 rain:rain，icc 顶层 775）
sudo -n chown -R root:root /data/nfs/tools/synopsys/icc /data/nfs/tools/synopsys/.installer/icc
sudo -n chmod -R u=rwX,go=rX /data/nfs/tools/synopsys/icc /data/nfs/tools/synopsys/.installer/icc
# 复核
find /data/nfs/tools/synopsys/icc -perm /022 -type f | wc -l # 预期 0（普通文件无 go 写位）
预期：icc 与 .installer/icc 均 root:root 755，普通文件 go 写位计数 0（实测）。
注意：find -perm /022 会命中符号链接（权限位恒为 lrwxrwxrwx，无意义），故须加 -type f。
步骤 5：补 module 入口（幂等）¶
在 eda2018/1.0.lua 的 entries 表末（SCL 行之后）补入 ICC 入口，并在 help 的工具清单里
加 icc_shell。脚本按唯一锚点替换，锚点计数 ≠1 时拒绝修改并退出：
cd /home/rain/Documents/eda_tools_ins/Synopsys/synopsys_icc_install_20260929
sudo -n python3 apply_module_entry.py # 预演（不改动）
sudo -n python3 apply_module_entry.py --apply # 执行（写前自动备份到 backup/）
sudo -n python3 apply_module_entry.py --apply # 幂等复跑 → 预期 SKIP
坑：该文件由 slurm 部署器（kvm_rocky9_deploy 侧）生成，部署器复跑会重建；
重建后需再执行本步骤，或同步修改部署器的模块清单。
预期：grep -n "icc/O-2018" /data/nfs/modulefiles/synopsys/eda2018/1.0.lua 命中；
文件仍为 root:root 644；幂等复跑输出 SKIP … 已含 ICCompiler 入口。
步骤 6：ICC2 Milkyway 路线探针（31.28）¶
ssh root@192.168.31.28 'rm -rf /tmp/icc_mw_verify && mkdir -p /tmp/icc_mw_verify'
scp /home/rain/Documents/eda_tools_ins/Synopsys/synopsys_icc_install_20260929/artifacts/icc2/mw_lib_check.tcl \
root@192.168.31.28:/tmp/icc_mw_verify/
ssh root@192.168.31.28 'cd /tmp/icc_mw_verify && bash -lc "source /etc/profile.d/modules.sh 2>/dev/null;
module load synopsys && module load eda2018/1.0 && module load pdk && module load saed32 &&
timeout 900 icc2_shell -f mw_lib_check.tcl 2>&1 | tail -30"'
预期：INFO: icc_shell_exec=… 打印成功 → Successfully converted 1 Milkyway libraries（LIB-094）。
实测结果：转换通过，但随后 NDM 分组失败（LIB-105），详见附录 D，本步骤当前判定为
未通过（探针）。
6. 验证（全部为实测）¶
| # | 判据 | 命令 | 实测结果 |
|---|---|---|---|
| 1 | 工具树数量 | ls /data/nfs/tools/synopsys \| wc -l |
21（20 → 21）✔ |
| 2 | 体积与属主 | du -sh …/icc；stat -c '%U:%G %a' …/icc |
1.5G、root:root 755 ✔ |
| 3 | 安装记录 | ls /data/nfs/tools/synopsys/.installer/icc/ |
O-2018.06-SP1 ✔ |
| 4 | 安装日志 | grep -E "ERROR\|finished successfully" logs/install_icc_*.log |
finished successfully，无 ERROR ✔ |
| 5 | 六台 + 31.28 可见 | 逐台 ls /tools/synopsys \| wc -l；test -x …/bin/icc_shell |
七台均 21、icc_shell 可执行 ✔ |
| 6 | 工具可运行 | 31.28：icc_shell -version |
icc_shell version - O-2018.06-SP1、build date - Jul 19, 2018 ✔ |
| 7 | module 入口 | 31.28：command -v icc_shell |
/tools/synopsys/icc/O-2018.06-SP1/bin/icc_shell ✔（PATH 含 20 条 /tools/synopsys 路径） |
| 8 | 幂等（安装） | 复跑 --only icc |
走 .installer 记录判定 → 跳过、零变更 ✔ |
| 9 | 幂等（module） | 复跑 apply_module_entry.py --apply |
SKIP … 已含 ICCompiler 入口 ✔ |
| 10 | ICC2 LIB-090 | 步骤 6 探针输出 | LIB-090 消失；icc_shell_exec 生效、MW→NDM 转换成功（LIB-094）✔ |
| 11 | ICC2 NDM 分组 | 同上 | LIB-105 失败（0 组）✘ → 登记为已知限制，见附录 D |
第 7 条补充：同一条 bash 会话里
/usr/bin/which未命中icc_shell（其 PATH 快照不含/tools/synopsys/*），但command -v/type正常命中且命令可执行——判定请以command -v为准，与既有 RUNBOOK 中which ld的用法保持一致。
7. 回滚¶
安装目标是全新目录，介质完好，最坏情况回到"没有 icc 这棵树"：
# 【高危】删除本次安装的 icc 树（不可逆；先核对目标确实是本次新增的树）
ls -ld /data/nfs/tools/synopsys/icc # 先核对
sudo rm -rf /data/nfs/tools/synopsys/icc # 明确路径，不用无边界通配
sudo rm -rf /data/nfs/tools/synopsys/.installer/icc
- modulefile 回滚：用备份覆盖回并恢复属主权限，命令与说明见
backup/README.md（回滚点 =1.0.lua.bak.20260929-033347） - ACL 回滚：
sudo setfacl -x u:rain <两个目录>（步骤 4 已执行，此命令即撤销） - 配置回滚：
synopsys_install_2018/config/synopsys_install.yaml为纯增量，删掉新增的icc:两行即可 - 备份存放位置：本主题
backup/（索引与逐条说明见backup/README.md） - 回滚后验证：
ls /data/nfs/tools/synopsys | wc -l回到 20；七台/tools同样回到 20；command -v icc_shell无输出 - 不适用：不要把"重装"当"卸载"（介质与目标无隐藏状态，除
.installer记录）
8. 风险说明¶
| 风险 | 缓解 |
|---|---|
安装器拒绝 root，若强行 -install_as_root 可能致工具无法运行 |
不采用该开关；改走 ACL 临时授权 + 普通用户安装（步骤 2–4） |
| 临时 ACL 授权窗口内其他用户可能写入目标树 | 窗口仅数十秒（安装实测 30 秒）；装后立即回收 ACL 并收敛属主权限 |
| 安装产物属主为 rain（不像既有树） | 步骤 4 强制 chown -R root:root + u=rwX,go=rX，并以 find -perm /022 -type f 复核 |
| ICC 顶层目录初始为 775（group 可写） | 同上统一收敛为 755 |
| modulefile 被 slurm 部署器复跑重建，ICC 入口丢失 | 已在步骤 5 与附录 C 登记；重建后重跑 apply_module_entry.py --apply |
| 老 ICC 在 Rocky 9 上的运行期兼容性 | 已实测可运行（icc_shell -version 正常、并真实完成 MW→NDM 转换），兼容层（module 注入）生效 |
| Milkyway 路线 NDM 分组失败（LIB-105） | 已排除两条路径并记录证据（附录 D）；LEF 路线（lib_check.tcl）仍可用，业务不受阻 |
附录 A：交付物清单¶
| 交付物 | 路径 |
|---|---|
| 安装实现体（复用） | synopsys_install_2018/scripts/batch_install.py |
| 安装配置（本次增补 icc 两行） | synopsys_install_2018/config/synopsys_install.yaml |
| module 入口实现体 | synopsys_icc_install_20260929/apply_module_entry.py |
| ICC2 Milkyway 路线探针 | synopsys_icc_install_20260929/artifacts/icc2/mw_lib_check.tcl |
| 执行报告 | synopsys_icc_install_20260929/reports/icc-install-20260929.md |
| 备份台账 | synopsys_icc_install_20260929/backup/README.md |
| 逐介质安装日志 | synopsys_install_2018/logs/install_icc_<时间戳>.log |
| 生成的安装 cfg | synopsys_install_2018/config/generated/icc_{template,install}.cfg |
附录 B：执行记录（2026-09-29 03:29–03:47）¶
| 环节 | 结果 |
|---|---|
| 现状核查 | 介质 cksum 与 checksum_info.txt 一致；目标树 20 棵、无 icc；/data 余 1.2T |
| 预演 | --dry-run：products=['icc']、release=O-2018.06-SP1、platforms=['common','linux64'] |
| 首次执行 | 以 root 跑 → 被拒（rc=1，WARNING: … must not be run from a root user account） |
| 二次执行 | 以 rain 直接跑 → 沙箱拦截（TRAE Sandbox Error: hit restricted） |
| 三次执行 | sudo -u rain + 临时 ACL → 成功（30 秒，OK（1 棵树就绪）） |
| 权限收敛 | icc、.installer/icc → root:root 755；ACL 回收；普通文件 go 写位 0 |
| module 入口 | 预演 → apply → 幂等复跑 SKIP；备份 1.0.lua.bak.20260929-033347 |
| 客户端验证 | 七台（六台 + 31.28）：21 棵树、icc_shell 可执行 |
| 工具运行验证 | 31.28：icc_shell -version → O-2018.06-SP1 |
| ICC2 探针 | LIB-090 消失、转换成功（LIB-094）；NDM 分组失败（LIB-105），详见附录 D |
附录 C：决策记录¶
- 不用
-install_as_root：厂商提示"not recommended，可能导致工具对部分用户不可用"； 改为普通用户安装 + ACL 临时授权，既满足厂商约束，又不需要改动既有树属主。 - 用 ACL 而非 chown 打开写权限：ACL 条目可精确回收（
setfacl -x），不触碰既有 20 棵树的属主。 - module 入口单独成脚本（不复用
synopsys_module_fix_20260929/fix_modules.py）： 那次修复的锚点与语义不同，混改会让既有实现体的幂等判据变复杂；本次改动小且独立。 - ICC2 Milkyway 路线按"探针"交付：转换成功后分组仍失败，属 ICC2 侧对纯物理库的限制，
与本次安装目标（补齐
icc_shell）不同层次；如实记录证据而非继续盲试参数。 - LEF 路线保持为推荐路线：已实测可用，业务不受 Milkyway 路线未通影响。
附录 D：ICC2 Milkyway 路线排错记录（LIB-090 → LIB-105）¶
结果链：LIB-090（icc_shell_exec 缺失）→ 已解决；LIB-094（MW→NDM 转换成功）→ 已达成；
LIB-105（NDM 分组失败）→ 未解决。
Information: Loading technology file '…/saed32nm_1p9m_mw.tf' (FILE-007)
Warning: No db files from link_library to create reference libraries, will create a physical-only reference library. (LIB-081)
... run icc_shell to export Milkyway libraries. ← 老 ICC 被成功调起
... run icc2_lm_shell to import Milkyway libraries.
Information: Successfully converted 1 Milkyway libraries: saed32nm_rvt_1p9m. (LIB-094)
... run icc2_lm_shell to group libraries.
Error: Failed to group source data … (LIB-105)
分组日志关键行（CLIBs/log/pdk_mw_verify.nlib_group_libs.log）：
set FRAME_LIBS {CLIBs/auto_frame_libs/saed32nm_rvt_1p9m.ndm}
set LEF_FILES {}
set DB_FILES {}
set_app_options -name lib.workspace.group_libs_combine_physical_only -value false
...Created 0 lib groups
Warning: No workspace to write. (LMUI-042)
已排除的两条路径（均有实测证据）
- 从
icc2_shell层改写分组选项 —— 报Invalid option name 'lib.workspace.group_libs_combine_physical_only'； 且该串只出现在linux64/nwtn/bin/{icc2_lm_exec,dgcom_exec*}的二进制字符串表中， 属icc2_lm_shell内部选项，icc2_shell层不可见（工具树内也 grep 不到文档/选项定义）。 - 以
-ref_libs同时传 CCS 时序库 —— 报'…/saed32rvt_tt0p85v25c.db' is not a valid NDM binary file (NDM-020)，.db不能作为 NDM 参考库直接传入。
当前认知：根因是 Milkyway 库为 physical-only（无逻辑库，LIB-081），而分组脚本对纯物理
库不建组。可能的后续方向（本次未验证）：从 icc2_lm_shell 层注入给参数、用 Library Compiler
生成 NDM 参考库、或确认 ICC2 对纯物理 MW 库的官方转换前置条件。探查手段已用到工具自省
（set_app_options -list，不支持通配符）与工具树 grep，均无果——按"同一逻辑连续失败 2 次即止"
的约定停止试错，转为登记。
附录 E：修订记录¶
| 日期 | 修改人 | 变更内容 |
|---|---|---|
| 2026-09-29 | TraeCode 会话 | 初版：ICC 安装上线 + module 入口 + ICC2 Milkyway 路线探针（LIB-105 未通） |
来源：
/home/rain/Documents/eda_tools_ins/Synopsys/synopsys_icc_install_20260929/docs/SOP.md｜ 最后更新：2026-09-29 03:49（由build/sync.py同步，请勿在站点侧修改）