Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- Utilitaire cat_export
- Utilitaire cat_import
- configurePorts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcomponentupdate
- Commande nbcplogs
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbexecute
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- Commande nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbjm
- nbkmsutil
- Commande nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- Commande nbrbutil
- nbregopsc
- nbreplicate
- nbrestorevm
- nbseccmd
- nbsetconfig
- Commande nbsnapimport
- Commande nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- Commande stopltid
- tl4d
- tl8d
- tl8cd
- tldd
- tldcd
- tlhd
- tlhcd
- tlmd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
Nom
bpexpdate — date d'échéance des modifications de sauvegardes dans le catalogue d'image et des médias dans le catalogue de médias
Synopsis
-m id_média -d date | 0 | infinity [-host nom] [-force] [-nodelete] [-notimmediate] [-M serveur_maître,...]
-deassignempty [-m id_média] [-force] [-M serveur_maître,...]
-Bidfile nom_fichier | -backupid id_sauvegarde -d date | 0 | infinity [-client nom] [-copy numéro] [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-do_not_follow_dependee] [-M serveur_maître,...]
-servername nom_serveur -d date | 0 | infinity [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-M serveur_maître,...]
-recalculate [] [-copy nombre] [-d date | 0 | infinity] [-client nom] [-policy nom] [-ret niveau_conservation] [-sched type] [-M serveur_maître,...]
-stype type_serveur [-dp nom_pool_disques [-dv volume_disque]] [-nodelete] [-notimmediate] [-force_not_complete] [-M serveur_maître,...]
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
NetBackup met à jour les catalogues, qui sont des bases de données internes, en fonction de l'image de sauvegarde et des informations sur le média. L'enregistrement d'image dans le catalogue d'image comporte une date d'expiration. L'ID du média dans le catalogue de médias contient également une date d'échéance. La date d'échéance est la date et le moment où NetBackup supprime l'enregistrement pour la sauvegarde ou l'ID de média du catalogue correspondant.
La commande bpexpdate permet de modifier la date d'échéance et l'heure des sauvegardes dans le catalogue d'images de NetBackup. La commande est également utilisée pour modifier l'expiration du média amovible dans le catalogue de médias de NetBackup. Si la date est définie sur zéro, bpexpdate rend immédiatement caduques les sauvegardes du catalogue d'image ou des médias du catalogue de médias. Quand l'ID du média est supprimé du catalogue de médias NetBackup, il est également supprimé de la base de données Enterprise Media Manager. Il est supprimé indépendamment de l'état précédent du média (FIGÉ, INTERROMPU, etc.).
Vous pouvez modifier l'expiration en fonction de l'ID de média ou sur la base d'une sauvegarde individuelle d'ID. Quand vous modifiez la date d'échéance d'un ID de média, la date d'échéance de toutes les sauvegardes sur les médias est également modifiée. bpexpdate fournit également les options suivantes :
Supprime les médias du catalogue de médias s'ils ne contiennent plus les sauvegardes valides.
Recalcule la date d'échéance pour la baser sur un niveau de conservation configuré ou fourni.
Tout utilisateur disposant des autorisations nécessaires peut exécuter cette commande.
Pour plus d'informations sur l'autorisation NetBackup, consultez le Guide de sécurité et de chiffrement NetBackup.
OPERATIONS
Les opérations de commande sont comme suit :
- -backupid id_sauvegarde
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.
- -Bidfile nom_fichier
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.
- -deassignempty
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.
- -recalculate
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.
Remarque :
Le niveau de conservation 25 signifie expiration immédiate. Vous ne pouvez pas modifier cette valeur. Si vous définissez le niveau de conservation d'une image de sauvegarde à 25, l'image de sauvegarde expire immédiatement.
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 :
Une SLP l'a créée.
Si la politique et la planification qui ont enregistré la sauvegarde n'existent plus.
Si le niveau de conservation de la planification qui a enregistré la sauvegarde n'a pas changé depuis que la sauvegarde a été créée.
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.
- -servername nom_serveur
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.
- -stype type_serveur
Spécifie une chaîne identifiant le type de serveur de stockage. La valeur server_type peut provenir d'une des sources suivantes :
Stockage fourni par Veritas. Les valeurs possibles sont AdvancedDisk et PureDisk.
Appliances disque tiers. Le fournisseur fournit la chaîne server_type.
Stockage en cloud. Les valeurs stype de cloud reflètent le fournisseur du stockage en cloud. Déterminez les valeurs possibles avec la commande csconfig, comme indiqué. Les informations en gras (pour les accentuer) sont celles requises pour l'option -stype. Veuillez noter que la sortie de la commande csconfig peut changer selon les fournisseurs pris en charge actuellement.
root:~# csconfig cldprovider -l amazon (Amazon - Simple Storage Service) amazongov (Amazon GovCloud - Simple Storage Service) att (AT&T - Synaptic Storage as a Service) azure (Microsoft Azure - Microsoft Azure Storage Service) cloudian (Cloudian HyperStore - Cloudian HyperStore Object Storage) google (Google Nearline - Google Cloud Storage Nearline) hitachi (Hitachi Cloud Service (HCS) - Hitachi Off Premise Public Cloud) hitachicp (Hitachi Content Platform (HCP) - Hitachi On Premise Private Cloud) rackspace (Rackspace - Cloud Files) swiftstack (SwiftStack - SwiftStack Object Storage) verizon (Verizon - Verizon Cloud Storage)
Les valeurs stype du stockage en cloud doivent intégrer un suffixe (par exemple,
amazon_crypt). Les suffixes possibles sont :_Raw : l'image de sauvegarde de NetBackup est envoyée au cloud, au format brut. Utilisez cette option si vous ne voulez pas compresser ou chiffrer de données avant de les envoyer au stockage en cloud.
_rawc : compresse les données brutes avant leur écriture sur le stockage en cloud. Vous ne pouvez pas utiliser le suffixe _rawc avec att et rackspace.
_crypt: permet de chiffrer les données à l'aide d'AES 256 bits avant leur écriture sur le stockage cloud. Vous devez avoir configuré KMS dans NetBackup pour pouvoir utiliser cette option._cryptc : compresse et chiffre les données avant leur enregistrement sur le stockage en cloud. Vous ne pouvez pas utiliser le suffixe _cryptc avec att et rackspace .
Le type de serveur de stockage est sensible à la casse.
OPTIONS
- -bybackuptime
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.
- -client nom
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.
- -copy number
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.
- -d date
Spécifie la date et l'heure d'expiration. L'option date peut être l'une des valeurs suivantes :
mm/dd/yy hh:mm:ss
0 - la sauvegarde ou le média expire immédiatement
infinity - la sauvegarde n'expire jamais
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 fichierinstall_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 "A propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
- -deassignempty
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.
- -do_not_follow_dependee
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.
- -dp nom_pool_disques -dv volume_disque
Spécifie le pool de disques et, éventuellement, le volume de disque pour que l'opération de date d'expiration soit effectuée.
- -force
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.
- -force_not_complete
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.
- -host name
Remarque :
Pour le serveur NetBackup, cette option n'est pas requise parce qu'un seul serveur (le maître) est présent. Si vous utilisez cette option, spécifiez le nom d'hôte de ce serveur.
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.
- -m id_média
Vérifie si des sauvegardes valides existent sur cet ID de média spécifique. Cette option est uniquement utilisée avec l'option -deassignempty. L'ID du média doit comporter au maximum 6 caractères et doit se trouver dans le catalogue de médias NetBackup.
- -M serveur_maître [,...]
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.
- -nodelete
Supprime la sauvegarde du catalogue d'images, mais ne la supprime pas du stockage sur disque. Utilisez cette option quand vous ôtez l'importation d'un groupe de disques d'un serveur maître et l'importez vers un serveur maître différent.
- -notimmediate
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.
- -policy name
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.
- -recalculate
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.
- -ret niveau_conservation
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.
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.
- -sched type
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ée
L'option de -policy doit être spécifiée avec -sched.
REMARQUES
Certaines options dans des environnements de taille peuvent prendre un temps assez long pour se terminer. Les modifications qui entraînent l'expiration des sauvegardes ou des médias sont irrévocables. Il vous faudra peut-être importer des sauvegardes ou récupérer des versions préalables de catalogues si vous faites des erreurs avec cette commande.
EXEMPLES
Exemple 1 - La commande suivante s'exécute sur le serveur maître et supprime l'ID de média BU0002 du catalogue de médias. Elle libère l'ID de média dans le catalogue de Media Manager. Elle fait également expirer les enregistrements associés aux images du catalogue d'image.
# bpexpdate -m BU0002 -d 0
Exemple 2 - Modification de l'expiration de la copie 2 du backupid eel_0904219764. Elle n'affecte pas l'expiration de la copie 1 de la sauvegarde.
# bpexpdate -backupid eel_0904219764 -d 12/20/2012 08:00:00 -copy 2
Exemple 3 - Suppression de la sauvegarde du catalogue d'image. Puisque l'option de -copy n'est pas spécifiée, toutes les copies sont supprimées.
# bpexpdate -backupid eel_0904219764 -d 0
Exemple 4 - Recherche d'un média dans le catalogue de médias de l'hôte cat qui est encore assigné, mais ne contient plus de sauvegarde valide. La commande supprime de tels médias du catalogue et supprime leur assignation dans le catalogue Media Manager.
# bpexpdate -deassignempty -host cat
Exemple 5 - Recalcule de la date d'expiration de l'ID de sauvegarde 1234 à la date du 31/10/2012.
# bpexpdate -recalculate -backupid 1234 -d 10/31/12
Exemple 6 - Recalcule de la date d'expiration de l'ID de sauvegarde 1234 sur la base d'un niveau de conservation. Le nouveau niveau de conservation est 4, ce qui correspond à deux mois (valeur par défaut). L'ID de sauvegarde 1234 est maintenant planifié pour expirer dans 2 mois.
# bpexpdate -recalculate -backupid 1234 -ret 4
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/media/* /usr/openv/netbackup/db/images/*
Systèmes Windows :
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\media\* nstall_path\NetBackup\db\images\*