简介：一份面向Cadence Virtuoso IC617使用者的实操型PDF文档，聚焦旧工艺库从CDB数据迁移到OpenAccess格式这一常见痛点：早期在IC514上使用的PDK放到IC617中打开时，常出现ddUpdateLibList相关警告，提示正在对CDB数据运行OA可执行程序，导致库无法正常加载。文档围绕cdb2oa转换展开，兼顾命令行调用与Conversion Toolbox中CDB to OpenAccess Translator两种方式，说明如何指定cds.lib、将转换结果保存到home目录并回填至原PDK，同时给出重启Virtuoso后的检查验证思路，涉及库路径设置、文件替换和常见警告处理，适合模拟电路与版图设计工程师、PDK库维护人员参考。压缩包内仅1个PDF文件，约697KB，篇幅精简、便于随查随用，可作为工艺库升级与环境迁移时的排错参照；对需要把旧工艺库升级到IC617的读者，能减少反复试错成本并快速定位转换失败原因。目前已有1556人学习。
1. 别急着删库：IC617 打开旧 PDK 先撞上的那行 CDB 警告
从旧机器整目录拖过来的 0.35um 工艺库，在 IC514 上跑了几年都相安无事，换到 IC617 上执行virtuoso &，CIW 窗口先刷出一屏Warning: ddUpdateLibList: It appears that you are trying to run an OA executable on CDB data. Library 'oldpdk035' contains file '/home/user/pdk/oldpdk035/prop.xx' which is CDB data.库还能在 Library Manager 里列出来，但符号一打开就报错，原理图里器件参数读不出来。原因不复杂：IC617 走的是 OpenAccess（OA）数据模型，而老工艺库存的还是 CDB 格式，一个 OA 的可执行程序去读 CDB 的数据，必然对不上。把 CDB 转换为 OA 就是这道坎的解法，用 IC617 自带的 cdb2oa 和 Conversion Toolbox 就能做完，不必重装 PDK。这套流程适合手上压着旧工艺库、又必须升到 IC617 的版图与电路开发者，也适合要给整个组做环境迁移的运维。
2. 装什么版本：IC617 的 OA 环境与 cdb2oa 工具链盘点
动手转换前先把环境摊开看一遍。我见过太多人一上来就开转换工具，跑到一半发现 virtuoso 版本不对、cdb2oa 根本不在 PATH 里，白白浪费一个下午。这一章的目标只有一个：确认你机器上的 IC617 是完整安装，转换工具确实落地了，环境变量在打开终端那一刻就生效。
2.1 IC617 最小环境清单与版本对照
转换这件事对版本其实不挑，只要是 IC617 自带的工具链就行，但下面这几样必须齐。缺一样，转换中途就会以各种看不懂的报错收场。
| 组件 | 版本/形态 | 用途 | 检查命令 |
|---|---|---|---|
| Virtuoso 主程序 | IC617（IC6.1.7 系列） | 启动 CIW、Library Manager 与转换工具 | virtuoso -W看版本横幅 |
| cdb2oa | 随 IC617 一起安装 | 真正执行 CDB 到 OA 的数据转换 | which cdb2oa |
| 转换工具箱 | Conversion Toolbox | 图形化驱动 cdb2oa，看进度和日志 | CIW 菜单 Tools 下可见 |
| 旧工艺库 | CDB 格式，含prop.xx | 被转换的源数据 | ls <pdk>/prop.xx |
| 重新打开 Virtuoso 的方式 | 命令行virtuoso & | 验证转换结果 | CIW 无 CDB 警告 |
判断一个库到底是 CDB 还是 OA，最省事的办法是看目录里有没有prop.xx这个属性文件。有这个文件，基本可以判定是 CDB 库，转换之后它应该消失；如果转换完prop.xx还躺在里面，IC617 就会继续抛前面那行警告，这一点在后面的避坑章节还会再提。
版本上唯一要注意的是别混装。机器上如果同时存在 IC514 和 IC617，两个版本的环境变量、license 端口、库路径很容易串味。我一般会把它们写进两个独立的 shell 脚本，用哪个 source 哪个，绝不在同一个.bashrc里同时 export。
提示：转换前先在 CIW 里
Help -> About确认一次版本，别只信which virtuoso指过去的那个。
2.2 环境变量与 Virtuoso 启动：把 PATH 和库路径配到位
转换工具是从 Virtuoso 里调起来的，所以 Virtuoso 本身必须先能干净启动。下面这份环境脚本是我在 IC617 上惯用的最小集合，写进~/eda/ic617.sh，每次开新终端 source 一下。
# ~/eda/ic617.sh —— IC617 最小启动环境 export CDS_INST_DIR=/opt/eda/IC617 # IC617 安装根目录，按实际路径改 export PATH=$CDS_INST_DIR/tools/bin:$CDS_INST_DIR/tools/dfII/bin:$PATH export CDS_LIC_FILE=5280@lic-srv # license 端口@服务端，按实际改 export CDS_Netlisting_Mode=Analog # 网表模式，模拟流程保持 Analog export CDS_LOG_PATH=$HOME/cds_log # 日志集中放，转换出错时好翻 mkdir -p $CDS_LOG_PATH cd $HOME/work && virtuoso &CDS_INST_DIR是整棵安装树的根，PATH 里那两个 bin 目录缺一不可——tools/bin放的是 cdb2oa 这类独立可执行程序，tools/dfII/bin放的是 virtuoso 主程序。CDS_LIC_FILE写成端口@主机的形式，端口不对 Virtuoso 会直接起不来，而不是报权限错误，这点很容易误判。CDS_LOG_PATH是给自己留的后路，转换这种一次性操作，日志散落在各个目录里等于没有日志。
启动之后先别急着开工具，在 CIW 里敲一句getVersion()，能正常返回版本号，说明 license 和环境都对上了。这一步花三十秒，能省掉后面半小时的排查。
2.3 确认 cdb2oa 与转换工具箱就位
在终端里直接验证一次：
# 确认可执行文件位置与帮助信息 which cdb2oa cdb2oa -h 2>&1 | head -20 # 确认 Conversion Toolbox 的菜单脚本存在 ls $CDS_INST_DIR/tools/dfII/etc/tools/ | grep -i convwhich cdb2oa有输出，说明 PATH 配对了；cdb2oa -h能把参数列表打出来，说明动态库加载没问题——如果这里报error while loading shared libraries，那就是LD_LIBRARY_PATH没带上 IC617 的库目录，export LD_LIBRARY_PATH=$CDS_INST_DIR/tools/lib:$LD_LIBRARY_PATH补上再试。第三条是看转换工具箱的菜单描述文件在不在，这个目录名在不同小版本里可能叫conv或conversion，grep -i conv是为了两种情况都能命中。
三条都过了，环境这一关就算过了。接下来的活是把源数据收拾干净。
3. 转换前的准备：备份、cds.lib 收敛、保存到 home
转换工具做的事情本质上是「读 cds.lib 找到库，逐个 cell 重写成 OA 结构」。它认的是 cds.lib 里的绝对路径，路径写错、库定义分散在好几个文件里、或者没备份就让它直接往原目录写，都是翻车的起点。这一章的三件事，顺序不能换。
3.1 备份 PDK：一条 tar 命令换来后悔药
先说最要紧的。转换工具默认会往库目录里写东西，中途中断还可能留下半成品。我见过有人转换失败后直接删了prop.xx想「手动修复」，结果整个工艺库的参数全丢，只能找原厂重新要一份。
# 整库打包，文件名带上日期，别覆盖历史备份 mkdir -p /home/user/backup cd /home/user/pdk tar -czf /home/user/backup/oldpdk035_$(date +%Y%m%d).tar.gz oldpdk035 # 顺手记一份转换前的目录指纹，转完可以对比 find oldpdk035 -maxdepth 2 -type d | sort > /home/user/backup/oldpdk035_tree_before.txt第一行建备份目录，第二行tar -czf把整个 PDK 目录压成一个包，$(date +%Y%m%d)保证同一天多次备份不会互相覆盖——我一般一天之内动手两次以上就会加时分，比如$(date +%Y%m%d_%H%M)。第三条目录树快照看着多余，实际很有用：转换完拿diff一比，哪些子目录被新建、哪些被清空一目了然，比翻日志快。
备份包建议放到另一个磁盘或者至少另一个挂载点，别和 PDK 放同一个分区。同一分区上做备份，等于没备份。
3.2 收敛 cds.lib：把库路径改成绝对路径、把 prop.xx 摆到明面上
cds.lib 是这个流程的核心输入。转换工具打开时只要这个文件，它顺着里面的DEFINE和INCLUDE一条条找库。所以先把它收敛成一份「扁平」的清单：全绝对路径、少用嵌套 INCLUDE、一眼能看完。
原文件里常见这种写法：
-- 转换前：路径混用、INCLUDE 套 INCLUDE INCLUDE ./../common/tech.lib DEFINE oldpdk035 ./oldpdk035 DEFINE analogLib $CDS_INST_DIR/tools/dfII/etc/cdslib/artist/analogLib SOFTINCLUDE /home/user/pdk/extra.lib收敛之后：
-- 转换后：工艺库单独列，路径全部绝对 DEFINE oldpdk035 /home/user/pdk/oldpdk035 DEFINE oldpdk035_tech /home/user/pdk/oldpdk035_tech -- 系统库保持指向安装目录，别拷进 PDK 里 DEFINE analogLib /opt/eda/IC617/tools/dfII/etc/cdslib/artist/analogLib DEFINE basic /opt/eda/IC617/tools/dfII/etc/cdslib/basicDEFINE 库名 绝对路径是唯一需要转换工具看懂的行，把相对路径./oldpdk035改成绝对路径，是为了避免「你在 A 目录启动工具、工具却按 B 目录解析相对路径」这类玄学问题。系统库（analogLib、basic）保持指向安装目录，不要拷进 PDK 里，否则转换工具可能顺手把它们也当源库处理，白白多跑一遍。INCLUDE尽量展开成DEFINE，实在要保留就换成SOFTINCLUDE——INCLUDE找不到文件会直接中止，SOFTINCLUDE找不到只是跳过，转换场景下后者更抗造。
改完cds.lib之后，把 PDK 根目录下的prop.xx位置记下来：ls -l /home/user/pdk/oldpdk035/prop.xx。它存在，说明这个库确实是 CDB 数据，转换是必须做的；它不存在而警告还在，那多半是 cds.lib 指到了另一个残留目录。
3.3 在 Virtuoso 里 Save As 把 cds.lib 存到 home 目录
这一步是原流程里最容易被跳过、又最容易出错的地方。转换工具默认从当前工作目录找 cds.lib，而多数人是在 PDK 目录下启动 Virtuoso 的，直接改库目录里的那份文件，等于把源数据和配置文件绑死在一起。
正确做法是先让 Virtuoso 认识库，再把这份路径清单另存一份到 home 目录：
CIW 菜单路径： Tools -> Library Manager Library Manager 窗口 -> File -> Save As 目标目录选 /home/user，文件名写 cds.lib OK存完之后确认一下：
# 检查 home 下的 cds.lib 内容与时间戳 ls -l /home/user/cds.lib grep -c "^DEFINE" /home/user/cds.libgrep -c数一下 DEFINE 条数，和你预期认识的库数量对得上，说明保存的是完整清单而不是被过滤过的子集。这一步的实质是把「库路径定义」从 PDK 目录里剥离出来，转换工具读的是 home 下这份，写出去的 OA 库也落在独立目录里，源数据保持只读状态——这才有回滚的余地。
注意：Save As 之后别再回头改 PDK 目录里那份旧的 cds.lib。两份文件同时存在时，转换工具读到哪份完全取决于你从哪个目录启动，很容易出现「改了半天没生效」。
4. 跑通转换：Conversion Toolbox 图形流程与 cdb2oa 命令行
前面三章都是铺垫，这一章是真正把 CDB 数据变成 OA 数据的动作。图形界面适合第一次做、需要盯着进度；命令行适合批量、适合写进脚本。两条路我都走过，先说图形这条。
4.1 启动 Conversion Toolbox，打开 CDB to OpenAccess Translator
在 home 目录下启动 Virtuoso，这是有讲究的——转换工具会以启动目录为基准解析相对路径，在 home 下启动，输入的 cds.lib 和输出的库目录都在可控范围内。
cd /home/user virtuoso &起来之后在 CIW 里依次点：
CIW -> Tools -> Conversion Toolbox Conversion Toolbox 窗口 -> CDB to OpenAccess TranslatorConversion Toolbox 里挂着好几个转换器（CDB 到 OA、LEF 到 OA 之类），认准CDB to OpenAccess Translator这一项。如果菜单里根本看不到 Conversion Toolbox，回到 2.3 节检查那个etc/tools目录，多半是安装时没勾选转换组件，得让管理员补装。
4.2 路径选取 cds.lib 并开始转换
打开转换器后只有一个关键输入：cds.lib 的路径。填 3.3 节存到 home 的那份：
CDB to OpenAccess Translator 面板 Input cds.lib : /home/user/cds.lib 输出选项 : 保持默认（输出到各库同级目录） 点 OK / Apply 开始点下去之后会弹一个进度窗口，逐个库、逐个 cell 地转换。这个阶段最忌讳两件事：一是手动 Ctrl+C 打断，二是同时用 Virtuoso 打开同一个库。中断会在库目录里留下半写状态的文件，再转一次可能报「目标已存在」；同时打开则可能撞文件锁。
等待期间可以另开一个终端盯日志：
# 盯转换日志的尾部，看当前在转哪个库 tail -f $CDS_LOG_PATH/cdb2oa*.log日志里正常会出现Converting library <库名>、Converting cell <cell 名>这类行。如果某一行之后长时间没有新内容，别急着判断卡死，先看ps -ef | grep cdb2oa，进程还在跑就继续等；进程没了但窗口没关，说明已经异常退出，转去第 5 章排查。
转换完成后回到 home 目录，会看到一个或多个新生成的非 CDB 库目录，名字通常带后缀或与源库同名但位于输出路径下。原流程里下一步是把它复制回原 PDK：
# 先删旧库，再把转换好的库拷进去 cd /home/user/pdk mv oldpdk035 oldpdk035_cdb_bak # 不直接 rm，留一份可回滚 cp -r /home/user/oldpdk035 ./oldpdk035 # 拷回原位 ls -l oldpdk035/prop.xx # 应该提示 No such file第一行用mv而不是rm -rf，是把旧库「挪走」而不是「销毁」，出问题还能挪回来。第三条ls是用它报错来验证——prop.xx不存在了，才说明这个库真的变成 OA 结构了。如果它还在，说明拷贝时把旧文件一起带过来了，重新拷一次，别手软。
4.3 命令行 cdb2oa：批量与脚本化场景
图形界面一次只能盯着一个库，组里要迁五六个旧 PDK 的时候，我一般直接用 cdb2oa。基本形态是这样：
# 单库转换：-i 指定源库目录，-o 指定输出目录，-log 落日志 cdb2oa \ -i /home/user/pdk/oldpdk035 \ -o /home/user/oa_out/oldpdk035 \ -log /home/user/cds_log/cdb2oa_oldpdk035.log # 批量：把要转的库列进清单，循环跑 for lib in oldpdk035 oldpdk018 analog_legacy; do cdb2oa -i /home/user/pdk/$lib \ -o /home/user/oa_out/$lib \ -log /home/user/cds_log/cdb2oa_$lib.log || echo "$lib 转换失败" >> /home/user/cds_log/failed.txt done-i指向被转换的库目录，-o是输出目录，两者分开写是刻意的——失败时源数据完好无损，重跑不用重新备份。-log指定日志路径，批量循环里每个库一份独立日志，出问题能直接定位到库而不是翻一锅粥。|| echo ... >> failed.txt是失败兜底，某个库转失败不会中断整批，事后看failed.txt就知道该回头处理谁。
关于参数名，不同小版本之间cdb2oa的选项拼写并不完全一致，有的版本用-cdslib指定 cds.lib、有的用-i直接给库目录。动手前花十秒钟跑一次cdb2oa -h，比照着你机器上的实际输出来写，别照抄别人博客里的参数——这条血泪经验值一次通宵。
4.4 收尾核对：目录结构、文件类型与权限
转换和回填做完，先别开 Virtuoso 庆祝。花两分钟核对三件事：
# 1. 目录里没有 CDB 残留 find /home/user/pdk/oldpdk035 -maxdepth 1 -name "prop.xx" -o -name "*.cdb" # 2. 关键子目录还在 ls /home/user/pdk/oldpdk035 | head -20 # 3. 权限对普通用户可读 ls -ld /home/user/pdk/oldpdk035第一条find同时找prop.xx和*.cdb，输出为空才算干净。第二条看子目录是否完整——一个正常的工艺库至少要有 symbol、layout、techfile 相关的目录，少了哪个后面打开就会缺东西。第三条看权限，如果转换时用了sudo，生成的文件属主可能变成 root，普通用户进去只能读不能存，后面 Check and Save 会失败。真遇到了就chown -R user:group oldpdk035修回来。
5. 避坑与排查：五条踩坑记录
转换流程本身不复杂，坑都在边角上。下面五条是我和同事在 IC617 上真实撞过的，每条按现象、原因、解决写，照着对号入座能省不少时间。
5.1 转换完成但 Virtuoso 依旧报 OA executable on CDB data
现象：明明跑完了转换，重新打开 Virtuoso，CIW 里还是那行ddUpdateLibList: It appears that you are trying to run an OA executable on CDB data，库名和文件路径一模一样。
原因：两种可能。一是prop.xx没被清掉，转换工具只处理数据，不会主动删除这个标记文件；二是 Virtuoso 启动时读的 cds.lib 不是你以为的那份，DEFINE oldpdk035还指在旧目录上。
解决：先find <库目录> -name "prop.xx"，找到就删掉再启动；找不到就grep oldpdk035 ~/cds.lib，确认路径确实指向转换后的新目录。两个方向都排掉，警告才会消失。
5.2 转换工具选了 cds.lib 就卡在 0%，进度条不动
现象：面板上路径填好了，点 OK 之后进度条一直停在 0%，日志里连第一行Converting library都没出现。
原因：多数情况是 cds.lib 里的INCLUDE指到了一个不可达的路径，工具在解析阶段就挂了；少数情况是库目录权限不足，工具读不到目录内容，又没把错误抛到界面上。
解决：把 cds.lib 里的INCLUDE全展开成DEFINE再试一次；同时ls -l <库目录>确认当前用户有读和执行权限。如果 cds.lib 里定义了网络路径或已卸载的挂载点，先把那一行注释掉——工具不会跳过，它会一直等。
5.3 库能打开了，但 symbol 打不开、器件参数全空
现象：Library Manager 里能看到库和 cell 名，双击 symbol 报错，或者打开后图形框架在、参数编辑框里一片空白。
原因：转换时只迁了主库，配套的 techfile 库或者参数定义所在的附属库没跟着转。原流程里DEFINE只写了一条主库路径，附属库被漏在外面。
解决：回到 cds.lib，把 PDK 相关的库全部列进DEFINE，重新跑一遍转换；参数仍然缺的话，需要单独 attach 一次 techfile。这一步我一般会在转换前就把 PDK 目录下所有cds.lib里出现的库名列全，逐条确认，别靠记忆。
5.4 拷回 PDK 后新库「好像没生效」
现象：明明已经把转换好的库拷进 PDK 目录替换了旧库，打开 Virtuoso 看到的还是旧数据、旧 cell。
原因：一是 Virtuoso 进程没完全退出，.CDS之类的缓存还在内存或临时目录里；二是拷贝时cp -r把源目录嵌套进去了，实际路径变成oldpdk035/oldpdk035，工具读的还是外层那份。
解决：先ps -ef | grep virtuoso杀掉残留进程再启动；然后ls oldpdk035/oldpdk035检查有没有多套一层，有就挪出来。拷贝这类操作我习惯用cp -rT src dst，-T会把目标当目录内容处理，不会意外嵌套。
5.5 转换跑到一半中断，之后再转就报目标已存在
现象：转换中途因为磁盘满或误操作中断，重跑时提示输出目录已存在或某个 cell 写入失败。
原因：中断留下了半成品目录，工具认为目标已占位，不肯覆盖。
解决：df -h先确认磁盘空间，通常中断就是空间不够引起的，不解决空间问题重跑多少次都一样。空间够了就把输出目录整个删掉重来——rm -rf /home/user/oa_out/oldpdk035，然后从 4.3 节的命令重新跑。源库有备份在，这一步没什么心理负担。
6. 装完怎么验证：让转换后的 OA 库在 IC617 里真正跑起来
转换做完不等于跑通。我判断一套 PDK 是否迁成功，看的是「从 PDK 目录启动 Virtuoso 之后，一个完整的 cell 能不能走完打开、编辑、保存三步」。下面这套验证流程，五分钟左右能走完。
先在 PDK 目录下启动，而不是 home：
cd /home/user/pdk virtuoso &启动目录换成 PDK，是为了验证「日常使用场景」——同事打开 Virtuoso 就是从库目录进的，在 home 下验证通过、到 PDK 下报错的情况并不少见。启动后先看 CIW：没有任何ddUpdateLibList字样，才算第一关过了。
接着打开 Library Manager，找到oldpdk035，右键Properties，看库的属性里数据格式一项。这里显示为 OpenAccess 才算真正迁完，如果还标着 CDB，说明前面某一步的回填没落到位。
然后挑一个典型 cell 做完整动作。挑的时候别挑最简单的 inverter，挑一个带参数化器件、带 symbol 和 layout 的单元，覆盖度更高：
| 验证项 | 操作 | 通过标准 |
|---|---|---|
| 库格式 | Library Manager 右键 Properties | 显示 OpenAccess |
| 符号打开 | 双击 cell 的 symbol 视图 | 图形完整，无报错弹窗 |
| 参数读取 | 编辑器件属性 | CDF 参数有值、可修改 |
| 版图打开 | 打开 layout 视图 | 层次正常展开，无缺失 reference |
| 保存回路 | 改动后 Check and Save | 无 error，CIW 无异常输出 |
版图那一项最容易出问题。转换后的库如果 techfile 没挂上，layout 能打开但图层显示全灰，DRC 也跑不了。真遇到了，就在 Virtuoso 里Tools -> Technology File Manager重新 attach 一次 PDK 自带的 techfile，然后重开 layout 确认。
最后一步别省：故意改一个无关紧要的参数，执行 Check and Save，再关掉重开确认改动还在。这一步验证的是写权限和库结构完整性——转换出来的库如果属主不对，或者某些子目录是只读的，打开能看、保存就失败，而这个问题在只读浏览时完全暴露不出来。
提示：验证用的 cell 改完记得还原，别把测试改动带到正式库里。
从那以后我每次迁 PDK，不管转换工具报告多成功，都强制走一遍「PDK 目录启动 → 属性看格式 → symbol 和 layout 各开一个 → Check and Save」这条链。工具有它的判断，人有人的判断，两边对上了才算真的跑通。希望帮到你。
本文还有配套的精品资源，点击获取
