Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpplschedrep — modifier les attributs de la planification NetBackup
Synopsis
nom_politique étiquette_planification [ -M serveur_maître,...] [-v] [-generation génération] [-st type_planification] [-freq fréquence_sauvegarde] [-mpxmax facteur_mpx] [-cal 0|1|2] [-incl mm/jj/aaaa] [-excl mm/jj/aaaa] [-delincl mm/jj/aaaa] [-delexcl mm/jj/aaaa] [-weekday nom_jour semaine [nom_jour semaine]...] [-dayomonth 1-31 [1-31]... | l] [-xweekday nom_jour semaine [nom_jour semaine]...] [-xdayomonth 1-31 [1-31]... | l] [-deldayomonth 1-31 [1-31]... | l] [-delweekday nom_jour semaine [nom_jour semaine]...] [-ci] [-ce] [-cw] [-cd] [-number_copies nombre][-rl niveau_conservation[,rl-copy2,...]] [-fail_on_error 0|1[,0|1,...,0|1]] [-residence étiquette_unité_stockage [,stunit_copy2,...]] [-pool étiquette_pool_volumes [,pool_copy2,...]] [-sg groupe_partages [,share_copy2,...]] [-(0..6) start duration] [-res_is_stl 0 | 1] [-reason "chaîne"] [-slpwindow] [-checksum_change_detection 0|1]
Sur les systèmes UNIX, le chemin d'accès à cette commande est /usr/openv/netbackup/bin/admincmd/
Sur les systèmes Windows, le chemin d'accès à cette commande est chemin_d'accès\NetBackup\bin\admincmd\
DESCRIPTION
bpplschedrep modifie les attributs d'une planification NetBackup pour une politique définie. La planification et la politique que bpplschedrep nomme devraient déjà exister quand cette commande est exécutée. Si l'option -M est utilisée, bpplschedrep modifie la planification sur chacun des serveurs maîtres énumérés.
L'option -slpwindow vous permet de configurer la planification d'une politique de cycle de vie du stockage (SLP) basée sur une fenêtre de temps et prend en charge l'heure de début et l'heure de fin uniquement. Vous devez utiliser le nom de politique pré-défini SLP_Internal_Policy et le type de planification doit être UBAK (sauvegarde utilisateur).
Tout utilisateur disposant des autorisations nécessaires peut lancer cette commande.
Pour plus d'informations sur l'autorisation NetBackup, consultez le Guide de sécurité et de chiffrement NetBackup.
OPTIONS
- -(0..6) début_durée
Spécifie la période d'exécution des sauvegardes de cette planification par NetBackup. Cette fenêtre s'applique à un jour spécifique de la semaine. 0 correspond à dimanche, 1 à lundi et ainsi de suite.
start correspond à l'heure d'ouverture de la fenêtre de restauration de cette planification. Ce temps est calculé en secondes à partir de minuit. Il s'agit d'un nombre entier compris entre 0 et 86 400 (nombre de secondes dans une journée).
duration correspond à la période pendant laquelle la fenêtre reste ouverte. Unité de temps en secondes. Cette unité est un entier non négatif.
- -cal 0|1|2
Indique si bpplschedrep suit une planification sur calendrier ou une planification sur fréquence.
0 = planification sur fréquence
1 = planification sur calendrier sans relance après le jour d'exécution
2 = planification sur calendrier avec relance après le jour d'exécution
- -checksum_change_detection 0|1
Active ou désactive l'option Réanalyse forcée par l'accélérateur dans la planification de politique.
0 = désactiver
1 = activer
- -dayomonth 1-31 [1-31]... | l
Spécifie le ou les jours de chaque mois auxquels exécuter la planification. Entrez l (L minuscule) pour une exécution le dernier jour de chaque mois, que le mois contienne 28, 29, 30 ou 31 jours.
Par exemple, pour exécuter la sauvegarde de politique les 14 et 28 de chaque mois, entrez ce qui suit :
-dayomonth 14 28
Pour exécuter le dernier jour du chaque mois, entrez :
-dayomonth l
- -deldayomonth 1-31 [1-31]... | l
Spécifie un jour de chaque mois à exclure comme jour d'exécution. Entrez l (L minuscule) pour exclure le dernier jour de chaque mois, si le mois contient 28, 29, 30 ou 31 jours. Cette commande peut seulement supprimer les dates qui ont été ajoutées à l'aide de la commande -dayomonth.
Par exemple, pour exclure de la planification le 20 et le 21 de chaque mois initialement spécifiés en tant que jours d'exécution, entrez :
-deldayomonth 20 21
- -delweekday day_name week [day_name week]...
Spécifie un jour de la semaine et une semaine dans le mois comme jour d'exécution de la planification. Cette commande peut seulement supprimer les dates qui ont été ajoutées à l'aide de la commande -weekday.
nom_jour correspond à : dimanche, lundi, mardi, mercredi, jeudi, vendredi ou samedi.
L'unité week correspond au nombre de semaines dans un mois. Une semaine commence le dimanche et se termine le samedi. Les valeurs valides sont 1 à 5.
Par exemple, pour supprimer le deuxième lundi du mois initialement spécifié comme jour d'exécution, entrez :
-delweekday Monday 2
- -excl mm/jj/aaaa
Spécifie l'exclusion de cette date unique.
- -delincl mm/jj/aaaa
Spécifie la suppression de cette date unique. Cette commande peut seulement supprimer les dates qui ont été ajoutées à l'aide de la commande -incl.
- -delexcl mm/jj/aaaa
Spécifie la suppression de cette date unique.
- -ci
Efface toutes les dates à inclure spécifiées.
- -ce
Efface toutes les dates à exclure spécifiées.
- -cw
Efface tous les jours de semaine.
- -cd
Efface tous les jours d'un mois.
- -fail_on_error 0|1[,0|1,...,0|1]
Spécifie s'il faut mettre en échec toutes les autres copies en cas d'échec d'une copie. En cas d'absence de paramètres, la valeur 0 est appliquée par défaut à toutes les copies. Spécifiez une valeur pour chaque copie.
0 = Ne pas mettre les autres copies en échec
1 - Mettre les autres copies en échec
- -freq fréquence_sauvegarde
La fréquence de sauvegarde contrôle combien d'heure peut s'écouler entre les sauvegardes automatiques réussies pour des clients sur cette planification. La fréquence ne s'applique pas aux planifications d'utilisateur, car l'utilisateur peut effectuer une sauvegarde ou un archivage à tout moment lorsque la fenêtre est ouverte. Cette valeur est un entier positif qui représente le nombre de secondes écoulées entre les sauvegardes automatiques réussies pour cette planification.
- -help
Imprime un message d'utilisation de ligne de commande quand -help est la seule option sur la ligne de commande.
- -generation génération
Permet de vérifier que la commande agit au niveau d'une génération ou d'une version spécifique de politique. La valeur générée est incrémentée à chaque nouvel enregistrement de la politique. Utilisez bpplinfo ou bppllist pour lister la valeur de génération actuelle. En cas d'absence de génération, la commande est exécutée sur la version actuelle.
- -incl mm/jj/aaaa
Spécifie l'inclusion de cette date unique.
- -M serveur_maître,...
Liste des autres serveurs maîtres. Cette liste de noms d'hôtes est délimitée par virgules. Si cette option est présente, chaque serveur maître dans la liste exécute la commande de bpplschedrep. Chaque serveur maître dans la liste doit permettre l'accès par le système qui a émis la commande de bpplschedrep. En cas d'erreur sur un serveur maître quelconque, le processus s'interrompt sur ce serveur.
Les attributs de planification sont modifiés sur tous les serveurs maîtres dans cette liste.
- -mpxmax facteur_multiplex
Le facteur de multiplexage maximal pour cette planification. Le multiplexage envoie les sauvegardes simultanées et multiples d'un ou plusieurs clients vers un lecteur unique.
Le facteur de multiplexage peut s'étendre de 1 à 8 pour le serveur NetBackup et 1 à 32 pour le serveur Enterprise NetBackup. Une valeur de 1 ne spécifie aucun multiplexage et une valeur supérieure à un signifie que NetBackup devrait créer des images multiplexées sur les médias d'emplacement. Le facteur de multiplexage devrait être inférieur ou égal au facteur de multiplexage pour l'unité de stockage.
Pour plus d'informations sur le multiplexage, consultez le Guide de l'administrateur NetBackup, volume I.
- -number_copies nombre
Spécifiez le nombre de copies de sauvegarde simultanées. La plage de valeurs valide est comprise entre 1 et 4. La valeur par défaut est 1.
- policy_name
Le nom de la politique qui contient la planification. Cette politique a été précédemment créée.
- -pool label_pool_volumes [,pool_copie2,...]
Spécifie le ou les pools de volumes de la planification. N'utilisez pas cette option si une unité de stockage sur disque constitue l'emplacement de la planification. Si l'argument *NULL* est spécifié, le pool de volumes de la planification correspond au pool de volumes de la politique contenant cette planification.
Spécifiez le pool de chaque copie.
Pour afficher les pools de volumes configurés, exécutez la commande suivante :
Systèmes UNIX :
/usr/openv/volmgr/bin/vmpool -listall
Systèmes Windows :
install_path\Volmgr\bin\vmpool -listall
- -reason "chaîne"
Indique la raison pour laquelle vous choisissez cette action de commande. La chaîne de texte de raison que vous entrez est capturée et apparaît dans le rapport d'audit. Entourez cette chaîne avec des guillemets ("… "). La chaîne ne doit pas dépasser 512 caractères. Elle ne peut pas commencer par un tiret (-) ni contenir un guillemet simple (').
- -res_is_stl 0 | 1
Spécifiez cet indicateur seulement quand le nom de l'unité de stockage et le nom de la politique de cycle de vie du stockage sont identiques. Dans tous les autres cas cet indicateur est ignoré. Les valeurs possibles sont les suivantes :
0 - la résidence est une politique de cycle de vie de non stockage
1 - l'emplacement est une politique de cycle de vie du stockage
- -residence label_unité_stockage[,unité_stockage_copie2,...]
Spécifie la ou les étiquettes de l'unité de stockage à utiliser pour enregistrer les sauvegardes créées par cette planification. Si l'argument *NULL* est spécifié, la planification par défaut se trouve dans la politique correspondante. Si la valeur d'emplacement est une étiquette d'unité de stockage, l'emplacement pour la planification devient cette unité de stockage et remplace l'emplacement pour la politique.
Spécifiez l'unité de stockage de chaque copie.
Exécutez bpstulist pour afficher l'ensemble d'unités de stockage définies.
- -rl niveau_conservation[,rl_copie2,...]
Spécifie combien de temps NetBackup maintient les sauvegardes qu'il crée à l'aide de cette planification. Des niveaux de conservation valides et leurs temps par défaut correspondants de conservation sont listés plus tard dans cette description.
Spécifiez un niveau de conservation pour chaque copie.
Attention :
Vous pouvez modifier la période de conservation associée à chaque niveau à l'aide de l'interface d'administration NetBackup. Par conséquent, la configuration peut avoir des valeurs différentes de celles affichées pour chaque niveau. Utilisez l'interface d'administration de NetBackup pour identifier les périodes de conservation réelles avant d'utiliser cette commande et apporter des modifications.
Dans le cas contraire, les sauvegardes peuvent expirer plus tôt que prévu et cela peut causer des pertes de données.
0 (1 semaine)
1 (2 semaines)
2 (3 semaines)
3 (1 mois)
4 (2 mois)
5 (3 mois)
6 (6 mois)
7 (9 mois)
8 (1 an)
9 à 100 (infini, sauf 25 qui signifie expiration immédiate)
Remarque :
Si vous exécutez cette commande sur un serveur de médias antérieur à NetBackup 8.0, vous pouvez seulement spécifier un niveau de conservation entre 0 et 24.
NetBackup garde les informations à propos de les sauvegardes pendant le temps spécifié. Puis, il supprime les informations les concernant. Quand les informations sont supprimées, les fichiers dans les sauvegardes sont indisponibles pour des restaurations. Quand toutes les sauvegardes sur un volume ont expiré, le volume peut être réattribué.
- sched_label
Spécifie le nom de la planification à modifier. Cette planification a été précédemment créée.
- -sg groupe_partage [,partage_copie2,...]
Spécifie le ou les groupes de partage de la planification. N'utilisez pas cette option si la planification si une unité de stockage sur disque constitue l'emplacement de la planification. Si l'argument *NONE* est spécifié, le serveur de médias d'écriture est propriétaire du média écrit par cette politique. Si l'argument *ANY* est spécifié, EMM choisit le propriétaire de médias. *ANY* est la valeur par défaut. Dans le cas contraire, le groupe de partage spécifié est propriétaire du média. Spécifiez le groupe de partage de chaque copie afin d'afficher les groupes de partage configurés. Indiquez les éléments suivants :
Systèmes UNIX :
/usr/openv/netbackup/bin/admincmd/nbsvrgrp -list -summary
Systèmes Windows :
install_path\NetBackup\bin\admincmd\nbsvrgrp -list -summary
- -slpwindow
Ajoute ou supprime des fenêtres de temps pour une SLP_internal_policy.
- -st type_planification
Spécifie le type de sauvegarde que cette planification effectue. Les types de planification se rangent dans une catégorie automatique ou une catégorie d'utilisateur. Les planifications automatiques définissent les fenêtres pendant lesquelles le planificateur NetBackup peut lancer une sauvegarde pour cette politique.
Les planifications d'utilisateur définissent les fenêtres pendant lesquelles un utilisateur peut lancer une sauvegarde ou une archive.
Les valeurs pour le type de planification sont les suivantes :
FULL - sauvegarde complète
INCR - sauvegarde incrémentielle différentielle
CINC - sauvegarde incrémentielle cumulative
TLOG - journal des transactions
UBAK - sauvegarde utilisateur
UARC - archive utilisateur
- -weekday day_name week [day_name week]...
Spécifie un jour de la semaine et une semaine dans le mois en tant que jour d'exécution dans la planification.
nom_jour correspond à : dimanche, lundi, mardi, mercredi, jeudi, vendredi ou samedi.
L'unité week correspond au nombre de semaines dans un mois. Une semaine commence le dimanche et se termine le samedi. Les valeurs valides sont 1 à 5.
Par exemple, pour donner l'instruction à la politique de s'exécuter chaque dimanche du mois, entrez :
-weekday Sunday 1 Sunday 2 Sunday 3 Sunday 4 Sunday 5
- -v
Sélectionne le mode détaillé. Cette option fait consigner bpplschedrep les informations supplémentaires pour le débogage. Les informations entrent quotidiennement dans le journal de débogage d'administration NetBackup. Cette option est significative seulement quand NetBackup active la fonction de débogage de journal (c'est-à-dire, quand le répertoire suivant est défini) :
Systèmes UNIX :
/usr/openv/netbackup/logs/admin
Systèmes Windows :
install_path\NetBackup\logs\admin
- -xdayomonth 1-31 [1-31]... | l
Spécifie le ou les jours du mois que vous voulez exclure en tant que jours d'exécution de la planification. Utilisez l (L minuscule) pour indiquer le dernier jour du mois.
Par exemple, pour donner l'instruction à la politique de ne pas exécuter la sauvegarde le 6 du mois, entrez :
-xdayomonth 6
- -xweekday day_name week [day_name week]...
Spécifie le jour de la semaine et la semaine du mois à exclure en tant que jour d'exécution de la planification.
nom_jour correspond à : dimanche, lundi, mardi, mercredi, jeudi, vendredi ou samedi.
L'unité week correspond au nombre de semaines dans un mois. Les valeurs valides sont 1 à 5.
Par exemple, pour donner l'instruction à la politique de ne pas s'exécuter les 3è lundi et mercredi du mois, entrez :
-xweekday Monday 3 Wednesday 3
EXEMPLES
Exemple 1 - Définition de la fréquence d'une planification.
# bpplschedrep mkbpolicy incr -freq 604800
Ceci définit à une (1) semaine près la fréquence avec laquelle des sauvegardes automatiques sont effectuées pour la planification incr de la politique mkbpolicy.
Exemple 2 - Pour le samedi et le dimanche de chaque semaine, indiquez le début de la fenêtre de planification de la politique mkbpolicy à 22h au lieu de 23h. Définissez également la durée de la fenêtre sur deux (2) heures au lieu d'une (1) heure. La commande bpplschedrep réinitialise les fenêtres et la commande bpplsched répertorie les nouvelles valeurs de la planification.
# bpplschedrep newpolicy full -0 79200 7200 -6 79200 7200 # bpplsched newpolicy -U -label full Schedule: full Type: Full Backup Frequency: every 7 days Retention Level: 1 (2 weeks) Maximum MPX: 1 Residence: (specific storage unit not required) Volume Pool: (same as policy volume pool) Daily Windows: Sunday 22:00:00 --> Sunday 24:00:00 Monday 23:00:00 --> Monday 24:00:00 Tuesday 23:00:00 --> Tuesday 24:00:00 Wednesday 23:00:00 --> Wednesday 24:00:00 Thursday 23:00:00 --> Thursday 24:00:00 Friday 23:00:00 --> Friday 24:00:00 Saturday 22:00:00 --> Saturday 24:00:00
Exemple 3 - Modifiez la fenêtre ouverte de la planification de la politique de cycle de vie du stockage dup_tape1
de 6h à 10h. Utilisez le nom de la politique prédéfini SLP_internal_policy
et le type de planification UBAK. Cette fenêtre de temps ne possède aucune propriété.
# bpplschedrep SLP_internal_policy -add dup_tape1 -window 21600 14400 -st UBAK -slpwindow
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/policy/policy_name/schedule
Systèmes Windows :
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\policy\policy_name\schedule
VOIR AUSSI
Se reporter à bpplsched.