Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
cat_convert — 运行 NetBackup 目录库格式转换实用程序
大纲
-a2b [-o] [-s] [-v] source_file_directory [target_file_directory]
-dump [-short] [-noheader] [-nopath] [-nodata] [-srec num] [-erec num] [-sep char] source_file
-check source_file
-decompress compressed_filetarget_file_directory
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\
描述
cat_convert 用于在版本 3.4、4.0v 或 4.5 ASCII 格式与 4.5 或更高版本的二进制格式之间转换 NetBackup 目录库 .f
文件。它可自动检测源目录库文件格式并将其转换成其他格式。
-dump 选项使用户能查看二进制目录库映像 .f (dot-f) 文件的内容。它将在 stdout 上以可读格式回显 .f
文件的内容。它还有一些帮助选项,可用来将输出限制为仅显示文件中的某些记录或者某些输出列。
-check 选项可对指定的二进制 .f
文件执行一致性检查。
-decompress 选项允许您解压缩已使用 .Zl 压缩格式压缩的指定二进制 .f
文件。在 UNIX 平台上,它还支持 .Z
格式的解压缩。
如果 cat_convert 检测到存在不一致,实用程序最多会生成以下四个报告,具体取决于所报告的不一致的类型:
无效索引节点报告
此报告列出了无效的索引节点。下面是一个示例:
Type Problem Additional Information Dir No Data Path element name: SUNWmlib Dir No Name Filenum: 7 File No Data Path element name: vmd.uds File No Data Path element name: bpcompatd.uds File No Name Filenum: 8356 Dir No Name Filenum: 8374
下面描述了此报告中的列信息:
Type - 显示该项是文件还是目录。
Problem - 显示导致无效索引节点的原因是无数据还是无名称。
Additional information - 与索引节点关联的路径元素名称、目录库收到的索引节点的 filenum 字段,或一条错误消息。
无效目录报告
此报告列出了不一致的目录。下面是一个示例:
Index InodeIndex 1stChild 1stDir LastChild NextIndex NextDir Name 2539 2230 5605F -1 5605F 788763F -1 JSP.cla 21281 2229 43380F -1 1122108F 257809F 56110 fr.tmp 24157 3330 53103F -1 2688747F -1F -1 UNKNOWN 36766 4406 98367F -1 98367F -1F -1 Root 97393 5134 471040F -1 3136322F -1F -1 udst.js Total Directories: 150307 Total Files: 1137006
下面描述了此报告中的列信息:
Index - 报告给目录库的目录相对位置。
Inode Index - 备份正在进行时用于存储索引节点信息的临时文件的索引。
1st Child - 所列目录下的第一个子项(文件或目录)的索引。如果没有子项,则此值为 -1。如果第一个子项是文件,则索引后跟字符 F;如果第一个子项是目录,则索引后跟字符 D。
1st Dir - 所列目录下的第一个目录的索引。如果没有子目录,则此值为 -1。
Last Child - 所列目录下的最后一个子项(文件或目录)的索引。如果没有子项,则此值为 -1。如果最后一个子项是文件,则索引后跟字符 F;如果最后一个子项是目录,则索引后跟字符 D。
Next Index - 所列文件的下一个同级项(文件或目录)。如果没有同级项,则此值为 -1。如果下一个同级项是文件,则索引后跟字符 F;如果下一个同级项是目录,则索引后跟字符 D。
Next Dir - 所列目录的下一个同级项的索引。如果没有同级目录,则此值为 -1。
Name - 目录的短名称(如果有),或 UNKNOWN(如没有)。
无效文件报告
此报告列出不一致的文件。以下是此报告的格式:
Index Inode Index Next Index Name 2364 12180 2368F Report.doc 39774 16642 39776D UNKNOWN
下面描述了此报告中的列信息:
Index - 报告给目录库的文件相对位置。
Inode Index - 备份正在进行时用于存储索引节点信息的临时文件的索引。
Next Index - 所列文件的下一个同级项(文件或目录)。如果没有同级项,则此值为 -1。如果下一个同级项是文件,则索引后跟字符 F;如果下一个同级项是目录,则索引后跟字符 D。
Name - 目录的短名称(如果有),或 UNKNOWN(如没有)。
无效目录或文件报告
此报告列出不一致的文件和目录。以下是此报告的格式:
Index Inode Type Name 2363 11134 Directory /Documents/Directory 1 13679 10077 Directory /Documents/Directory 2 Total Directories: 460724 Total Files: 3426572
下面描述了此报告中的列信息:
Index - 报告给目录库的文件相对位置。
Inode - 报告给目录库的文件或目录的索引节点号。
Type - 显示该项是文件还是目录。
Name - 目录的短名称(如果有),或 UNKNOWN(如没有)。
由于此报告遍历目录树,可能无法列出前两个报告中报告的所有文件或目录。报告提供了文件或目录的完全限定名称,因此在解决问题时很有用。它还提供了文件和目录的总数。
这些报告未本地化。
必须有管理员权限才能运行此命令。
选项
- -a2b
将 NetBackup 3.4、4.0V、4.5 ASCII 格式的
.f
目录库文件转换为 NetBackup 4.5 二进制格式的.f
文件。- -check source_file
检查二进制 .f 文件的一致性。source_file 必须是完全限定的路径。不一致可能是由错误的 FlashBackup 或 NDMP 类型备份导致的。如果此实用程序未检测到不一致问题,则静默结束,并返回一个零返回代码。如果此实用程序检测到任何不一致问题,则返回不一致问题的数量,并最多输出三个报告(具体取决于所报告的不一致的类型)。
- -decompress compressed_filetarget_file_directory
解压缩指定的二进制 .f 压缩文件。compressed_file 必须是完全限定路径。-decompress 用于解压缩使用
.Zl
压缩格式压缩的目录库文件。在 UNIX 上,它还支持.Z
格式解压缩。target_directory 是解压缩操作放置解压缩文件的目录。- -dump
允许用户查看目录库映像
.f
文件的内容。- -erec num
修改 cat_convert -dump 的输出。在此记录编号处停止显示记录。
注意:
该记录编号不一定要与输出的第一列中的文件号相同。
- -nodata
删除 cat_convert -dump 输出的数据列。数据列会导致输出非常大量的内容。
- -noheader
修改 cat_convert -dump 的输出。此选项用于修改 cat_convert -dump 的输出。删除该列标题。
- -nopath
修改 cat_convert -dump 的输出。删除该路径列。路径列会导致输出非常大量的内容。
- -o
用新的内容重写原始目录库文件内容并转换格式。-o 不能与 target_file_directory 一起使用。
- -s
在控制台窗口中显示统计信息。
- -sep char
此选项用于修改 cat_convert -dump 的输出。此选项用于修改 cat_convert -dump 的输出。使用 char 分隔列,而不是使用默认的空格分隔。例如,可以使用该命令生成用逗号分隔的输出。
- -short
此选项用于修改 cat_convert -dump 的输出。将输出限制为通常情况下显示的列的子集。
- -srec num
此选项用于修改 cat_convert -dump 的输出。此选项用于修改 cat_convert -dump 的输出。从此记录编号开始显示记录。
注意:
该记录编号不一定要与输出的第一列中的文件号相同。
- target_file_directory
- -v
显示当前的进度信息。
指定要转换的以下项之一:
要指定目标文件,源必须是一个文件。
要指定目标目录,源必须是一个目录。
如果源是一个目录,必须使用 -a2b。
通过这种转换创建的新文件将被转换为指定格式,并在目标目录中使用原文件名。
如果在转换源文件时未指定目标文件或目录,则转换过程创建的文件会附带一个后缀(_bin.f 或 _ascii.f)。
如果 catalog .f
文件大小超过 4 MB,二进制目录库将使输出文件保持分开状态。并将它们放在 catstore 目录中。
示例
示例 1
# cat_convert -a2b abc.f
如果 abc.f 为 ASCII 格式,则 target_file_path 为 abc_bin.f。
示例 2
# cat_convert -a2b abc.f
abc.f 的内容将转换为二进制。
示例 3
# cat_convert -dump -short abc.f
abc.f 的内容将以用户可以阅读的格式显示在 stdout 中。