Bpexpdate命令详解

dooza

Bpexpdate命令详解
名称：
Bpexpdate：更改image catalog中的备份和media catalog中的介质的过期日期。

语法：
install_path\NetBackup\bin\admincmd\bpexpdate -m media_id -d date [-host name] [-force] [-M master_server[,...,]]

install_path\NetBackup\bin\admincmd\bpexpdate -deassignempty [-m media_id] [-host name] [-force] [-M master_server[,...,]]

install_path\NetBackup\bin\admincmd\bpexpdate -backupid backup_id -d date |0|infinity [-client name] [-copy number] [-force] [-M master_server[,...,]]

install_path\NetBackup\bin\admincmd\bpexpdate -recalculate [-backupid backup_id] [-copy number] -d date |0|infinity] [-client name] [-policy name] [-ret retention_level] [-sched type] [-M master_server[,...,]]

描述：
NetBackup维护备份映像和介质信息的内部数据库，这些内部数据库叫做catalogs。Image catalog里的映像记录和Media catalog里的介质ID都包含一个过期日期。过期日期是NetBackup从相应的catalog里删除备份记录和介质ID记录的日期和时间。
Bpexpdate命令允许在NetBackup Image catalog里更改备份的过期日期和时间。它也用于更改NetBackup Media catalog里的可移动介质的过期日期。如果date设置为0，那么Bpexpdate立即过期备份或介质。当一个介质ID从NetBackup Media catalog被删除时，它也在Media Manager volume database里被取消分配，而忽略介质的优先状态（冻结，挂起等等）。
更改过期日期可以基于介质ID或基于独立的备份ID，更改介质ID的过期日期，也更改了该介质上全部备份的过期日期。Bpexpdate也提供选项，在介质不再包含有效的备份时，取消对它的分配，并根据配置的或提供的保留周期重新计算过期日期。
不同的命令格式描述如下：
● -m  
更改介质的过期日期或删除介质ID及其关联的备份。备份的每个拷贝在image catalog里都有一个独立的过期日期。当使用此格式时，只影响此介质上的拷贝的过期日期。如果通过指定date为0，将介质ID从media catalog里删除，那么介质ID也在Media Manager volume database里被取消分配。
● -deassignempty
从media catalog搜索不再包含有效备份的可移动介质，并删除，取消对它的分配。然后介质可以重新被使用。你可以使用NetBackup的Images on Media报告来确定是否存在不再包含有效备份的已分配介质。
● -backupid
更改单个备份的过期日期。如果date为0，那么备份从image catalog删除。如果备份在可移动介质上，而且用-d选项指定了的过期日期大于当前介质ID的过期日期，那么media catalog里的介质ID的过期日期也被更改。这个更改影响备份的所有拷贝，除非使用了-copy选项。-copy选项只影响指定的拷贝。
● -recalculate
允许通过指定的保留周期或新的过期日期来更改备份的过期日期。当根据保留周期来更改过期日期时，根据备份创建日期加上保留周期来计算新的过期日期，可以更改单个备份的过期日期，也可以更改特定客户端，特定策略，或特定计划类型的全部备份的过期日期。
如果备份在可移动介质上，media catalog里的介质ID的过期日期被更改，在此命令上提供比当前的介质ID的过期日期长的日期。

选项：
-client name
为-backupid和-recalculate操作指定客户端名称。
对于backupid操作，这个选项使得NetBackup首先搜索指定的客户端的备份ID，这在客户端名称发生更改时非常有用。
对于recalculate操作，这个选项使得NetBackup根据保留周期来重新计算指定的客户端的全部备份的过期日期。

-copy number
过期或更改指定的拷贝号的过期日期，只在-backupid和-recalculate操作中有效。有效的数值为1-10。
如果主（primary）拷贝过期，那么其它拷贝成为主拷贝，如果没有指定此选项，那么影响所有的备份拷贝。

-d date
指定过期日期和时间。可以是以下任何形式之一：
mm/dd/yyhh:mm:ss
0
infinity
如果指定了0，那么备份或介质立即过期。如果指定了infinity，那么备份永不过期。

-force
此选项强制执行bpexpdate，而不询问用户。

-host name
注意：对于NetBackup Server，不需要指定此选项，因为只有一个服务器（master server）。因此，如果你使用此选项，那么指定该服务器的名称。
指定media catalog所在的服务器的主机名。此选择只在有远程media servers，并且卷没有在你运行bpexpdate命令的主机上时才需要。在这种情况下，介质ID位于介质被写的服务器的media catalog里。你必须在bpexpdate命令中指定此服务器名。
例如：假设你有一个名为whale的master server和一个名为eel的media server。你在whale上运行下面的命令，以手动删除media catalog里的介质ID BU0001及image catalog里相应的全部备份：
bpexpdate -m BU0001 -d 0 -host eel


-m media_id
指定要更改过期日期的介质ID，也会更改介质上的全部备份的过期日期。-d选项必须包含在此选项中。
此选项也被用于指定了-deassignempty选项的操作中，在这种情况下，不要使用-d选项。
介质ID必须为6个或更少的字符，并且在NetBackup media catalog里。

-M master_server,...,master_server
指定管理包含指定的介质ID的media catalog的master server。如果没有指定此选项，默认如下：
对于NetBackup Server：
就是运行此命令的master server的主机名。
对于NetBackup Enterprise Server：
如果此命令在一个master server上运行，那么就是此主机名。如果此命令在media server上运行，那么默认就是此media server所属的master server主机名。

-policy name
指定策略名，跟-recalculate选项一起时有效。当指定此选项时，根据此策略所创建的备份的保留周期来重新计算过期日期。

-recalculate
必须为此选项指定-d或-ret选项。

-ret retention_level
为重新计算过期日期指定保留周期，必须跟-recalculate一起使用。保留级别范围为0-24，新的过期日期为配置的保留周期加上备份的创建日期。必须为此选项指定-backupid或-policy选项。

-sched type
指定计划类型（schedule type），跟-recalculate选项一起时有效。当指定此选项时，根据用此计划类型创建的全部备份的保留周期来重新计算过期日期。输入如下数值：
0 = Full
1 = Differential Incremental
2 = User Backup
3 = User Archive
4 = Cumulative Incremental
此选项必须跟-policy选项一起指定。

注意：
你在NetBackup命令里使用的日期和时间格式根据本地环境（Locale）的不同而变化。下面是Locale设置为C时的-d选项：
-d <mm/dd/yyyy HH:MM:SS | 0 | infinity>;

举例：
例1
下面的命令运行在master server上，从media catalog删除介质ID BU0002，它也删除相关的映像记录：
bpexpdate -m BU0002 -d 0

例2
下面的命令更改备份ID为eel_0904219764的拷贝2的过期日期，拷贝1不受影响：
bpexpdate -backupid eel_0904219764 -d 12/20/2003 08:00:00 -copy 2

例3
下面的命令从image catalog删除备份，因为没有指定-copy，所以全部的拷贝被删除：
bpexpdate -backupid eel_0904219764 -d 0

例4
下面的命令检查主机cat的media catalog里不再包含有效备份但还被分配的全部介质。如果发现了这样的介质，此命令从media catalog里删除它们，并在Media Manager catalog里取消对它们的分配：
bpexpdate -deassignempty -host cat