Search <book_title>...

Veritas NetBackup™ 管理指南，第 II 卷

Last Published: 2021-07-28

Product(s): NetBackup (9.1)

bpstart_notify.bat 脚本（Windows 客户端）

对于所有 Windows 客户端，可创建在每次客户端启动备份或存档时都提供通知的批处理脚本。

要使用该脚本，请从服务器复制以下文件：

在 Windows 上：

Install_path\NetBackup\bin\goodies\bpstart_notify.bat

然后将文件放在客户端上 NetBackup 客户端二进制文件所在的相同目录中：

Install_path\NetBackup\bin\

其中，Install_path 是 NetBackup 的安装目录。

可创建为所有备份或只为特定策略或日程表的备份提供通知的 bpstart_notify 脚本。

要创建适用于所有备份的脚本，请将脚本命名为 bpstart_notify.bat。

要创建只适用于特定策略或策略与日程表组合的 bpstart_notify 脚本，请将 .policyname 或 .policyname.schedulename 后缀添加到脚本名称中。

以下是 bpstart_notify 脚本名称的示例：

以下脚本仅适用于名为 days 的策略：

install_path\netbackup\bin\bpstart_notify.days.bat

以下脚本只适用于策略 days 中名为 fulls 的日程表：
```
install_path\netbackup\bin\bpstart_notify.days.fulls.bat
```
如果未指定 .policyname[.schedule]，则也会为 NetBackup 目录库备份运行 bpstart_notify 脚本。

第一个脚本影响策略 days 中的所有预定备份。第二个脚本仅当日程表名为 fulls 时才影响策略 days 中的预定备份。

对于给定的备份，NetBackup 将只调用一个 bpstart_notify 脚本，并按以下顺序检查这些脚本：

bpstart_notify.policy.schedule.bat
bpstart_notify.policy.bat
bpstart_notify.bat

例如，如果有 bpstart_notify.policy.bat 和 bpstart_notify.policy.schedule.bat 两个脚本，则 NetBackup 只使用 bpstart_notify.policy.schedule.bat 脚本。

注意:

bpend_notify 脚本可以提供与 bpstart_notify 脚本不同的通知级别。例如，要为每个脚本使用一种级别，脚本名称可以是 bpstart_notify.policy.bat 和 bpend_notify.policy.schedule.bat.。

NetBackup 将下列参数传递给脚本：

%1	指定 NetBackup 目录库中的客户端名称。
%2	指定 NetBackup 目录库中的策略名称。
%3	指定 NetBackup 目录库中的日程表名称。
%4	指定下列其中一个值：FULL, INCR, CINC, UBAK, UARC
%5	指定对于 bpstart_notify，操作的状态始终为 0。
%6	指定 NetBackup 用来在脚本中搜索返回代码的结果文件。NetBackup 使用 %6 传递文件名，然后期望脚本在自身所在的目录中创建该文件。如果脚本应用于特定策略和日程表，则必须将结果文件命名为 install_path\netbackup\bin\BPSTART_RES.policy.schedule 如果脚本应用于特定策略，则必须将结果文件命名为 install_path\netbackup\bin\BPSTART_RES.policy 如果脚本应用于所有备份，则必须将结果文件命名为 install_path\netbackup\bin\BPSTART_RES 此脚本创建文件的一种方法是使用 echo 0> %6 语句。在调用脚本之前，NetBackup 将删除现有结果文件。脚本运行后，NetBackup 将检查新结果文件中的状态。仅当状态为 0 时，脚本才被视为成功。如果结果文件不存在，则 NetBackup 假设脚本已成功。

服务器期待客户端在由服务器上的 BPSTART_TIMEOUT 选项指定的时间内以 continue 消息响应。BPSTART_TIMEOUT 的默认值为 300 秒。如果脚本需要的时间超过 300 秒，则可增大该值以允许更多的时间（BPSTART_TIMEOUT 选项对应于“超时时间”主机属性上的“备份开始通知超时”）。

注意:

“客户端读取超时”（CLIENT_READ_TIMEOUT 选项）必须等于或大于“备份开始通知超时”（BPSTART_TIMEOUT 选项）。如果“客户端读取超时”小于“备份开始通知超时”，则作业可能会在 bpstart_notify 脚本运行时超时。