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
- 索引
名称
bpbackup — 将文件备份到 NetBackup 服务器
大纲
-f listfile | filenames [-p policy] [-s schedule] [-S master_server...] [-t policy_type] [-L progress_log [-en]] [-w [hh:mm:ss]] [-k "keyword_phrase"] [-utf8]
-i [-p policy] [-h hostname {[-instance instance_name [-database database_name]]] | [-database_unique_name name -database_id id]} [-s schedule] [-S master_server...] [-t policy_type] [-L progress_log [-en]] [-w [hh:mm:ss]] [-k "keyword_phrase"] [-utf8]
-dssu DSSUname [-S master_server]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\
描述
bpbackup 命令可以启动客户端和主服务器上的备份进程。使用 Oracle 策略时，bpbackup 允许您备份实例或 RAC 数据库。使用 SQL Server 策略时，bpbackup 允许您备份实例或实例中的数据库。
在客户端上：
bpbackup 的 -f 选项可启动一个用户备份，它等效于使用客户端上的界面所执行的操作。可从任何 NetBackup 客户端启动这种备份类型来备份该客户端中的文件。
bpbackup 可以处理在命令行中列出的文件，也可以处理在使用 -f listfile 选项指定的文件中所列出的文件。文件路径可以是文件名或目录名。如果指定的文件中包含目录，则 bpbackup 从该目录本身开始备份其中的所有文件和子目录。
注意:
除了列出单个文件或目录外，bpbackup 还可以使用指令来说明要备份的文件。例如：bpbackup "/Shadow Copy Components/" 或 bpbackup "/System State/"。客户端可以使用 bpbackup -f listfile 选项在 listfile 中输入指令。
在主服务器上：
bpbackup 的 -i 选项可启动对客户端的即时手动备份。只有主服务器的管理员才能使用 bpbackup 选项。这等效于从 NetBackup 管理控制台启动手动备份。使用 -h 选项可指定主机。
由于仅在客户端上写入进度日志，而且只能从主服务器运行该形式的 bpbackup 命令，因此未定义 -L 选项。
以下限制适用于本命令：
要使用 bpbackup 备份文件，您必须是文件的所有者或管理员。
如果您具有必需的权限，则可以备份其他用户所拥有的文件和目录。
在 UNIX 系统上：如果指定的文件是一个链接，bpbackup 将仅备份该链接本身，而不备份它链接到的文件。
bpbackup 不备份 . 或 .. 目录条目。
默认情况下，成功提交 bpbackup 后，将返回到系统提示符状态。该命令在后台工作，它并不直接返回完成状态。可通过使用 -w 选项来更改此行为，使该命令在前台工作。它会在指定的时间段后返回完成状态。
如果在运行 bpbackup 命令前创建了文件，然后用 -L progress_log 选项指定该文件，则会发生下列情况：bpbackup 将指示性信息和错误消息写入 progress-log 文件。如果 bpbackup 无法备份所请求的文件或目录，请使用该进度日志确定故障原因。
注意:
NDMP 客户端不支持 - L 选项。
如果您创建了具有公用写权限的以下目录，则 bpbackup 将在该目录下创建可用于故障排除的调试日志文件：
在 Windows 系统上：install_path\NetBackup\logs\bpbackup\
在 UNIX 系统上：usr/openv/netbackup/logs/bpbackup/
如果用户指定了以下信息，则当备份进程完成时，NetBackup 将向 mail_address 发送关于备份完成状态的邮件：
非 root 用户在
$HOME/bp.conf文件中指定 USEMAIL = mail_addressroot 用户在
/usr/openv/netbackup/bp.conf文件中指定 USEMAIL = mail_address
选项
- -database_id
策略中指定的 Oracle RAC 数据库的数据库 ID。
- -database_unique_name
策略中指定的 Oracle RAC 数据库的唯一名称。
- -dssu DSSUname
NetBackup 立即运行与磁盘分段作业存储单元关联的日程表。由于此行为已经包含 -i 选项的操作，因而不需要该选项。
- -f listfile
指定一个文件 (listfile)，其中包含要备份的文件的列表。该选项可用于代替 filenames 选项，但不能与 -i 选项一起使用。每个文件将单独列在一行内。
文件列表所要求的格式取决于文件名称中是否包含空格、换行符或回车。
要备份名称中不含空格、换行符或回车的文件，请使用以下格式：
filepath
其中，filepath 是要备份的文件的路径。
以下是 UNIX 系统上的一些示例：
/home、/etc和/var。以下是 Windows 系统上的一些示例：
c:\Programs、c:\winnt和c:\documents\old_memos要备份名称中包含空格、换行符或回车的文件，请使用以下格式：
filepathlen filepath
其中，filepath 是要备份的文件的路径，而 filepathlen 是文件路径中的字符数。
以下是 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 选项，但不能与 -i 选项一起使用。必须将指定的所有文件列在结尾处，位于所有其他选项之后。
- -h hostname
命名要运行备份的客户端主机。如果未指定该选项，NetBackup 将在策略中的所有客户端上运行备份。
- -i
启动即时手动备份。该操作等效于从 NetBackup 管理员界面启动手动备份。您必须是主服务器的管理员才能使用 -i 选项。
- -instance instance_name [-database database_name]
指定要备份的 Oracle 或 SQL Server 实例的名称。策略类型 (-t) 必须设置为 4 (Oracle) 或 15 (SQL Server)。必须将此选项与 -h 选项结合使用，而且您必须是主服务器的管理员。
[-database database_name] 指定要备份的实例中 SQL Server 数据库的名称。
- -k keyword_phrase
指定一个关键字短语，NetBackup 会将其与此备份操作所创建的映像相关联。此后，您可以在 bprestore 命令中使用 -k 选项指定该关键字短语来还原映像。
如果使用 -i 和 -k 选项，NetBackup 将在关键字短语与备份策略及映像间建立关联。
关键字短语是备份的文本描述，最长为 128 个字符。
在 UNIX 系统上，允许使用所有可打印字符，包括空格 ( ) 和句点 (.)。应将短语放在双引号 ("...") 或单引号 ('...') 内，以避免与 UNIX Shell 发生冲突。
在 Windows 系统上，允许使用所有可打印字符，包括空格 ( ) 和句点 (.)。用双引号 ("...") 或单引号 ('...') 将该短语括起来。
默认的关键字短语为空字符串。
- -L progress_log [-en]
指定要在其中写入进度信息的文件的名称。如果该文件不存在，NetBackup 会创建它。
在 Windows 系统上，例如：
NetBackup\logs\user_ops\proglog在 UNIX 系统上，例如：
netbackup/logs/user_ops/proglog默认情况下，不使用进度日志。
NDMP 客户端不支持 - L 选项。
使用 -en 选项可生成英文进度日志。日志名称中包含字符串 _en。在分布式环境中，不同的语言环境可能创建不同语言的日志，此时该选项对于支持人员很有用。
仅允许对此选项使用默认路径。Veritas 建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。
有关如何添加自定义路径的更多信息，请参见 NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。
- -p policy
命名用于备份的策略。
如果未指定此选项，NetBackup 将使用它找到的第一个包含该客户端和用户备份日程表的策略。
即时手动备份（-i 选项）要求使用此选项。
- -s schedule
命名用于备份的日程表。如果未指定该选项，NetBackup 服务器将使用它在当前所用策略中为该客户端找到的第一个用户备份日程表。
参见 -p 选项。
- -S master_server [,master_server,...]
在 UNIX 系统上，-S 指定 NetBackup 主服务器的名称。默认值是在 /usr/openv/netbackup/bp.conf 文件中找到的第一个
SERVER条目。在 Windows 系统上，-S 指定 NetBackup 主服务器的名称。默认为在“指定 NetBackup 计算机”对话框的“服务器”选项卡上被指定为当前服务器的服务器。若要显示此对话框，请在客户端上启动“备份、存档和还原”用户界面。然后在“文件”菜单上单击“指定 NetBackup 计算机”。
- -t policy_type
指定与策略类型相对应的以下编号之一。Windows 客户端的默认编号为 13，所有其他策略类型的默认编号为 0：
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
8 = MS-SharePoint
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
44 = BigData
- -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 在返回到系统提示符状态之前等待来自服务器的完成状态。
可以选择用小时、分钟和秒的形式来指定等待时间。可以指定的最长等待时间是 23:59:59。如果等待时间在备份完成前过期，则该命令以超时状态退出。但是，仍会在服务器上完成备份操作。
bpbackup -w 选项可使 Shell 等待返回代码。操作系统 Shell 只能返回一个返回代码。因此，如果使用 -w 但未指定等待时间，或者指定的值为 0，NetBackup 将无限期等待完成状态。
可以使用 bpbackup -i 以及 -w 函数来启动“手动”或“管理”备份。这种类型的备份基于策略属性，因此可以启动多个作业。即使手动备份启动多个作业，-w 函数仍然只为 Shell 返回一个返回代码。
如果使用 -i 及 -w 选项，并且多个作业已开始，NetBackup 会一直等到这些作业全部完成后再返回完成状态。但是，因为 NetBackup 仅向 Shell 返回一个状态码，所以并不清楚该状态码所属的作业 ID。
如果有多个作业对于多个客户端都到期了，并且未选择“允许多个数据流”，请使用 -h 将操作限制在一个客户端上。但如果在策略中选择了并且所选客户端有多个作业，则返回的状态码仍是未知的。
示例
示例 1 - 对单个文件执行用户备份。
在 UNIX 系统上：# bpbackup /usr/user1/file1
在 Windows 系统上：# bpbackup c:\users\user1\file1
示例 2 - 对名为 backup_list 的文件中列出的文件启动用户备份。
# bpbackup -f backup_list
示例 3 - 使用名为 cis_co 的策略对客户端主机 diablo 启动即时手动备份（全部位于一行）。该策略类型为 Standard，且位于名为 hoss 的主服务器的配置中。
对于 UNIX：# bpbackup -p cis_co -i -h diablo -S hoss -t 0
Windows：# bpbackup -p cis_co -i -h diablo -S hoss -t 0
示例 4 - 在 Windows 系统上： 将关键字短语 Backup My Home Directory 01/01/01 与目录 C:\home\kwc 的用户备份关联。（将命令并成一行输入。）
# bpbackup -k "Backup My Home Directory 01/01/01" -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log \ C:\home\kwc
在 UNIX 系统上： 以下命令将关键字短语 “Backup Home Dir 01/01/01” 与目录 /home/kwc 的用户备份关联。（将命令并成一行输入，或使用反斜杠续行符分成多行。）
# bpbackup -k "Backup Home Dir 01/01/01" -L /usr/openv/netbackup/logs/user_ops/bkup.log \ /home/kwc
示例 5 - 将关键字短语 Policy Win 01/01/01 与使用 win_nt_policy 策略对名为 slater 的客户端主机所做的即时手动备份关联。（将命令并成一行输入。）
UNIX：
# bpbackup -k "Policy Win 01/01/01" -i -h slater \ -p win_nt_policy -t 13
Windows：
# bpbackup -k "Policy Win 01/01/01" -i -h slater -p win_nt_policy -t 13
示例 6 - 通过使用 ora 策略，在客户端主机 hookvm2 上对 Oracle 实例 orac11g 执行手动备份。
# bpbackup -i -p ora -h hookvm2 -t 4 -instance orac11g
示例 7 - 通过使用 sql 策略，在客户端主机 winvm2 上对实例 HR 中的 SQL Server 数据库 HRDB1 执行手动备份。
# bpbackup -i -p sql -h winvm2 -t 15 -instance HR -database HRDB1
文件
UNIX 系统：$HOME/bp.conf
/usr/openv/netbackup/logs/bpbackup/log.mmddyy
Windows 系统：install_path\NetBackup\logs\bpbackup\*.log