Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpexpdate — 更改映像目录库中备份的截止日期以及介质目录库中介质的截止日期
大纲
-m media_id -d date | 0 | infinity [-host name] [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]
-deassignempty [-m media_id] [-force] [-M master_server,...]
-Bidfile filename | -backupid backup_id -d date | 0 | infinity [-client name] [-copy number] [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-do_not_follow_dependee] [-M master_server,...] [-extend_worm_locks]
-servername servername -d date | 0 | infinity [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...] [-extend_worm_locks]
-recalculate [-backupid backupid] [-copy number] [-d date | 0 | infinity] [-client name] [-policy name] [-ret retention_level] [-sched type] [-M master_server,...] [-extend_worm_locks]
-stype server_type [-dp disk_pool_name [-dv disk_volume]] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
NetBackup 可维护目录库这一包含备份映像及介质信息的内部数据库。映像目录库中的映像记录以及介质目录库中的介质 ID 都包含截止日期。截止日期是指 NetBackup 从相应目录库中删除备份或介质 ID 记录的日期和时间。
bpexpdate 命令用于更改 NetBackup 映像目录库中备份的截止日期和时间。该命令还用于更改 NetBackup 介质目录库中可移动介质的截止日期。如果将该日期设置为零,bpexpdate 会立即使映像目录库中的备份或介质目录库中的介质失效。当从 NetBackup 介质目录库中删除介质 ID 时,无论此介质以前的状态如何(已冻结、已暂停等)。都会同时将其从企业介质管理器数据库中删除。
可以对一个介质 ID 或单个备份 ID 更改截止日期。在更改介质 ID 的截止日期时,此介质上所有备份的截止日期也会更改。bpexpdate 还提供下列选项:
将不再包含有效备份的介质从介质目录库中删除。
根据所配置或提供的保留级别重新计算截止日期。
某些 NetBackup 副本可能具有一写多读 (WORM) 属性。NetBackup 会尝试设置副本的 WORM 解锁时间,以与其 NetBackup 目录库的截止时间相匹配。延长 WORM 副本的截止时间时,NetBackup 会运行存储命令以增加 WORM 解锁时间。仅当使用 -extend_worm_locks 选项调用 bpexpdate 时,才允许延长此存储解锁时间。无法缩短 WORM 副本的截止时间。可以使用 -d 0 选项立即删除 WORM 副本。
设置 WORM 后,副本将永远无法再次写入。但是,在解锁时间过去之后,这些副本将变得可删除。
任何得到授权的用户均可运行此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
操作
命令操作如下所示:
- -backupid backup_id
更改单个备份的截止日期。如果日期为零,则从映像目录库中删除备份。当备份位于可移动介质上时,如果 -d 截止日期超过了介质 ID 的当前截止日期,介质目录库的截止日期也将发生更改。除非使用 -copy 选项,否则这种更改将影响备份的所有副本。使用 -copy 选项将仅影响指定的副本。
- -Bidfile filename
指定一个文件,该文件包含要更改其截止日期的备份 ID 列表。在该文件中,每行列出一个备份 ID。
- -deassignempty
在目录库中搜索不再包含有效备份的可移动介质。然后将其从介质目录库中删除,并从介质管理器目录库中删除该介质 ID。然后,该介质将再次可供使用。可以使用 NetBackup 的“介质上的映像”报告来确定已分配的介质是否不再包含有效备份。
- -recalculate
可以根据保留级别来更改备份的截止日期,也可以指定新的截止日期。可以更改单个备份的截止日期,或者更改特定客户端、策略或日程表类型的所有备份的截止日期。-bybackuptime、-d 或 -ret 选项之一可以与此选项一起使用。
使用 -bybackuptime 选项时,备份的截止日期设置为创建日期与最初用于备份的保留级别值之和。导入备份后,此选项可用于将其截止日期重置为原始值。
注意:
保留级别 25 的值为立即失效。不能编辑此值。如果将备份映像的保留级别设置为 25,则备份映像会立即失效。
使用 -ret 选项时,备份的截止日期设置为创建日期与指定的保留级别值之和。
如果 -bybackuptime、-d 或 -ret 不与此选项一起使用,则任何非存储生命周期策略 (SLP) 备份的截止日期均设置为创建日期与写入备份的日程表(如果该日程表已存在且其保留级别自备份创建以来已更改)的当前保留级别之和。在以下显示的任何情况下,不会重新计算备份的截止日期:
备份由 SLP 创建。
如果写入备份的策略和日程表不再存在。
如果写入备份的日程表的保留级别自备份创建以来未发生更改。
当备份位于可移动介质上时,如果备份的新截止日期晚于当前介质截止日期,则介质的截止日期也会发生更改。
- -servername server_name
指定截止日期发生改变时受到影响的服务器的名称。服务器名称指的是片段所在的映像片段记录的字段。该服务器是执行数据移动的介质服务器。对于快照,该服务器是快照所在的客户端。
- -stype server_type
指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一:
Veritas 提供的存储。可能的值有 AdvancedDisk 和 PureDisk。
第三方磁盘设备。供应商提供了 server_type 字符串。
云存储。云 stype 值反映了云存储提供程序。通过 csconfig 命令确定可能的值,如此处所示。粗体信息(加粗以进行强调)是指 -stype 选项必需的信息。请注意,可以基于当前支持的提供程序更改 csconfig 命令的输出。
root:~# csconfig cldprovider -l amazon (Amazon - Simple Storage Service) amazongov (Amazon GovCloud - Simple Storage Service) azure (Microsoft Azure - Microsoft Azure Storage Service) cloudian (Cloudian HyperStore - Cloudian HyperStore Object Storage) google (Google Nearline - Google Cloud Storage Nearline) hitachi (Hitachi Cloud Service (HCS) - Hitachi Off Premise Public Cloud) hitachicp (Hitachi Content Platform (HCP) - Hitachi On Premise Private Cloud) swiftstack (SwiftStack - SwiftStack Object Storage) verizon (Verizon - Verizon Cloud Storage)
云存储 stype 值必须包含一个后缀(例如
amazon_crypt
)。可能的后缀是:_raw:将具有原始格式的 NetBackup 备份映像发送至云。如果您在将数据发送至云存储前不需要压缩或加密数据,则使用此选项。
_rawc:在将原始数据写入云存储之前压缩此数据。
_crypt
:在将数据写入云存储之前使用 AES-256 加密对此数据进行加密。要使用此选项,必须在 NetBackup 中配置 KMS。_cryptc:将数据写入云存储之前压缩和加密数据。
存储服务器类型区分大小写。
选项
- -bybackuptime
指定截止日期设置为备份创建日期与用于备份的保留级别值之和。
- -client name
指定 -backupid 和 -recalculate 操作中使用的客户端名称。
对于 backupid 操作,该选项可使 NetBackup 首先搜索指定客户端的备份 ID。在已更改客户端名称的情况下,此选项非常有用。
对于 recalculate,该选项会使 NetBackup 基于所指定的全部客户端备份的保留级别重新计算截止日期。
- -copy number
使指定的副本号失效或更改其截止日期。该选项仅与 -backupid 和 -recalculate 选项一起使用时才有效。有效值介于 1 到 10 之间。
如果主副本失效,则另一个副本会变成主副本。如果未指定该选项,则截止日期同时影响备份的这两个副本。
- -d date
指定截止日期和时间。date 可以是下面的任一值:
mm/dd/yy hh:mm:ss
0 - 备份或介质立即失效
infinity - 备份将永不失效
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf
文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF
文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息,请参见《NetBackup 管理指南,第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。
- -deassignempty
在目录库中搜索不再包含有效备份的可移动介质。这会将介质从介质目录库中删除。然后,该介质将再次可供使用。可以使用 NetBackup 的“介质上的映像”报告来确定已分配的介质是否不再包含有效备份。
- -do_not_follow_dependee
默认情况下,当相关映像失效后,符合条件的被依赖者映像也将失效。-do_not_follow_dependee 选项将重写此行为,以便映像失效不会影响被依赖者映像。
- -dp disk_pool_name -dv disk_volume
为要执行的截止日期操作指定磁盘池,也可以选择性指定磁盘卷。
- -extend_worm_locks
使用 -extend_worm_locks 选项可延长 WORM 副本的截止日期。WORM 副本截止时间永远不能缩短。默认情况下,WORM 副本的截止时间不能延长。必须提供此选项才能延长 WORM 副本的截止时间。如果未指定 WORM 副本,则此选项将不起作用。
- -force
在运行指定的操作前,bpexpdate 会先询问用户,然后再启动操作。该选项可强制 bpexpdate 命令不询问用户即执行操作。
- -force_not_complete
默认情况下,如果 SLP 处理仍在进行中,无法使 SLP 管理的映像或其副本失效。-force_not_complete 选项仍将覆盖此限制并使映像失效,即使它不是 SLP 完整映像也会如此。请注意,当您终止对该映像执行进一步 SLP 处理时,其他映像副本也会失效。
- -host name
注意:
对于 NetBackup 服务器,由于仅有一台服务器(主服务器),因此不需要使用此选项。如果您确实要使用此选项,请指定该服务器的主机名。
指定将介质分配到的服务器的主机名。此选项只能与 -m media_id 选项一起使用,且只有在满足下列条件时才能使用:主服务器具有远程介质服务器且未在运行 bpexpdate 的服务器上写入卷。
例如,假设主服务器名为 whale,介质服务器名为 eel。在 whale 上运行下面的命令,即可手动从介质目录库中删除介质 ID BU0001,并从映像目录库中删除所有相应的备份:
bpexpdate -m BU0001 -d 0 -host eel
可以使用 NetBackup 的“介质列表”报告来确定哪个服务器的介质目录库包含该卷。
- -m media_id
检查此特定介质 ID 上是否存在有效的备份。此选项只能与 -deassignempty 选项结合使用。介质 ID 必须是 6 个或更少的字符,且必须位于 NetBackup 介质目录库中。
- -M master_server [,...]
指定用于管理具有该介质 ID 的介质目录库的主服务器。如果未指定该选项,则默认值为以下服务器之一:
对于 NetBackup 服务器:
NetBackup 服务器仅支持一台没有远程介质服务器的服务器(主服务器)。因此,在这种情况下,默认值始终为运行该命令的主服务器。
对于 NetBackup Enterprise Server:
如果在主服务器上运行该命令,则该服务器为默认服务器。如果在不是主服务器的介质服务器上运行该命令,则该介质服务器的主服务器为默认服务器。
- -nodelete
将备份从映像目录库中删除,但并不将其从磁盘存储器中删除。当您取消从一台主服务器导入某个磁盘组并将该磁盘组导入到另一台主服务器上时,可以使用此选项。
- -notimmediate
在 bpexpdate 使磁盘上的映像失效后,禁止该命令调用 nbdelete 命令。如果您打算同时删除多个映像,可使用 -notimmediate,以避免因处理 nbdelete 而创建多个作业所致的开销。可以以后运行 nbdelete 命令。
- -policy name
指定策略名。该选项与 -recalculate 选项一起使用时才有效。如果指定了策略名,将根据在该策略中创建的所有备份的保留级别重新计算截止日期。
- -recalculate
可以根据指定的保留级别来更改备份的截止日期,也可以指定新的截止日期。必须将此选项与 -d 或 -ret 选项一起指定。根据保留级别更改截止日期时,新日期将基于备份的创建日期与保留级别值的和。可以更改单个备份的截止日期,或者更改特定客户端、策略或日程表类型的所有备份的截止日期。
当备份位于可移动介质上时,如果该命令中的截止日期超过了当前的截止日期,则介质目录库中的截止日期会发生更改。
- -ret retention_level
指定重新计算截止日期时将使用的保留级别。该选项与 -recalculate 选项一起使用时才有效。级别的范围为 0 到 100。新的截止日期为备份的创建日期与此保留级别之和。您必须将该选项与 -backupid 或 -policy 一起指定。
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令,则只能指定介于 0 到 24 之间的保留级别。
- -sched type
指定日程表类型。该选项与 -recalculate 选项一起使用时才有效。如果指定了类型,将根据针对该日程表类型创建的所有备份的保留级别重新计算截止日期。可输入如下所示的类型数值:
0 = 完全备份
1 = 差异增量式备份
2 = 用户备份
3 = 用户存档
4 = 累积增量式备份
必须将 -policy 选项与 -sched 一起指定。
说明
在大型环境中,有些选项所执行的操作可能需要相当长的时间才能完成。使备份或介质失效的更改操作是不能取消的。如果使用该命令时出错,可能需要导入备份或恢复目录库的以前版本。
示例
示例 1 - 下面的命令在主服务器上运行,它从介质目录库中删除介质 ID BU0002。并在介质管理器目录库中取消对该介质 ID 的分配。它还使映像目录库中的关联映像记录失效。
# bpexpdate -m BU0002 -d 0
示例 2 - 更改备份 backupid
eel_0904219764 的副本 2 的截止日期。该备份的副本 1 的截止日期不受影响。
# bpexpdate -backupid eel_0904219764 -d 12/20/2012 08:00:00 -copy 2
示例 3 - 从映像目录库中删除备份。由于未指定 -copy 选项,因此将删除所有副本。
# bpexpdate -backupid eel_0904219764 -d 0
示例 4 - 在主机 cat
的介质目录库中查找仍处于已分配状态但不再包含有效备份的介质。此命令将从目录库中删除任何此类介质,并在介质管理器目录库中取消分配该类介质。
# bpexpdate -deassignempty -host cat
示例 5 - 将备份 ID 1234 的截止日期重新计算为 2012 年 10 月 31 日。
# bpexpdate -recalculate -backupid 1234 -d 10/31/12
示例 6 - 根据保留级别重新计算备份 ID 1234 的截止日期。新的保留级别为 4,即两个月(默认值)。现在,备份 ID 1234 预定在 2 个月后失效。
# bpexpdate -recalculate -backupid 1234 -ret 4
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/media/* /usr/openv/netbackup/db/images/*
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\media\* nstall_path\NetBackup\db\images\*