Search <book_title>...

Veritas NetBackup™ 管理指南，第 II 卷

Last Published: 2017-11-15

Product(s): NetBackup (8.1)

bpstart_notify 脚本（UNIX 客户端）

在 UNIX 客户端上，NetBackup 在客户端每次启动备份或存档操作时调用 bpstart_notify 脚本。

注意:

使用该脚本之前，确保客户端上的其他用户可以运行该脚本。为此，请运行 chmod ugo+rx script_name，其中 script_name 是脚本名称。

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

/usr/openv/netbackup/bin/goodies/bpstart_notify

然后，将这个脚本放在 UNIX 客户端上的以下位置：

/usr/openv/netbackup/bin/

修改该脚本并确保具有运行该脚本的权限。

每次启动备份或存档以及完成初始化时，都将运行 bpstart_notify 脚本。该脚本在放置磁带之前运行。该脚本必须以 0 状态退出，以使调用程序继续执行并使备份或存档操作继续。非零状态将导致客户端备份或存档以 bpstart_notify failed 状态退出。

如果存在 /usr/openv/netbackup/bin/bpstart_notify 脚本，则它将在前台运行。客户端上的 bpbkar 进程会等候脚本完成，然后再继续。该脚本中任何不以 & 字符结尾的命令将依次运行。

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

注意:

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

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

clientname	指定 NetBackup 目录库中的客户端名称。
policyname	指定 NetBackup 目录库中的策略名称。
schedname	指定 NetBackup 目录库中的日程表名称。
schedtype	指定以下选项之一： FULL、INCR（差异增量式备份）、CINC（累积增量式备份）、UBAK、UARC

注意:

如果未指定 .policyname[.schedule]，则也会为 NetBackup 目录库备份运行 bpstart_notify 脚本。

例如：

bpstart_notify client1 pol_cd4000s sched_fulls FULL
bpstart_notify client2 pol_cd4000s sched_incrementals INCR
bpstart_notify client3 pol_cd4000s sched_fulls FULL
bpstart_notify client4 pol_cd4000s sched_user_backups UBAK
bpstart_notify client5 pol_cd4000s sched_user_archive UARC

要为特定策略或策略与日程表组合创建 bpstart_notify 脚本，请创建以 .policyname 或 .policyname.schedulename 为后缀的脚本文件。以下是策略 production 的两个脚本名称示例，该策略包含一个日程表 fulls：

/usr/openv/netbackup/bin/bpstart_notify.production
/usr/openv/netbackup/bin/bpstart_notify.production.fulls

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

注意:

对于给定的备份，NetBackup 只使用一个 bpstart_notify 脚本，且该脚本是具有最具体名称的脚本。例如，如果有 bpstart_notify.production 和 bpstart_notify.production.fulls 两个脚本，则 NetBackup 只使用 bpstart_notify.production.fulls。

bpstart_notify 脚本可使用下列环境变量：

BACKUPID
UNIXBACKUPTIME
BACKUPTIME

NetBackup bpbkar 进程创建这些变量。下面是脚本可用于记录备份信息的字符串示例：

BACKUPID=client1_0857340526
UNIXBACKUPTIME=0857340526
BACKUPTIME=Sun Mar 2 16:08:46 2016

此外，可以使用以下环境变量来支持多个数据流。

表：用于支持多个数据流的环境变量

环境变量	描述
STREAM_NUMBER	指定数据流编号。从策略、客户端和日程表生成的第一个数据流为 1。如果值为 0，则表示未启用多个数据流。
STREAM_COUNT	指定从该策略、客户端和日程表生成的数据流总数。
STREAM_PID	指定 bpbkar 的 PID（进程 ID）编号。
RESTARTED	指定检查点重新启动或检查点备份作业。值为 0 表示此作业没有继续（例如，在第一次初始化时）。值为 1 表示作业已继续。