DB2异机恢复实战：NetBackup Agent配置与归档日志模式避坑指南

DB2异机恢复实战：NetBackup Agent配置与归档日志模式避坑指南

发布时间：2026/10/17 16:00:24
DB2异机恢复实战：NetBackup Agent配置与归档日志模式避坑指南 简介这份文档面向使用 NetBackup 实现 DB2 数据库异机恢复的运维与 DBA 人员聚焦备份配置与恢复流程中的关键环节适合具备一定 DB2 与 NBU 基础、需要搭建或排查异机恢复环境的技术人员参考。资源包内共 1 个 doc 文件压缩包约 314KB内容以配置说明与脚本示例为主便于直接对照操作。文档围绕 DB2 Agent 配置、db2_config 运行与 db2uext2 用户出口程序部署展开并给出 userexit、logretain、trackmod 等参数设置方法使数据库进入归档日志与增量备份模式。同时涵盖 db2_backup 备份脚本中 DB2_CLIENT、DB2_SERVER、DB2_POLICY、DB2_SCHED 等变量含义以及 db2.conf 中 DATABASE、OBJECTTYPE、POLICY、SCHEDULE、ARCFUNC、RETDIR 等策略配置写法帮助读者理清异机恢复所需的备份策略与归档日志管理思路。目前已有 335 人学习下载适合需要快速掌握 DB2 异机恢复配置要点的读者参考。1. DB2 异机恢复环境搭建从 Agent 配置到归档日志模式的一次性踩坑记录DB2 异机恢复这件事听起来像是 DBA 的活但真正落地的时候卡住你的往往不是 restore 命令本身而是 NetBackup Agent 装完之后那一堆参数没配对。我见过太多人拿到一份备份在目标机上敲完db2 restore直接报 SQL2071N或者恢复出来只有表结构没有数据最后发现是db2.conf里少写了一行CLIENT_NAME。这套环境的核心组件就三个DB2 实例、NetBackup Agent、以及连接两者的用户出口程序db2uext2。装不好备份文件就在磁带里躺着你连读都读不出来。这篇笔记适合正在做 DB2 异机恢复、或者准备把生产库备份恢复到测试环境的运维和 DBA我会把从 Agent 配置到最终验证的完整路径拆开每一步都给出可抄的命令和参数说明。2. 安装前必须锁死的环境参数DB2 实例与 NBU Agent 版本对齐2.1 确认 DB2 实例状态与归档日志模式在碰 NetBackup 之前先把 DB2 这边的底子摸清楚。异机恢复能不能成第一道门槛就是源库是不是归档日志模式。如果源库还在循环日志模式你拿到的备份只能恢复到备份完成那个时间点后面的日志全丢异机恢复基本没意义。登录到 DB2 实例用户下先看当前数据库的配置su - db2inst1 db2 get db cfg for sample | grep -i log retain\|user exit\|track mod输出里重点看三个参数Log retain for recovery status、User exit for logging status、Track modified pages。如果Log retain是No说明数据库还在循环日志模式这时候做在线备份恢复时只能恢复到备份结束点没法做 rollforward。我一般会先把这三个参数改掉db2 update db cfg for sample using logretain on db2 update db cfg for sample using userexit on db2 update db cfg for sample using trackmod yes这三条命令执行完数据库会进入归档日志模式。注意userexit on是让 DB2 调用 NetBackup 提供的db2uext2程序来归档日志trackmod yes是开启增量备份跟踪。改完参数后数据库会处于 backup pending 状态必须做一次全备份才能继续连接db2 backup database sample to /tmp这个全备份路径可以自己指定但一定要做否则应用连不上库。常见做法是改完参数立刻做一次全备然后再继续后面的 Agent 配置。2.2 运行 db2_config 完成 Agent 与 DB2 的对接NetBackup Agent 装完之后不会自动把db2uext2放到 DB2 的目录里。需要手动跑一次配置脚本/usr/openv/netbackup/bin/db2_config这个脚本做的事情很简单把 NBU 提供的用户出口程序db2uext2复制到db2instance/sqllib/adm目录下。比如实例是db2inst1那目标路径就是/home/db2inst1/sqllib/adm/db2uext2。跑完之后可以验证一下ls -l /home/db2inst1/sqllib/adm/db2uext2如果文件存在且权限是db2inst1可执行说明 Agent 对接完成。这一步经常被跳过结果就是 DB2 归档日志时找不到出口程序日志归档失败异机恢复时日志链断裂。2.3 配置 db2.conf 文件异机恢复的关键在 CLIENT_NAMEdb2.conf是 NetBackup for DB2 的核心配置文件位置在/usr/openv/netbackup/db2.conf。这个文件分两段一段管数据库备份一段管归档日志备份。异机恢复和本机恢复最大的区别就是要在两段里都加上CLIENT_NAME指向源客户端的主机名。# 数据库备份段 DATABASE BI OBJECTTYPE DATABASE POLICY DB2_Backup SCHEDULE Default-Application-Backup CLIENT_NAME gdccas670 ENDOPER # 归档日志备份段 DATABASE BI OBJECTTYPE ARCHIVE POLICY User_Backup SCHEDULE UserBackup CLIENT_NAME gdccas670 ARCFUNC SAVE ENDOPER这里DATABASE BI指定要恢复的数据库名POLICY和SCHEDULE必须和源端备份策略完全一致否则 NBU 找不到对应的备份镜像。CLIENT_NAME是异机恢复的开关不写这行NBU 会默认去当前主机名下面找备份找不到就报错。ARCFUNC SAVE表示归档日志通过 NetBackup 保存到存储单元如果是COPY模式日志会落到本地磁盘目录需要配合ARCDIR和RETDIR使用。提示db2.conf修改后不需要重启 NBU 服务但需要确保 DB2 实例用户对文件有读权限。2.4 在 Master Server 上打开异机恢复权限默认情况下NetBackup 不允许异机恢复。需要在 Master Server 上用 root 权限创建一个空文件touch /usr/openv/netbackup/db/altnames/No.Restrictions这个文件的作用是解除恢复目标主机的限制。如果不创建恢复时会报cannot connect to client或者restore not allowed。创建完之后不需要重启服务NBU 会实时读取这个目录下的配置。3. 异机恢复实操从 bplist 定位备份镜像到 rollforward 收尾3.1 用 bplist 找到可恢复的备份时间点异机恢复的第一步不是敲 restore而是先确认目标机上能看到源端的备份镜像。用bplist命令列出指定客户端的 DB2 备份bplist -C gdccas670 -t 18 -R /参数说明-C指定源客户端名-t 18是 DB2 备份的类型代码-R /表示递归列出根目录下所有备份。输出会类似这样/DB2/BI/node0000/20050226120711/BI.0.dwccbxm.node0000.642.20050226120711.4 /DB2/BI/node0000/20050226120711/BI.0.dwccbxm.node0000.642.20050226120711.3 /DB2/BI/node0000/20050226120711/BI.0.dwccbxm.node0000.642.20050226120711.2 /DB2/BI/node0000/20050226120711/BI.0.dwccbxm.node0000.642.20050226120711.1路径里的20050226120711就是备份的精确时间点。如果只想恢复到某个特定版本记下这个时间戳restore 时用taken at指定。3.2 OFFLINE 备份的异机恢复命令如果源端做的是离线备份恢复时不需要 rollforward但必须在 restore 命令里加without rolling forwardsu - db2inst1 db2 restore db bi load /usr/openv/netbackup/bin/nbdb2.sl without rolling forward without prompting如果目标机上数据库不存在需要加to参数指定恢复路径db2 restore db bi load /usr/openv/netbackup/bin/nbdb2.sl to /db_dir without rolling forward without promptingload后面跟的是 NBU 的 DB2 库文件路径Linux 32 位是nbdb2.so64 位是nbdb2.so64AIX 和 HPUX 对应.sl和.sl64。这个库文件是 NBU 提供的 Vendor I/O Libraryrestore 命令通过它从 NBU 存储里读备份数据。如果要恢复到指定版本加上taken atdb2 restore db bi load /usr/openv/netbackup/bin/nbdb2.sl taken at 20050226120711 without rolling forward without prompting3.3 ONLINE 备份的异机恢复与 rollforward在线备份的恢复必须做 rollforward否则数据库处于 rollforward pending 状态无法连接。先执行 restoredb2 restore db bi load /usr/openv/netbackup/bin/nbdb2.sl如果数据库不存在同样加to参数db2 restore db bi load /usr/openv/netbackup/bin/nbdb2.sl to /db_dir然后执行 rollforward 到日志末尾db2 rollforward db bi to end of logs and complete如果要恢复到指定时间点restore 时用taken at指定备份版本rollforward 时用to指定时间db2 restore db bi load /usr/openv/netbackup/bin/nbdb2.sl taken at 20050226120711 db2 rollforward db bi to 2005-02-26-12:07:11 using local time and complete注意有些 DB2 版本没有using local time选项。如果操作系统时间和标准时间有差异rollforward 指定的时间要减去这个差值。我一般会先用date命令确认系统时间再决定要不要调整。3.4 恢复后的连接验证与日志检查rollforward 完成后数据库应该处于正常状态。用db2 connect验证db2 connect to bi db2 select count(*) from syscat.tables如果能连上且能查系统表说明恢复基本成功。然后检查归档日志状态db2 get db cfg for bi | grep -i log retain\|user exit确认Log retain和User exit都是Yes否则后续日志归档会出问题。最后看一眼db2diag.log有没有报错tail -50 /home/db2inst1/sqllib/db2dump/db2diag.log重点看有没有SQL2071N或者db2uext2相关的错误。如果有说明归档日志链路还有问题需要回头检查db2.conf和db2uext2的权限。4. 避坑与排查DB2 异机恢复最常见的 5 个翻车点4.1 恢复报 SQL2071N找不到备份镜像现象执行db2 restore时直接报SQL2071N An error occurred while accessing the NetBackup vendor library。原因db2.conf里没有写CLIENT_NAME或者写错了源客户端名。NBU 默认去当前主机名下面找备份异机恢复时当前主机名和源客户端不一致自然找不到。解决检查/usr/openv/netbackup/db2.conf里两段配置是否都加了CLIENT_NAME值必须是源端备份时的客户端名。可以用bplist -C 源客户端名 -t 18 -R /确认源端备份可见。4.2 恢复后数据库无法连接rollforward 没做现象restore 成功但db2 connect to bi报SQL1117N或者数据库处于 rollforward pending 状态。原因在线备份恢复后必须做 rollforward离线备份恢复时如果没加without rolling forward数据库也会处于 pending 状态。解决在线备份执行db2 rollforward db bi to end of logs and complete离线备份在 restore 命令里加without rolling forward。4.3 归档日志恢复失败db2uext2 权限不对现象rollforward 时提示找不到归档日志或者db2diag.log里报db2uext2执行失败。原因db2_config脚本没有以正确用户运行导致db2uext2复制到sqllib/adm后权限不对DB2 实例用户无法执行。解决用db2inst1用户重新运行/usr/openv/netbackup/bin/db2_config然后检查ls -l /home/db2inst1/sqllib/adm/db2uext2确保属主是db2inst1且有执行权限。4.4 异机恢复被拒绝No.Restrictions 文件没建现象restore 时报restore not allowed或者cannot connect to client。原因Master Server 上没有创建/usr/openv/netbackup/db/altnames/No.Restrictions文件NBU 默认禁止异机恢复。解决在 Master Server 上用 root 执行touch /usr/openv/netbackup/db/altnames/No.Restrictions不需要重启服务。4.5 恢复到指定时间点失败时间差没算对现象db2 rollforward db bi to 2005-02-26-12:07:11 using local time and complete报错提示时间点无效。原因有些 DB2 版本不支持using local time或者操作系统时间与标准时间有偏差导致指定的时间点不在日志范围内。解决先确认 DB2 版本是否支持using local time不支持就去掉这个选项。如果系统时间有偏差rollforward 的时间要减去差值。我一般会先用bplist确认备份时间戳再用db2 rollforward db bi query status看当前日志范围。5. 装完怎么验证异机恢复后的三项强制检查恢复完成不代表万事大吉我一般会强制走一遍下面三项检查确认数据库真的可用。第一项连接与查询验证。用db2 connect to bi连上数据库然后跑一条业务相关的查询比如select count(*) from 业务表。这一步能排除掉“数据库能连但表空间损坏”的情况。如果查询报SQL0290N或者表空间不可用说明恢复过程中表空间路径有问题需要检查to /db_dir指定的路径是否和源端一致。第二项归档日志状态检查。执行db2 get db cfg for bi | grep -i log retain\|user exit\|track mod确认三个参数都是开启状态。如果Log retain变成No说明恢复过程中数据库配置被重置了需要重新执行db2 update db cfg改回来。这一步经常被忽略结果就是恢复完的库没法做增量备份下次恢复又得从头来。第三项备份链路验证。在恢复后的数据库上做一次全备份确认 NBU 能正常抓取db2 backup database bi online to /tmp如果备份成功说明db2uext2和db2.conf配置都没问题。如果报错回头检查db2.conf里的POLICY和SCHEDULE是否和当前 NBU 策略匹配。下面这张表是我整理的环境参数对照恢复前后都可以拿来核对检查项恢复前要求恢复后验证命令归档日志模式Log retain Yesdb2 get db cfg for bi | grep -i log retain用户出口程序User exit Yesdb2 get db cfg for bi | grep -i user exit增量备份跟踪Track mod Yesdb2 get db cfg for bi | grep -i track moddb2uext2 权限db2inst1 可执行ls -l /home/db2inst1/sqllib/adm/db2uext2异机恢复权限No.Restrictions 存在ls -l /usr/openv/netbackup/db/altnames/No.Restrictions备份镜像可见bplist 能列出bplist -C 源客户端 -t 18 -R /从那以后我每次做异机恢复都会在 restore 之前先跑一遍bplist确认镜像可见恢复完立刻做一次全备份验证链路。这个习惯帮我省掉了至少三次“恢复成功但备份失败”的返工。希望帮到你。本文还有配套的精品资源点击获取