Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
NBCC — 运行 NetBackup 一致性检查 (NBCC) 实用程序。
大纲
[-batch] [-debug] [-gather] [-help] [-idar] [-kbfree ####] [-locale locale_name] [-nozip] [-nocleanup] [-terse] [-upgrade] [-use_reg_cmd [32 | 64]] [-version] [-unknown_image_servers_option]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/support/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\support\
描述
NBCC 命令执行 NBCC 实用程序,该实用程序用于确认 NetBackup 目录库和数据库部分的完整性,包括以下元素:
磁带介质和关联的映像
NBDB 映像、ImageCopy 表记录、ImageFragment 表记录和映像目录库
企业介质管理器 (EMM) 服务器条目和配置的存储单元条目
如果 NBCC 检测到目录库中存在不一致,将生成一组输出文件。此命令可以使用可用的系统实用程序创建这些文件的捆绑支持软件包。
这些不一致性包括 EMM 数据库无法识别其关联的介质服务器的映像。在这些情况下,可以使用 -unknown_image_servers_option 功能选择以下选项之一:注释掉已知介质服务器,使其失效或继承与这些未知介质服务器相关联的映像。
有关 NBCC 实用程序的更多信息,请参见《NetBackup 故障排除指南》。
选项
- -batch
在非交互模式下运行 NBCC。在此模式下,会出现以下情况:
如果输出报告已存在,则 NBCC 会自动重写它。
在处理 bpimagelist 信息之后,会标记 EMM 无法识别的任何介质服务器。然后,通过完整分析,可生成要注释掉的所有修复,供稍后查看。
如果 NBCC 未检测到 NetBackup 目录库中存在不一致,则不会创建支持软件包。
- -debug
向
nbcc-info.txt
文件添加其他程序调试信息,会大大增加该文件的大小。- -gather
仅收集 NetBackup 配置和目录库信息。此选项不检查 NetBackup 目录库的一致性。
- -help
输出有关 NBCC 实用程序的帮助信息增强版本。
- -idar
包括一致性检查中放弃的磁带介质资源的标识。
- -kbfree freespace
指定运行 NBCC 所需的可用文件系统空间量。仅允许指定整数值。默认值位于输出的帮助文档中。
NBCC 默认值是:文件系统可用空间(千字节) = 2048000。
要跳过所有的文件系统可用空间检查,请将此值设置为零 (0) 以便在非英语语言环境中运行。
- -locale locale_name
指定 NetBackup common_local_name。NBCC 在以下文件中搜索此名称:
在 UNIX 上:
/usr/openv/msg/.conf
在 Windows 上:
.\VERITAS\msg\LC_CONF
此名称确定用于 bpimagelist -d 命令行选项的关联日期格式。
- -nocleanup
如果 NBCC 运行一致性检查后没有检测到不一致,它将不清理生成的支持软件包或文件。
注意:
不要将 -nocleanup 选项和 -gather 选项一起使用。由于一致性检查状态,它们是互斥的。
- -nozip
跳过捆绑支持软件包创建过程。生成的 NBCC 文件仍在输出目录中。
- -terse
仅将与一致性检查相关的字段从每个目录库记录中提取到个别目录库内容文件中。
- -unknown_image_servers_option
指定一致性分析针对映像数据库中检测到的任何介质服务器(EMM 无法识别)执行的操作。option 是以下值之一:
comment_all - 注释掉分析程序生成的所有建议的修复操作 (SRA),这些操作与和未知介质服务器相关联的映像相关。因此,NBCCR 不会尝试处理这些注释掉修复。
expire_all - 分析程序为要进行处理的 NBCCR 生成的 SRA 会使与任何未知介质服务器相关联的所有映像失效。
inherit_all hostname - 指定已知介质服务器 (hostname) 来替换未知服务器。此新服务器会继承与任何未知介质服务器相关联的所有映像。该分析程序可为要进行处理的 NBCCR 生成这些 SRA 项目。
例如,通过以下命令,介质服务器 MS1 可继承与任何未知介质服务器相关联的所有映像。
# NBCC -unknown_image_servers_inherit_all MS1
- -upgrade
仅包括与 NetBackup 目录库升级能力相关的一致性检查。
- -use_reg_cmd [32 | 64]
允许使用
Reg.exe
实用程序查询 Windows 注册表。必须安装支持/reg:32
或 /reg:64 命令行参数的 Reg.exe 版本,此选项才能正确发挥作用。此选项仅用于 Windows 系统。
- -version
输出 NBCC 的内部版本号。
前提条件
需要具备以下项才能使用 NBCC 实用程序:
要让 NBCC 创建支持软件包(如果需要),必须在 $PATH 环境变量中包括以下程序的路径: tar 和 gzip。
如果 tar 不可用,请使用 makecab 程序(如果可用)捆绑和压缩输出文件。
如果这些程序都不可用,而您又需要单个支持软件包文件,则手动将输出目录中的文件捆绑到某个支持软件包。
如果不使用命令行选项 -kbfree 0,NBCC 将检查文件系统的使用特性。然后它将卸载配置信息和目录库信息,并创建支持软件包。这些信息包括文件系统可用空间 (KB)。(请参考 -kbfree 选项描述。)
EMM 服务器必须正常运行。
vmd 进程必须运行在主服务器以及在 NetBackup 配置中充当 EMM 服务器的所有其他服务器上。
bpdbm 进程必须运行在主服务器上。
在已安装的 NetBackup 上,所有介质服务器和 ltid 进程必须正在运行,且必须配置了网络服务。
必须将 NetBackup 配置中所有服务器上的 UTC 时间以及运行 NBCC 实用程序的服务器上的 UTC 时间同步到时差不超过几分钟的程度。
注意:
如果未能确保时钟同步,可能会使 NBCC 报告不准确的结果。
程序用法
以下是程序用法的注意事项:
NBCC 从支持目录运行(请参见提要)。如果要从其他目录运行,NBCC 将使用以下默认目录位置:
在 UNIX 上:
/usr/openv/netbackup/bin/support/config
在 Windows 上:
install_path\NetBackup\bin\support\
要确保正确地识别和修复目录库一致性问题,请确认: 从数据收集到修复工作完成的这段时间内,没有运行或启动任何 NetBackup 作业。由于此条件在大多数配置中都是不可能实现的,因此 NBCC 会尝试识别与活动的 NetBackup 作业相关联的磁带介质。由于在正常处理期间可能会发生传播延迟,因此可能无法识别所有活动的磁带介质。因此,您应当仔细查看一致性分析结果。
NBCC 会检测 EMM 主服务器。如果检测到多个主服务器,NBCC 会识别与运行它的系统相关联的主服务器。NBCC 使用识别的 EMM 主服务器来确定哪些 EMM 介质服务器与该主服务器关联。
返回值
将返回下列退出值:
0 = Consistency checks skipped (-gather) No inconsistency detected 1 = Inconsistency detected 2 = Program error condition detected: Invalid command line option .nbcc.lock file exists File permission problem File open/read/write problem Insufficient free disk space Unable to obtain the version of NetBackup Issue with NetBackup configuration information/detection Issue with NetBackup catalog information/detection 3 = -help information displayed -version information displayed