Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
nbstlutil — exécute l'utilitaire de politiques de cycle de vie du stockage de NetBackup
Synopsis
active [-lifecycle name] [-destination name] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
inactive -lifecycle name | -destination name [-reactivation_time mm/dd/yyyy hh:mm:ss | -duration hours] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
inactive -lifecycle name -destination name [-reactivation_time mm/dd/yyyy hh:mm:ss | -duration hours] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
list_import_conf [-l|-U|-b|-json| -json_compact] [-lifecycle nom] [-all_pending_images] [nom destination] [-target_domainnom]
cancel [-lifecycle name | -destination name] [-version number] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss] [-nowarn]
active | inactive | cancel -backupid valeur_id
diskspaceinfo [-stype type_serveur]
list [-l | -U | -b] [-rt I | IC | ICF | ICFS] [-lifecycle name [-version number] [-destination name] | -lifecycle_only | -backupid value | -jobid value] [-client name] [-mediaid value] [-mediaserver name] [-storageserver name] [-image_state value] | -copy_state value | -frag_state value | -image_incomplete | -image_inactive | -copy_incomplete | -copy_inactive] [-copy_type value] [-policy name] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
pendimplist
redo -backupid valeur -slpindex valeur
repllist [-l] [-U] [-sincetime valeur_temps]
report [-lifecycle nom [-version nombre]] [-client nom] [-mediaid valeur] [-mediaserver nom] [-storageserver nom]
stlilist [-l] [-U] [[[-lifecycle nom] [-destination nom]] | -backupid valeur] [-client nom] [-mediaid valeur] [-mediaserver nom] [-image_state valeur | -image_incomplete | -image_inactive] [-copy_type valeur]
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
La commande nbstlutil fournit aux utilisateurs un moyen d'intervenir dans des opérations de politique de cycle de vie du stockage. Voici les fonctions d'utilitaire :
- active
Active le traitement des opérations secondaires qui ont été interrompues dans le cadre d'une politique de cycle de vie du stockage. Les opérations pouvant être secondaires sont la duplication, la réplication et l'importation à partir d'un snapshot. Les images existantes et de création récente sont activées. Les options -lifecycle, -version, -destination -before, -after et -backupid identifient les opérations secondaires.
Si aucune des options -lifecycle et -destination n'est spécifiée, nbstlutil reprend le traitement de toutes les opérations secondaires pour toutes les politiques de cycle de vie du stockage.
Si seulement une politique de cycle de vie du stockage est spécifiée (-lifecycle), alors nbstlutil reprend le traitement de toutes les opérations secondaires pour cette politique de cycle de vie du stockage uniquement.
Si seulement un emplacement est spécifié, nbstlutil reprend le traitement de toutes les opérations secondaires qui utilisent l'emplacement spécifié pour toutes les politiques de cycle de vie du stockage.
Vous interrompez des opérations secondaires en exécutant la commande nbstlutil inactive.
- cancel
Annule de manière définitive le traitement de la politique de cycle de vie du stockage selon l'utilisation des options -lifecycle, -before, -after et -destination :
Si chacune des options -lifecycle et -destination est utilisée, nbstlutil annule de façon définitive le traitement pour les images existantes identifiées par les options.
Si aucune des options n'est utilisée, nbstlutil annule de manière définitive toutes les copies en attente pour toutes les images existantes gérées par les politiques de cycle de vie du stockage.
Si seulement une politique de cycle de vie du stockage est spécifiée (-lifecycle), nbstlutil annule de manière définitive toutes les copies en attente des images existantes qu'elle gère.
Si seulement un emplacement est spécifié, nbstlutil annule de manière définitive toutes les copies en attente destinées à cet emplacement pour toutes les politiques de cycle de vie du stockage.
Les nouvelles images créées après cette commande sont traitées normalement. Si toutes les copies en attente d'une image sont annulées, cette image est marquée comme terminée. Le nom d'emplacement est le nom d'une unité ou d'un groupe d'unités de stockage utilisé dans une politique de cycle de vie du stockage.
- diskspaceinfo
Rend compte de l'espace utilisé par tous les volumes de disque ou seulement les volumes de disque employés par le type spécifié.
- inactive
Interrompt le traitement des opérations secondaires dans une politique de cycle de vie du stockage, mais conserve les informations d'image de sorte que le traitement puisse reprendre plus tard. Les opérations secondaires correspondent à la duplication, la réplication et l'importation à partir de snapshots. Les images existantes et récemment créées sont interrompues. Les options -lifecycle, -before, -after et -destination identifient les opérations secondaires.
Si chacune des options -lifecycle et -destination est utilisée, nbstlutil interrompt le traitement pour les images existantes identifiées par la politique de cycle de vie du stockage et les options d'emplacement.
Si seulement une politique de cycle de vie du stockage est spécifiée (-lifecycle), nbstlutil interrompt toutes les opérations secondaires pour cette politique de cycle de vie du stockage.
Si seulement un emplacement est spécifié, nbstlutil interrompt toutes les opérations secondaires qui utilisent l'emplacement spécifié pour toutes les politiques de cycle de vie du stockage.
L'option inactive utilise une option reactivation qui vous permet de sélectionner le moment où le traitement des opérations secondaires inactives peut reprendre.
- list
Affiche le contenu d'une liste d'images Elle répertorie les images qui référencent une politique de cycle de vie du stockage (SLP). Vous pouvez spécifier le nom de la SLP pour filtrer la liste d'images. Cette option est principalement un outil de débogage mais le support peut utiliser les informations pour résoudre des problèmes.
- list_import_conf
Répertorie les images qui ont été répliquées vers un domaine cible, mais pour lesquelles le message de confirmation d'importation correspondant n'a pas été reçu. Par défaut, seules les images en attente de confirmation depuis plus longtemps que le seuil configuré sont répertoriées. Si l'option -all_pending_images est sélectionnée, toutes les images en attente sont répertoriées, quel que soit le temps d'attente.
- pendimplist
Liste toutes les images dans l'état d'importation en attente. Ce sont des événements de réplication reçus mais pas encore importés. Puisque la fonction d'importation d'image n'importe pas les images avec un temps de sauvegarde ultérieurement, ces images demeurent en suspens jusqu'à ce que le temps de sauvegarde soit écoulé.
- redo
Répète une opération SLP sur une image. Si une action ne faisant pas partie de NetBackup perd, endommage ou détruit une copie d'image, redo vous permet de la recréer. Si la copie source initiale n'est plus disponible, la commande redo échoue.
- report
Affiche un ensemble de copies inachevées des images gérées par cycle de vie.
- repllist
Affiche l'état pour les copies de réplication terminées.
- stlilist
Affiche l'état pour les copies inachevées des images gérées par cycle de vie.
OPTIONS
- -after mm/dd/yyyy hh:mm:ss
Restreint l'opération secondaire SLP aux sauvegardes démarrées après la date et l'heure spécifiées.
- -all_pending_images
Quel que soit le temps d'attente, toutes les images en attente sont répertoriées.
- -b
Liste uniquement les ID de sauvegarde.
- -backupid valeur
Spécifie l'ID de sauvegarde dont les images doivent être traitées.
- -before mm/dd/yyyy hh:mm:ss
Restreint l'opération secondaire de la SLP aux sauvegardes démarrées avant la date et heure spécifiée uniquement.
- -client nom
Restreint la liste des images pour les opérations de cycle de vie du stockage à celles figurant sur le client spécifié par nom.
- -copy_inactive valeur
Sélectionne les images dont une ou plusieurs copies sont marquées comme inactives dans la base de données NetBackup. Cette option est utilisée principalement pour le débogage.
- -copy_incomplete valeur
Sélectionne les images dont une ou plusieurs copies ne sont pas marquées comme ayant été dupliquées dans la base de données NetBackup. Cette option est utilisée pour le débogage.
- -copy_state valeur
Sélectionne les images avec l'état de copie spécifié dans la base de données NetBackup. Cette option est utilisée principalement pour le débogage. Les valeurs valides pour l'état de copie sont comme suit :
1 - NOT_STARTED (non démarré)
2 - IN_PROCESS (en cours)
3 - COMPLETE (terminé)
9 - NOT_STARTED | INACTIF (non démarré et inactif)
10 - IN_PROCESS | INACTIVE (en cours et inactif)
- -copy_type valeur
Sélectionne un filtre de type de copie pour les commandes de liste (list et stlilist). Les valeurs valides sont les suivantes :
0 - Sauvegarde
1 - Duplication
2 - Snapshot
3 - Duplication vers le serveur maître distant (réplique)
4 - Importation
- -destination nom
Sélectionne les images planifiées pour être dupliquées dans l'unité de stockage ou le groupe d'unités de stockage spécifié par la variable nom.
- -duration heures
Définit le laps de temps en heures entre la désactivation des images du cycle de vie et le démarrage de la réactivation. Le nombre d'heures doit être un entier (1,2,…). Cette option est utilisée avec l'option inactive uniquement.
- -frag_state valeur
Sélectionne les images avec l'état de fragment spécifié dans la base de données NetBackup. Cette option est utilisée pour le débogage. Les valeurs valides pour l'état frag sont comme suit :
1 - ACTIVE (actif)
2 - TO_BE_DELETED (à supprimer)
3 - ELIGIBLE_FOR_EXPIRATION (éligible pour expiration)
- -image_inactive valeur
Sélectionne les images marquées comme inactives dans la base de données NetBackup. Cette option est utilisée pour le débogage.
- -image_incomplete valeur
Sélectionne les images dont le cycle de vie n'est pas marqué comme terminé dans la base de données NetBackup. Cette option est utilisée pour le débogage.
- -image_state valeur
Sélectionne les images avec l'état d'image spécifié dans la base de données NetBackup. Cette option est utilisée principalement pour le débogage. Les valeurs valides pour l'état d'image sont comme suit :
1 - NOT_STARTED (non démarré)
2 - IN_PROCESS (en cours)
3 - COMPLETE (terminé)
9 - NOT_STARTED | INACTIF (non démarré et inactif)
10 - IN_PROCESS | INACTIVE (en cours et inactif)
- -jobid valeur
Restreint la liste de sortie des images pour des opérations de cycle de vie du stockage uniquement à celles que l'ID de travail spécifié valeur a créées. -jobid peut uniquement être utilisé avec l'option list.
- -json
Produit la sortie au format json lisible développé.
- -json_compact
Produit la sortie au format json compressé.
- -l
Produit une sortie analysable condensée de la liste.
- -lifecycle nom
Sélectionne la liste d'images gérée par le cycle de vie uniquement.
- -mediaid valeur
Restreint la liste des images pour les opérations de cycle de vie du stockage à celles figurant sur l'ID du média spécifié par valeur.
- -mediaserver nom
Restreint la liste des images pour les opérations de cycle de vie du stockage seulement à celles sur le média que value spécifie.
- -nowarn
Ignore le message d'avertissement interactif.
- -policy nom
Restreint le traitement des images à celles créées par la politique de sauvegarde spécifiée (nom). -policy peut uniquement être utilisée avec l'option list.
- -reactivation_time mm/dd/yyyy hh:mm:ss
Définit l'heure au format mm/dd/yyyy hh:mm:ss lorsque vous voulez que les copies ou les SLP que vous désactivez soient réactivées. L'option inactive peut utiliser cette option ou l'option -duration pour réactiver les copies ou les SLP désactivées.
- -rt I | IC | ICF | ICFS
Sélectionne les types d'enregistrements à répertorier. Les valeurs possibles sont les suivantes :
I : répertorie uniquement les enregistrements d'image.
IC : répertorie les enregistrements d'image et de copie.
ICF : répertorie les enregistrements d'image, de copie et de fragment.
ICFS - répertorie les enregistrements d'image, de copie, de fragment et de snapshot.
- -sincetime valeur_temps
Affiche l'état des copies de réplication terminées à partir du timeval spécifié au présent. Cette option est utilisée avec la fonction repllist.
- -slpindex valeur
Spécifie l'opération SLP à répéter. -slpindex peut uniquement être utilisé avec l'opération redo.
- -storageserver nom
Restreint la liste des images pour les opérations de cycle de vie du stockage à celles figurant sur le média spécifié par nom.
- -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 possibles sont
amazon
,att
, azure etrackspace
. Les valeurs stype de cloud reflètent le fournisseur du stockage en cloud. Les valeurs stype du stockage en cloud peuvent également 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 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.
- -target_domain nom
Sélectionne pour la sortie uniquement les enregistrements qui concernent le domaine cible nommé.
- -U
Produit une sortie lisible par l'utilisateur de la liste.
- -version nombre
Restreint la sortie de liste uniquement aux images qui sont contrôlées par la version SLP spécifiée. Elle doit être utilisée avec l'option -lifecycle.
EXEMPLES
Exemple 1 - Affiche les informations à propos d'une image de processus de cycle de vie.
# nbstlutil -list -backupid dollhouse_1287744229 -U Image: Master Server : dollhouse Backup ID : dollhouse_1287744229 Client : dollhouse Backup Time : 1287744229 (Fri Aug 24 16:13:49 2012) Policy : pol-slp-2bkup-70-level Client Type : 13 Schedule Type : 0 Storage Lifecycle Policy : slp-pol-2backup-70-level Storage Lifecycle State : 2 (IN-PROCESS) Time In Process : 1287744327 (Fri Aug 24 16:15:27 2012) Data Classification ID : 85AA96DF9781453289A41745DD240A48 (Platinum) Version Number : 0 OriginMasterServer : (none specified) OriginMasterServerID : 00000000-0000-0000-0000-000000000000 Import From Replica Time : 0 (Thu Jan 01 05:30:00 1970) Required Expiration Date : 0 (Thu Jan 01 05:30:00 1970) Created Date Time : 1287744297 (Fri Aug 24 16:14:57 2012) Copy: Master Server : dollhouse Backup ID : dollhouse_1287744229 Copy Number : 1 Copy Type : 0 Expire Time : 1288953829 (Fri Nov 02 16:13:49 2012) Expire LC Time : 1288953829 (Fri Nov 02 16:13:49 2012) Try To Keep Time : 1288953829 (Fri Nov 02 16:13:49 2012) Residence : PDDE-Stu Copy State : 2 (IN-PROCESS) Job ID : 0 Retention Type : 0 (FIXED) MPX State : 0 (FALSE) Source : 0 Destination ID : *NONE* Last Retry Time : 0 Fragment: Master Server : dollhouse Backup ID : dollhouse_1287744229 Copy Number : 1 Fragment Number : 1 Resume Count : 0 Media ID : @aaaad Media Server : dollhouse Storage Server : (none specified) Media Type : 0 (DISK) Media Sub-Type : 6 (STSDYNAMIC) Fragment State : 1 (ACTIVE) Fragment Size : 5120 Delete Header : 1 Fragment ID : @aaaad The output displays "(none specified)" for blank fields.
Exemple 2 - Affichez le contenu d'une liste d'image dans le format analysable condensé.
# nbstlutil list -l V7.0 I abc.example.com abc_1225727 abc 1225727 Pol_SLPTest1 0 0 SLP_Test1 2 \ 1225727 *NULL* V7.0 C abc.example.com abc_1225727 1 2147483 1225735 AdvDisk1 3 0 0 0 0 V7.0 F abc.example.com abc_1225727 1 1 0 @ab abc.example.com *NULL* 0 6 1 \ 32768 1 @ab V7.0 C abc.example.com abc_1225727 2 2147483 1225735 AdvDisk2 3 0 0 0 0
Exemple 3 - Affichez les informations pour une image de cycle de vie inachevée dans la sortie lisible par l'utilisateur.
# nbstlutil stlilist -U Image abc_1225727928 for Lifecycle SLP_Test1 is IN_PROCESS Copy to abc-tape1 is IN_PROCESS Copy to AdvDisk3 is NOT_STARTED