Guide de référence des commandes NetBackup™

Modifie l'expiration d'une sauvegarde unique. Si la date est zéro, la sauvegarde est supprimée du catalogue d'images. Si la sauvegarde est sur le média amovible et l'expiration -d est ultérieure à l'expiration actuelle de l'ID du média, l'expiration du catalogue de médias est également modifiée. La modification affecte toutes les copies d'une sauvegarde, à moins que l'option -copy soit utilisée. L'option -copy cible uniquement la copie spécifiée.

Spécifie un fichier qui contient une liste d'ID de sauvegarde dont vous souhaitez modifier la date d'expiration. Entrez un ID de sauvegarde par ligne dans le fichier.

Recherche dans le catalogue les médias amovibles qui ne contiennent plus de sauvegardes valides. Elle supprime les médias du catalogue de médias et supprime les ID de média dans le catalogue de Media Manager. Le média devient à nouveau disponible. Vous pouvez utiliser le rapport de NetBackup Images sur média pour déterminer si les médias attribués ne contiennent plus de sauvegardes valides.

Permet de modifier la date d'expiration des sauvegardes en fonction d'un niveau de conservation, ou de définir une nouvelle date d'expiration. Vous pouvez modifier l'expiration pour une sauvegarde unique ou pour toutes les sauvegardes pour un client, une politique ou un type de planification spécifique. Vous pouvez utiliser l'un des paramètres suivants avec cette option : -bybackuptime, -d ou -ret.

Quand l'option -bybackuptime est utilisée, la date d'expiration de la sauvegarde est définie à la date de création plus la valeur de niveau de conservation qui a été utilisée initialement pour la sauvegarde. Après qu'une sauvegarde a été importée, cette option peut être utilisée pour réinitialiser sa date d'expiration à la valeur initiale.

Quand l'option -ret est utilisée, la date d'expiration de la sauvegarde est définie à la date de création plus la valeur de niveau de conservation spécifiée.

Si aucun des paramètres -bybackuptime, -d ou -ret n'est utilisé avec cette option, la date d'expiration pour toutes les sauvegardes sans politique de cycle de vie de stockage (SLP) sont définies à la date de création plus le niveau de conservation actuel de la planification qui a enregistré la sauvegarde, si elle existe et que le niveau de conservation de la planification a été modifié depuis la création de sauvegarde. La date d'expiration d'une sauvegarde n'est pas recalculée dans les circonstances indiquées :

Si la sauvegarde est sur un média amovible, la date d'expiration du média est également modifiée si la nouvelle date d'expiration de la sauvegarde est postérieure à la date d'expiration actuelle du média.

Spécifie le nom d'un serveur que la modification de date d'expiration affecte. Le nom du serveur se rapporte à un champ de l'enregistrement de fragment d'image où le fragment réside. Ce serveur est le serveur de médias qui exécute le transfert de données. Pour les snapshots, ce serveur est le client où le snapshot réside.

Spécifie une chaîne identifiant le type de serveur de stockage. La valeur server_type peut provenir d'une des sources suivantes :

Le type de serveur de stockage est sensible à la casse.

Spécifie que la date d'expiration de la sauvegarde est définie à la date de création plus la valeur de niveau de conservation qui a été utilisée pour la sauvegarde.

Spécifie le nom de client pour les opérations -backupid et -recalculate.

Pour l'opération backupid, cette option demande à NetBackup de rechercher d'abord l'ID de sauvegarde du client spécifié. Cette option est utile si le nom du client a été modifié.

Pour l'opération recalculate, cette option demande à NetBackup de recalculer la date d'expiration en se basant sur le niveau de conservation pour toutes les sauvegardes client spécifiées.

Fait expirer ou modifie la date d'expiration du nombre de copies spécifié et est valide seulement avec les options -backupid et -recalculate. Les valeurs valides sont comprises entre 1 et 10.

Si la copie principale est expirée, l'autre copie devient la copie principale. Si cette option n'est pas spécifiée, l'expiration affecte les deux copies de la sauvegarde.

Le format requis des valeurs de date et d'heure des commandes NetBackup dépend des paramètres régionaux. Le fichier /user/openv/msg/.conf (UNIX) et le fichier install_path\VERITAS\msg\LC.CONF (Windows) contiennent des informations telles que le format de date et d'heure pour tous les paramètres régionaux pris en charge. Les fichiers contiennent des instructions spécifiques concernant l'ajout et la modification de la liste des paramètres régionaux et des formats pris en charge.

Pour plus d'informations sur les paramètres régionaux de votre système, consultez la rubrique "À propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.

Recherche dans le catalogue les médias amovibles qui ne contiennent plus de sauvegardes valides. Elle supprime les médias du catalogue de médias. Le média devient à nouveau disponible. Vous pouvez utiliser le rapport de NetBackup Images sur média pour déterminer si les médias attribués ne contiennent plus de sauvegardes valides.

Par défaut, lorsqu'une image enfant (dependant) a expiré, l'image parent (dependee) éligible expire également. La commande -do_not_follow_dependee modifie ce comportement afin que l'expiration de l'image n'affecte pas l'image parent.

Spécifie le pool de disques et, éventuellement, le volume de disque pour que l'opération de date d'expiration soit effectuée.

Utilisez l'option -extend_worm_locks pour prolonger la date d'expiration d'une copie WORM. Le délai d'expiration de copie WORM ne peut jamais être raccourci. Par défaut, le délai d'expiration des copies WORM ne peut pas être prolongé. Cette option doit être fournie pour prolonger le délai d'expiration des copies WORM. Si vous utilisez l'option -extend_worm_locks sans l'option -copy, l'option -extend_worm_locks n'a aucun effet sur les copies non WORM. Si vous utilisez les options -extend_worm_locks et -copy, et que la copie spécifiée n'est pas WORM, la commande échouera.

Si aucune copie WORM n'est spécifiée, cette option n'a aucun effet sauf si l'option -copy est également spécifiée.

Avant que vous exécutiez l'opération spécifiée, bpexpdate demande confirmation. Cette option oblige la commande bpexpdate à effectuer l'opération sans demander à l'utilisateur.

Par défaut, une image gérée par la SLP ou ses copies ne peut expirer si le traitement SLP est en cours. L'option -force_not_complete remplace cette restriction et fait expirer l'image même si elle n'est pas arrivée au terme de la politique de cycle de vie du stockage. Notez que lorsque vous mettez fin à tout autre traitement SLP d'une image, d'autres copies d'image peuvent également expirer.

Spécifie le nom d'hôte du serveur auquel le média est attribué. Cette option doit être utilisée seulement avec l'option -m media_id et seulement si ce qui suit est vrai : Le maître dispose de serveurs de médias distants et le volume n'a pas été écrit sur le serveur où vous exécutez bpexpdate.

Par exemple, supposons que votre serveur maître porte le nom Whale et votre serveur de médias le nom Eel. Vous exécutez la commande suivante sur Baleine pour supprimer le média avec l'ID BU0001 manuellement du catalogue de médias et toutes sauvegardes correspondantes du catalogue d'images :

bpexpdate -m BU0001 -d 0 -host eel

Vous pouvez utiliser le rapport Liste des médias de NetBackup pour déterminer le catalogue de médias du serveur ayant le volume.

Vérifie si des sauvegardes valides existent sur cet ID de média spécifique. Cette option est utilisée avec l'option -deassignempty uniquement. L'ID du média doit comporter au maximum 6 caractères et doit figurer dans le catalogue de médias NetBackup. Cette option spécifie uniquement le média amovible, non les images sur disque.

Indique que le serveur maître gérant le catalogue de médias est propriétaire de l'ID de média. Si vous n'avez pas spécifié cette option, le paramètre par défaut est l'un des suivants :

Pour le serveur NetBackup :

Le serveur NetBackup prend en charge un seul serveur (le maître) sans serveurs de médias distants. Par conséquent, le paramètre par défaut reste dans ce cas toujours le serveur maître où vous exécutez la commande.

Pour NetBackup Enterprise Server :

Si la commande est exécutée sur un serveur maître, ce serveur représente alors le serveur par défaut. Si la commande est exécutée sur un serveur de médias qui n'est pas le serveur maître, le serveur maître de ce serveur de médias représente alors le serveur par défaut.

Supprime la sauvegarde du catalogue d'images, mais ne la supprime pas du stockage sur disque. Utilisez cette option lorsque vous ôtez l'importation d'un groupe de disques d'un serveur maître et l'importez vers un serveur maître différent.

Lorsque l'option -try_expire_worm_copy est utilisée, les copies WORM sont supprimées du catalogue NetBackup, mais ne sont pas supprimées du stockage. Sans l'option -try_expire_worm_copy, -nodelete ne supprime pas les copies WORM du catalogue NetBackup si leurs valeurs ExpireTime et WormUnlockTime n'ont pas expiré.

Empêche l'appel de bpexpdate à la commande nbdelete après avoir entraîné l'expiration d'une image sur le disque. Si vous avez l'intention de supprimer de nombreuses images en même temps, utilisez -notimmediate pour éviter que nbdelete n'ait à traiter trop de créations de travaux. Vous pouvez alors exécuter la commande nbdelete ultérieurement.

Spécifie le nom de la politique et est valide avec l'option -recalculate. Quand le nom de la politique est spécifié, l'expiration est recalculée en fonction du niveau de conservation pour toutes les sauvegardes créées sous cette politique.

Permet la modification de la date d'expiration des sauvegardes en fonction du niveau de conservation spécifié ou vous pouvez spécifier une nouvelle date d'expiration. Vous devez spécifier l'option -d ou -ret avec cette option. Quand l'expiration change selon le niveau de conservation, la nouvelle date est basée sur la date de création de la sauvegarde plus la valeur du niveau de conservation. Vous pouvez modifier l'expiration pour une sauvegarde unique ou pour toutes les sauvegardes pour un client, une politique ou un type de planification spécifique.

Si la sauvegarde se trouve sur un média amovible, l'expiration dans le catalogue de médias change si l'expiration de la commande est ultérieure à l'expiration actuelle.

Lit la durée du déverrouillage WORM pour une image ou une copie d'image à partir du stockage et la met à jour dans le catalogue. Cette option peut uniquement être utilisée avec les options -backupid, -copy et -Bidfile. Si aucune copie n'est spécifiée, cette option actualise toutes les copies avec verrouillage WORM de l'image. Cette option actualise uniquement l'heure de déverrouillage WORM sans mettre à jour les indicateurs WORM.

Spécifie le niveau de conservation à utiliser quand vous recalculez les dates d'expiration et est valide avec l'option -recalculate. Plage de niveaux de 0 à 100. La nouvelle date d'expiration est la date de création de la sauvegarde plus ce niveau de conservation. Vous devez spécifier -backupid ou -policy avec cette option.

Spécifie le type de planification et est valide avec l'option -recalculate. Quand le type est spécifié, l'expiration est recalculée en fonction du niveau de conservation pour toutes les sauvegardes créées avec ce type de planification. Entrez une valeur numérique pour le type, comme suit :

0 = Complète

1 = Incrémentielle différentielle

2 = Sauvegarde utilisateur

3 = Archive utilisateur

4 = Incrémentielles cumulées

L'option de -policy doit être spécifiée avec -sched.

Tente d'expirer les copies WORM même si les valeurs ExpireTime et WormUnlockTime n'ont pas encore expiré. Si le périphérique de stockage continue d'appliquer la durée ineffaçable de la copie, celle-ci sera conservée dans le catalogue NetBackup. La valeur WORM Unlock Time est mise à jour, le cas échéant. Pour gérer la liste de travail de suppression de NetBackup, consultez nbdelete -list. Cette option requiert également de spécifier le paramètre -copy ou -nodelete.