Recherche dans <book_title>…

Guide de l'administrateur NetBackup™, volume II

Last Published: 2023-12-28

Product(s): NetBackup (10.3)

script bpstart_notify (clients UNIX)

Sur les clients UNIX, NetBackup appelle le script bpstart_notify chaque fois que le client lance une opération de sauvegarde ou d'archivage.

Remarque :

Assurez-vous que d'autres utilisateurs peuvent exécuter ce script sur le client avant de l'utiliser. Pour ce faire, exécutez la commande chmod ugo+rx script_name, où script_name correspond au nom du script.

Pour utiliser ce script, copiez le fichier suivant à partir du serveur :

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

Placez ensuite le script à l'emplacement suivant du client UNIX :

/usr/openv/netbackup/bin/

Modifiez le script et assurez-vous que vous êtes autorisé à l'exécuter.

Le script bpstart_notify est exécuté à chaque démarrage d'une opération de sauvegarde ou d'archivage, une fois l'initialisation terminée. Il est exécuté avant la mise en place de la bande. La fin de l'exécution de ce script doit renvoyer l'état 0 pour permettre au programme ayant fait appel à ce script et à l'opération de sauvegarde ou d'archivage de se poursuivre. Si le script renvoie un autre état, l'opération de sauvegarde ou d'archivage du client se termine avec l'état bpstart_notify failed.

Si le script /usr/openv/netbackup/bin/bpstart_notify existe, il s'exécute en premier plan. Le processus bpbkar sur le client attend que le script se termine avant de continuer. Toutes les commandes du script ne se terminant pas par une esperluette (&) sont exécutées les unes après les autres.

Le serveur attend que le client affiche le message continue, une fois le délai spécifié par l'option BPSTART_TIMEOUT du serveur écoulé. Le paramètre par défaut pour BPSTART_TIMEOUT est de 300 secondes. Si le script nécessite plus de 300 secondes, augmentez la valeur afin de lui accorder plus de temps. (L'option BPSTART_TIMEOUT correspond au Délai de notification du début de la sauvegarde sur les propriétés d'hôte de Délais d'expiration.)

Remarque :

Délai de lecture client (option CLIENT_READ_TIMEOUT) doit être égal ou supérieur à Délai de notification du début de la sauvegarde (option BPSTART_TIMEOUT). Si le délai de lecture client est inférieur au délai de notification du début de la sauvegarde, le travail peut expirer pendant que le script bpstart_notify est en cours d'exécution.

NetBackup transmet les paramètres suivants au script :

clientname	Spécifie le nom du client issu du catalogue NetBackup.
policyname	Spécifie le nom de politique issu du catalogue NetBackup.
schedname	Spécifie le nom de planification issu du catalogue NetBackup.
schedtype	Spécifie l'un des éléments suivants : FULL, INCR (incrémentielle différentielle), CINC (incrémentielle cumulative), UBAK, UARC

Remarque :

Si vous n'avez spécifié aucune planification de type .policyname[.schedule], le script bpstart_notify est également exécuté pour les sauvegardes de catalogue NetBackup.

Par exemple :

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

Pour créer un script bpstart_notify pour une politique ou une combinaison de politiques spécifique, créez des fichiers script avec un suffixe .policyname ou .policyname.schedulename. Voici des exemples de noms de scripts pour une politique portant le nom "production" avec une planification portant le nom "fulls" :

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

Le premier script affecte toutes les sauvegardes planifiées dans la politique portant le nom "production". Le deuxième script affecte les sauvegardes planifiées associées à la politique se nommant "production" uniquement lorsque la planification se nomme "fulls".

Remarque :

NetBackup n'exécute qu'un seul script bpstart_notify par sauvegarde ; il s'agit du script portant le nom le plus précis. Par exemple, si vous disposez de deux scripts bpstart_notify.production et bpstart_notify.production.fulls, NetBackup utilise uniquement bpstart_notify.production.fulls.

Le script bpstart_notify peut utiliser les variables d'environnement suivantes :

BACKUPID
UNIXBACKUPTIME
BACKUPTIME

Le processus NetBackup de bpbkar crée ces variables. Les exemples suivants contiennent des chaînes de caractères pouvant être utilisées par le script pour enregistrer les informations concernant une sauvegarde :

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

De plus, lorsque vous disposez de plusieurs flux de données, vous pouvez utiliser les variables d'environnement suivantes :

Tableau : Variables d'environnement utilisées pour prendre en charge les flux de données multiples

Variable d'environnement	Description
STREAM_NUMBER	Spécifie le numéro de flux. Le premier flux d'une combinaison politique, client et planification correspond à la valeur 1. La valeur 0 signifie que vous ne pouvez pas utiliser plusieurs flux de données.
STREAM_COUNT	Spécifie le nombre total de flux à générer à partir de cette politique, ce client et cette planification.
STREAM_PID	Spécifie le numéro PID (ID de processus) de bpbkar.
RESTARTED	Spécifie des redémarrages au point de contrôle ou des travaux de sauvegarde au point de contrôle. La valeur 0 indique que le travail n'a pas été repris La valeur 1 signifie que le travail a été repris.