NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.4)
  1. Introduction
    1.  
      A propos des commandes de NetBackup
    2.  
      Navigation dans les niveaux de menu
    3.  
      Conventions des commandes NetBackup
    4.  
      Remarques sur les commandes de NetBackup Media Manager
    5.  
      Mises à jour IPv6
  2. Annexe A. NetBackup Commands
    1.  
      acsd
    2.  
      backupdbtrace
    3.  
      backuptrace
    4.  
      bmrc
    5.  
      bmrconfig
    6.  
      bmrepadm
    7.  
      bmrprep
    8.  
      bmrs
    9.  
      bmrsrtadm
    10.  
      bp
    11.  
      bparchive
    12.  
      bpbackup
    13.  
      bpbackupdb
    14.  
      bpcatarc
    15.  
      bpcatlist
    16.  
      bpcatres
    17.  
      bpcatrm
    18.  
      bpcd
    19.  
      bpchangeprimary
    20.  
      bpcleanrestore
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bpplschedwin
    62.  
      bppolicynew
    63.  
      bpps
    64.  
      bprd
    65.  
      bprecover
    66.  
      bprestore
    67.  
      bpretlevel
    68.  
      bpschedule
    69.  
      bpschedulerep
    70.  
      bpsetconfig
    71.  
      bpstsinfo
    72.  
      bpstuadd
    73.  
      bpstudel
    74.  
      bpstulist
    75.  
      bpsturep
    76.  
      bptestbpcd
    77.  
      bptestnetconn
    78.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configureCerts
    84.  
      configureMQ
    85.  
      configureWebServerCerts
    86.  
      create_nbdb
    87.  
      csconfig cldinstance
    88.  
      csconfig cldprovider
    89.  
      csconfig meter
    90.  
      csconfig reinitialize
    91.  
      csconfig throttle
    92.  
      duplicatetrace
    93.  
      importtrace
    94.  
      jbpSA
    95.  
      jnbSA
    96.  
      ltid
    97.  
      mklogdir
    98.  
      msdpcldutil
    99.  
      nbauditreport
    100.  
      nbcallhomeproxyconfig
    101.  
      nbcatsync
    102.  
      NBCC
    103.  
      NBCCR
    104.  
      nbcertcmd
    105.  
      nbcertupdater
    106.  
      nbcldutil
    107.  
      nbcmdrun
    108.  
      nbcomponentupdate
    109.  
      nbcplogs
    110.  
      nbcredkeyutil
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_backup
    116.  
      nbdb_move
    117.  
      nbdb2adutl
    118.  
      nbdb_restore
    119.  
      nbdbms_start_stop
    120.  
      nbdc
    121.  
      nbdecommission
    122.  
      nbdelete
    123.  
      nbdeployutil
    124.  
      nbdevconfig
    125.  
      nbdevquery
    126.  
      nbdiscover
    127.  
      nbdna
    128.  
      nbemm
    129.  
      nbemmcmd
    130.  
      nbepicfile
    131.  
      nbfindfile
    132.  
      nbfirescan
    133.  
      nbfp
    134.  
      nbftadm
    135.  
      nbftconfig
    136.  
      nbgetconfig
    137.  
      nbhba
    138.  
      nbholdutil
    139.  
      nbhostidentity
    140.  
      nbhostmgmt
    141.  
      nbhypervtool
    142.  
      nbidpcmd
    143.  
      nbimageshare
    144.  
      nbinstallcmd
    145.  
      nbjm
    146.  
      nbkmiputil
    147.  
      nbkmscmd
    148.  
      nbkmsutil
    149.  
      nboraadm
    150.  
      nborair
    151.  
      nboracmd
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmariadb
    155.  
      nbmlb
    156.  
      nbperfchk
    157.  
      nbplupgrade
    158.  
      nbrb
    159.  
      nbrbutil
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbshvault
    167.  
      nbsmartdiag
    168.  
      nbsnapimport
    169.  
      nbsnapreplicate
    170.  
      nbsqladm
    171.  
      nbsqlite
    172.  
      nbstl
    173.  
      nbstlutil
    174.  
      nbstop
    175.  
      nbsu
    176.  
      nbsvrgrp
    177.  
      netbackup_deployment_insights
    178.  
      resilient_clients
    179.  
      restoretrace
    180.  
      stopltid
    181.  
      tldd
    182.  
      tldcd
    183.  
      tpautoconf
    184.  
      tpclean
    185.  
      tpconfig
    186.  
      tpext
    187.  
      tpreq
    188.  
      tpunmount
    189.  
      verifytrace
    190.  
      vltadm
    191.  
      vltcontainers
    192.  
      vlteject
    193.  
      vltinject
    194.  
      vltoffsitemedia
    195.  
      vltopmenu
    196.  
      vltrun
    197.  
      vmadd
    198.  
      vmchange
    199.  
      vmcheckxxx
    200.  
      vmd
    201.  
      vmdelete
    202.  
      vmoprcmd
    203.  
      vmphyinv
    204.  
      vmpool
    205.  
      vmquery
    206.  
      vmrule
    207.  
      vmupdate
    208.  
      vnetd
    209.  
      vssat
    210.  
      vwcp_manage
    211.  
      vxlogcfg
    212.  
      vxlogmgr
    213.  
      vxlogview
    214.  
      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

bpexpdate -m media_id -d date | 0 | infinity [-host name] [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]

bpexpdate -deassignempty [-m media_id] [-force] [-M master_server,...]

bpexpdate -Bidfile filename | -backupid backup_id -d date | 0 | infinity [-client name] [-copy number] [-copy number -try_expire_worm_copy] [-force] [-nodelete] [-nodelete -try_expire_worm_copy] [-notimmediate] [-force_not_complete] [-do_not_follow_dependee] [-M master_server,...] [-extend_worm_locks] [-refresh_worm_locks]

bpexpdate -servername servername -d date | 0 | infinity [-force] [-nodelete] [-nodelete -try_expire_worm_copy] [-notimmediate] [-force_not_complete] [-M master_server,...] [-extend_worm_locks]

bpexpdate -recalculate [-backupid backupid] [-copy number] [-copy number -try_expire_worm_copy] [-d date | 0 | infinity] [-client name] [-policy name] [-ret retention_level] [-sched type] [-M master_server,...] [-extend_worm_locks]

bpexpdate -stype server_type [-dp disk_pool_name [-dv disk_volume]] [-nodelete] [-nodelete -try_expire_worm_copy] [-notimmediate] [-force_not_complete] [-M master_server,...]

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/

On Windows systems, the directory path to this command is install_path\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. Le catalogue d'image comporte une date d'expiration pour l'enregistrement d'image. 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.

Certaines copies de NetBackup peuvent posséder des attributs WORM (Write Once Read Many). NetBackup tente de définir la durée de déverrouillage WORM de la copie en fonction de l'heure d'expiration définie dans le catalogue NetBackup. Lors du prolongement du délai d'expiration WORM d'une copie, NetBackup exécute des commandes de stockage pour ce faire. Ce prolongement du délai de déverrouillage du stockage est uniquement autorisé si la commande bpexpdate est appelée avec l'option -extend_worm_locks. Vous ne pouvez pas réduire le délai d'expiration des copies WORM.

Par défaut, les copies WORM ne peuvent pas être supprimées du catalogue NetBackup tant que leurs valeurs Heure d'expiration et Copier le temps de déverrouillage WORM n'ont pas expiré. Consultez la sortie de bpimagelist pour connaître les valeurs actuelles d'une copie d'image. L'option -try_expire_worm_copy peut être utilisée pour tenter de supprimer une copie WORM du catalogue NetBackup. Même avec l'option -try_expire_worm_copy, le stockage peut empêcher la suppression de la copie. L'option -try_expire_worm_copy doit être utilisée avec prudence et seulement après le déverrouillage WORM des images par un administrateur de stockage.

Lorsque les copies sont verrouillées par WORM, elles ne peuvent plus être modifiées. Les copies, cependant, peuvent être supprimées une fois le délai de déverrouillage écoulé.

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.

OPÉRATIONS

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.

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

-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.

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. Vous ne pouvez pas faire expirer plus de 100 images en même temps avec l'option -Bidfile si l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

-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.

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

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.

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

-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)
    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)
    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.

    • _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.

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

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

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 nombre

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/jj/aa 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 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.

-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.

-extend_worm_locks

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.

-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 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.

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

-M serveur_principal [,...]

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 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é.

-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 nom

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.

Cette commande requiert bpnbat -login lorsque l'autorisation multi-personnes est activée pour l'opération d'expiration d'image. Une fois approuvé, le ticket créé modifie la date d'expiration de l'image. NetBackup 10.3 et les versions antérieures ne permettent pas d'exécuter cette opération avec cette commande si l'autorisation multi-personnes est activée. Consultez les informations relatives au code d'état NetBackup 9382 dans la documentation.

-refresh_worm_locks

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.

-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ées

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

-try_expire_worm_copy

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.

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\*