Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
- 索引
名称
bparchive — 将文件存档到 NetBackup 服务器
大纲
[-p policy] [-s schedule][-L progress_log [-en]] [-S master_server [,master_server,...]] [-t policy_type] [-w [hh:mm:ss]] [-k "keyword_phrase"] [-utf8] -f listfile | filenames
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\
描述
bparchive 处理命令行中列出的文件，或者处理使用 -f listfile 选项指定的文件中所列出的文件。输入的文件路径可以是文件名也可以是目录名。如果文件列表包括目录，则 bparchive 会从该目录本身开始将该目录的所有文件和子目录存档。
默认情况下，成功提交 bparchive 后，将返回到系统提示符状态。该命令在后台工作，它并不直接返回完成状态。可以使用 -w 选项更改此行为，使 bparchive 在前台工作，并在指定的时间段后返回完成状态。
如果创建了 progress-log 文件，则 bparchive 将信息性消息和错误消息写入此文件。请在运行 bparchive 命令之前创建此文件，并使用 -L progress_log 选项指定此文件。如果 bparchive 无法将所请求的任何文件或目录存档，请使用进度日志确定故障原因。
如果创建了具有写入权限的目录，则 bparchive 将在此目录中创建可用于故障排除的调试日志文件。
在 Windows 系统中，nbu_dir_path 是 install_path\NetBackup\logs\bparchive\
在 UNIX 系统上，该目录是 /usr/openv/netbackup/logs/bparchive/
如果 USEMAIL = mail_address，则 NetBackup 会将有关存档完成状态的邮件发送到 mail_address。按如下所示输入：非管理员用户应在 $HOME/bp.conf 文件中指定，管理员应在 /usr/openv/netbackup/bp.conf 文件中指定。此邮件是在存档进程完成时发送的。
以下限制适用于本命令：
在 UNIX 系统上：当使用 bparchive 将文件存档时，如要删除该文件，您必须是 root 用户或所有者以及主要组（作为所有者）的成员。另外，该文件不能为只读。否则，NetBackup 虽能保存该文件，但无法重置其访问时间 (
utime)，并且不会从磁盘中删除它们。在 Windows 系统中，要使用 bparchive 对一个文件存档，您必须拥有删除该文件的权限，并且该文件不能为只读。否则，NetBackup 只会保存文件，而不会从磁盘上删除它们。
在 UNIX 系统上：如果指定的 UNIX 文件是一个链接，bparchive 将仅存档此链接本身，而不存档它链接到的文件。
bparchive 不将 . 或 .. 目录条目存档，也不存档磁盘映像备份。
选项
- -f listfile
指定一个文件 (listfile)，其中包含要存档的文件的列表。该选项可用于代替 filenames 选项。在 listfile 中，将每个文件路径单独放在一行内。
文件列表所要求的格式取决于文件名称中是否包含空格、换行符或回车。要将名称中不含空格、换行符或回车的文件存档，请使用以下格式：
filepath
要存档的文件的路径。以下是 UNIX 系统上的一些示例：
/home、/etc 和/var。以下是 Windows 系统上的一些示例：c:\Programs和 c:\documents\old_memos要将名称中包含空格、换行符或回车的文件存档，请使用以下格式：
filepathlen filepath
其中，filepath 是要存档的文件的路径，而 filepathlen 是文件路径中的字符数。
要存档的文件的路径。以下是 UNIX 系统上的一些示例：
/home、/etc和/var。以下是 Windows 系统上的一些示例：c:\Programs和 c:\documents\old_memos以下是 UNIX 系统上的一些示例：
5 /home 4 /etc 4 /var 19 /home/abc/test file
以下是 Windows 系统上的一些示例：
11 c:\Programs 8 c:\winnt 22 c:\documents\old memos
- filenames
命名一个或多个要存档的文件，并可用来代替 -f 选项。必须将指定的任何文件列在结尾处，并位于所有其他选项之后。
- -k keyword_phrase
指定一个关键字短语，NetBackup 会将其与此存档操作所创建的映像相关联。此后，您可以在 bprestore 命令中使用 -k 选项指定该关键字短语来还原映像。
关键字短语是存档的文本描述，长度最大为 128 个字符。允许使用所有可打印字符，包括空格 ( ) 和句号 (.)。
用双引号 ("...") 或单引号 ('...') 将该短语括起来。
默认的关键字短语为空字符串。
- -L progress_log [-en]
指定要在其中写入进度信息的现有文件的名称。
在 UNIX 系统上，文件名必须以 / 开头。
例如：
netbackup/logs/user_ops/proglog以下是 Windows 系统中的示例：
NetBackup\logs\user_ops\proglog默认情况下，不使用进度日志。
使用 -en 选项可生成英文进度日志。日志名称中包含字符串 _en。在分布式环境中，不同的语言环境可能创建不同语言的日志，此时该选项对于支持人员很有用。
仅允许对此选项使用默认路径，Veritas 建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。
有关如何添加自定义路径的更多信息，请参见 NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。
- -p policy
命名用于用户存档的策略。如未指定该选项，NetBackup 服务器将使用它找到的第一个包含该客户端和用户存档日程表的策略。
- -S master_server
在 UNIX 系统上，此选项指定 NetBackup 主服务器的名称。默认值是 /usr/openv/netbackup/bp.conf 文件中的第一个
SERVER条目。在 Windows 系统中，此选项指定 NetBackup 主服务器的名称。默认为在“指定 NetBackup 计算机”对话框的“服务器”选项卡上被指定为当前服务器的服务器。若要显示此对话框，请在客户端上启动“备份、存档和还原”用户界面。然后在“文件”菜单上单击“指定 NetBackup 计算机”。
- -s schedule
命名用于用户存档的日程表。如未指定该选项，NetBackup 服务器将使用它在当前所用策略中找到的第一个用户存档日程表（请参见 -p 选项。）
- -t policy_type
指定与策略类型相对应的以下编号之一。Windows 客户端的默认编号为 13。所有其他策略类型的默认编号为 0：
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
13 = MS-Windows
15 = MS-SQL-Server
16 = MS-Exchange-Server
19 = NDMP
下面的策略类型仅适用于 NetBackup Enterprise Server：
11 = DataTools-SQL-BackTrack
17 = SAP
18 = DB2
20 = FlashBackup
21 = Split-Mirror
39 = Enterprise-Vault
- -utf8
此选项向 NetBackup 告知提供的文件列表的格式为 UTF-8。使用此选项时，NetBackup 不会尝试转换路径名称。对于非 Windows 平台或其他策略类型，该选项没有影响。
对于某些策略类型，Windows 上的 NetBackup 假定输入文件列表的格式设置为活动代码页 (ACP)。它将指定的每个路径从 ACP 转换为 UTF-8。对于以下策略类型，该选项适用于从 Windows 上的命令行启动的任何备份：
DB2 MS-Exchange-Server Lotus-Notes Oracle SAP MS-SQL-Server Sybase MS-Windows
- -w [hh:mm:ss]
使 NetBackup 在返回到系统提示符状态之前等待来自服务器的完成状态。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”主题。
可以选择用小时、分钟和秒的形式来指定等待时间。可以指定的最长等待时间是 23:59:59。如果等待时间在存档完成前过期，则该命令以超时状态退出。但是，仍会在服务器上完成存档操作。
如果使用 -w 但未指定等待时间，或者指定的值为 0，NetBackup 将无限期地等待完成状态。
示例
示例 1 - 存档单个文件：
UNIX 系统：bparchive /usr/user1/file1
Windows 系统：bparchive c:\usr\user1\file1
示例 2 - 存档名为 archive_list 的文件中列出的文件：
bparchive -f archive_list
示例 3 - 将关键字短语 Archive My Home Directory 02/02/10 关联到名为 kwc 的目录的存档，并使用名为 arch.log 的进度日志：
UNIX 系统：bparchive -k "Archive My Home Directory 02/02/10" \-L/usr/openv/netbackup/logs/user_ops/arch.log /home/kwc
Windows 系统：bparchive -k "Archive My Home Directory 02/02/10" \-L c:\Program Files\Veritas\NetBackup\logs\user_ops\arch.log c:\home\kwc