bpexpdate – （过期、延期）更改映像目录库中备份的截止日期以及介质目录库中介质的截止日期nbu

1、根据bpdbjobs查找backupid
bpdbjobs -jobid xxx -all_columns|grep backupid

2、查看数据保留时间
[root@backup]# bpimagelist -backupid fileserver_1542965400 -U
Backed Up Expires Files KB C Sched Type On Hold Index Status Policy
---------------- ---------- -------- -------- - ------------ ------- ------------ ------------
11/23/2018 17:30 12/24/2018 1019378 497294486 N Full Backup 0 0 fileserver

3、修改数据过期时间
[root@backup]# bpexpdate -backupid fileserver_1542965400 -d 01/24/2020
Are you SURE you want to change fileserver_1542965400
to expire on Thu 24 Jan 2020 12:00:00 AM CS y/n (n)? y

4、查看修改后的数据有效期
[root@backup]# bpimagelist -backupid fileserver_1542965400 -U
Backed Up Expires Files KB C Sched Type On Hold Index Status Policy
---------------- ---------- -------- -------- - ------------ ------- ------------ ------------
11/23/2018 17:30 01/24/2020 1019378 497294486 N Full Backup 0 0 fileserver

5、bpexpdate
– 更改映像目录库中备份的截止日期以及介质目录库中介质的截止日期

大纲

bpexpdate -m media_id -d date | 0 | infinity [-host name] [-force]
[-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]
bpexpdate -deassignempty [-m media_id] [-force] [-M master_server,...]
bpexpdate -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,...]
bpexpdate -servername servername -d date | 0 | infinity [-force]
[-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]
bpexpdate -recalculate [] [-copy number] [-d date | 0 | infinity]
[-client name] [-policy name] [-ret retention_level] [-sched type]
[-M master_server,...]
bpexpdate -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 授权的详细信息，请参见《NetBackup 安全和加密指南》。

操作

命令操作如下所示：
-backupid backup_id
更改单个备份的截止日期。如果日期为零，则从映像目录库中删除备份。当备
份位于可移动介质上时，如果 -d 截止日期超过了介质 ID 的当前截止日期，介
质目录库的截止日期也将发生更改。除非使用 -copy 选项，否则这种更改将影
响备份的所有副本。使用 -copy 选项将仅影响指定的副本。
-Bidfile filename
指定一个文件，该文件包含要更改其截止日期的备份 ID 的列表。在该文件中，
每行列出一个备份 ID。
-deassignempty
在目录库中搜索不再包含有效备份的可移动介质。然后将其从介质目录库中删
除，并从介质管理器目录库中删除该介质 ID。然后，该介质将再次可供使用。
可以使用 NetBackup 的“介质上的映像”报告来确定已分配的介质是否不再包
含有效备份。
-recalculate
可以根据指定的保留级别来更改备份的截止日期，也可以指定新的截止日期。
必须将此选项与 -d 或 -ret 选项一起指定。 根据保留级别更改截止日期时，
新日期将基于备份的创建日期与保留级别值的和。可以更改单个备份的截止日
期，或者更改特定客户端、策略或日程表类型的所有备份的截止日期。
当备份位于可移动介质上时，如果该命令中的截止日期超过了当前的截止日
期，则介质目录库中的截止日期会发生更改。
-servername server_name
指定截止日期发生改变时受到影响的服务器的名称。服务器名称指的是片段所
在的映像片段记录的字段。该服务器是执行数据移动的介质服务器。对于快
照，该服务器是快照所在的客户端。
-stype server_type
指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一：
■ Symantec 提供的存储。可能的值有 AdvancedDisk 和 PureDisk。
■ 第三方磁盘设备。供应商提供了 server_type 字符串。
■ 云存储。可能的值包括 amazon、att 和 rackspace。这些值也可以包含
_crypt 后缀（例如，amazon_crypt）。
存储服务器类型区分大小写。

选项

-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
为要执行的截止日期操作指定磁盘池，也可以选择性指定磁盘卷。
-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 到 24。新的截止日期为备份的创建日期与此保
留级别之和。您必须将该选项与 -backupid 或 -policy 一起指定。
-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/10
示例 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/*
139 NetBackup 命令
bpexpdate
Windows 系统：
install_path\NetBackup\logs\admin\*
install_path\NetBackup\db\media\*
nstall_path\NetBackup\db\images\*