Guide de référence des commandes NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpimagelist — produit un rapport d'état des images ou du média amovible de NetBackup
Synopsis
[-media] [-l | -L | -U | -idonly] [-tape] [-d date] [-e date] [-hoursago hours] [-keyword "keyword phrase"] [-client client_name] [-server server_name] [-backupid backup_id | -image_dtemode Off|On] [-option INCLUDE_PRE_IMPORT | INCLUDE_TIR | LIST_COMPLETE_COPIES | LIST_OLD_TO_NEW | ONLY_PRE_IMPORT | ONLY_TIR | INCLUDE_DELETE_PENDING] [-policy policy_name] [-pt policy_type] [-rl retention_level] [-sl sched_label] [-st sched_type] [-class_id class_guid] [-stl_complete] [-stl_incomplete] [-stl_name storage_lifecycle_name] [-M master_server,...] [-inter-domain] [-v] [-oracle_copilot_ir][-copy_dtemode Off|On] [-hierarchical_dtemode Off|On]
-changelog [-L | -json | -json_compact] [-min_changelog_keykey] [-d mm/dd/yyyy hh:mm:ss] [-e mm/dd/yyyy hh:mm:ss] [-new_images] [-updated_images] [-deleted_images]
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
bpimagelist utilise un format spécifié pour produire des rapports sur les images de catalogue ou le média amovible dont les attributs correspondent à ceux qui sont envoyés à partir des options de commande. bpimagelist produit un rapport sur le média amovible si l'option -média est dans la ligne de commande. Sinon, cette fonction produit des rapports sur les images de catalogue.
L'option bpimagelist -changelog consigne des enregistrements dans le journal des modifications d'images. Vous pouvez filtrer seulement les nouvelles images, les images mises à jour ou les images supprimées du rapport.
Elle enregistre les informations du journal de débogage sur le répertoire suivant :
On UNIX systems: /usr/openv/netbackup/logs/admin
On Windows systems: install_path\NetBackup\logs\admin
Vous pouvez utiliser les informations se trouvant dans ce répertoire à des fins de dépannage.
La sortie de la commande bpimagelist est affichée au format standard.
Les utilisateurs autorisés peuvent exécuter cette commande.
Pour plus d'informations sur l'autorisation NetBackup, consultez le Guide de sécurité et de chiffrement NetBackup.
Remarque :
Pour la fonction d'accélérateur NetBackup, bpimagelist indique la quantité de données qui ont été transférées via le réseau pour chaque sauvegarde. Vous pouvez également configurer la commande pour afficher les données transférées dans le champ qui affiche normalement la taille de l'image de sauvegarde de l'accélérateur. Pour plus de détails, consultez les rubriques d'accélérateur dans le Volume I du Guide de l'administrateur de NetBackup, le Guide de l'administrateur NetBackup pour VMware et le Guide de l'administrateur NetBackup pour NDMP.
OPTIONS
Les options de bpimagelist sont les suivantes :
- -backupid id_sauvegarde
Spécifie un ID de sauvegarde à utiliser pour rechercher les images applicables (s'applique seulement à la liste d'images).
- -changelog
Signale les enregistrements du journal des modifications d'images.
- -class_id guid_classe
Spécifie un identifiant de classe à utiliser pour sélectionner des images. L'identifiant représente un GUID (Global Unique Identifier, identificateur global unique). La commande bpimagelist signale uniquement les images portant l'identifiant de classe spécifié.
- -client client_name
Spécifie un nom de client à utiliser pour trouver des sauvegardes ou des archives à lister. Le nom de client que bpimagelist recherche est sensible à la casse. Par exemple, bpimagelist affiche des images de
client
,cLiEnT
etCLIENT
. Par défaut, la commande bpimagelist recherche tous les clients.- -copy_dtemode Off|On
Le mode DTE de la copie est défini sur On si le DTE a été activé pour le travail de transfert de données qui a créé cette copie. Utilisez la commande bpimagelist -copy_dtemode Off|On pour afficher et filtrer les images en fonction du mode DTE de la copie.
- -d mm/dd/yy hh:mm:ss, -e mm/dd/yy hh:mm:ss
Spécifie la date de début et la date de fin de la plage de dates de la liste. Si ces valeurs ne sont pas incluses sur la ligne de commande, les valeurs par défaut sont comme suit :
La valeur par défaut -d correspond à la veille à minuit.
La valeur par défaut -e correspond à la date et l'heure actuelles.
Le format complet de la date de début et de la date de fin est le suivant :
-d spécifie une date et une heure de début pour les listes. La liste de sortie affiche seulement les images dans les sauvegardes ou les archives (ou les données dans le journal des modifications pour l'option -changelog) produites à la date et à l'heure spécifiées ou après.
La commande -e spécifie une date et une heure de fin pour la création de listes. La liste de sortie affiche seulement les fichiers dans les sauvegardes ou les archives (ou les données dans le journal des modifications pour l'option -changelog) produites à la date et à l'heure spécifiées ou avant. Utilisez le même format que celui de la date de début.
La plage de dates autorisées s'étale du 01/01/1970 à 00:00:00 au 19/01/2038 à 03:14:07.
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 section "À propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
- -hierarchical_dtemode ON|OFF
Le mode DTE hiérarchique de la copie est défini sur On si le mode DTE hiérarchique de la copie de l'image source a été défini sur On et si le DTE a été activé pour le travail de transfert de données qui a créé cette copie. Utilisez la commande bpimagelist -hierarchical_dtemode Off|On pour afficher et filtrer les images en fonction du mode DTE hiérarchique de la copie.
- -hoursago hours
Inclut les images qui ont été écrites de nombreuses heures en arrière. Cette option est équivalente à une spécification de l'heure de début (-d) par rapport à l'heure actuelle moins un certain nombre d'heures. Ce nombre doit être supérieur ou égal à 1.
- -idonly
Produit une liste abrégée. Pour une liste d'images, le contenu est l'heure de création, l'ID de sauvegarde et le type de planification de chaque image. Par exemple, si le critère d'une liste est une plage de temps, la liste d'images contient ce qui suit : Pour chaque image créée dans cette fenêtre, uniquement l'heure de création, l'ID de sauvegarde et le type de planification de l'image.
Pour une liste de médias, le contenu est uniquement les ID des médias applicables. Par exemple, si le critère d'une liste est une plage de temps, la liste contient uniquement les ID de média écrits dans cette fenêtre.
Les options suivantes représentent les critères de sélection d'images ou de médias du rapport. Lorsque ces options s'appliquent à des images, il est possible remplacer les médias si le rapport est un rapport de médias.
- -image_dtemode Off|On
Si le DTE est activé pour une sauvegarde, le mode DTE de cette image de sauvegarde est défini sur On. Utilisez la commande bpimagelist -image_dtemode Off|On pour afficher et filtrer les images en fonction du mode DTE.
- -inter-domain
Affiche les copies d'espace réservé des images répliquées à partir de la source et des images répliquées en attente d'importation vers la cible.
- -json
Imprime les données au format json sur plusieurs lignes.
- -json_compact
Imprime les données au format json sur une seule ligne.
- -keyword "expression_mot_clé"
Spécifie une phrase de mot-clé utilisée par NetBackup pour effectuer une recherche. L'expression doit correspondre à celle associée à l'image. Par exemple, l'option -k de la commande bpbackup ou bparchive associe un mot-clé à l'image au moment de sa création.
- -L
Génère le rapport au format long. Par exemple, pour le rapport Liste des médias, le rapport liste les informations pour chaque ID de média comme une série de paires attribute = value. La valeur de densité est fournie sous la forme d'un terme descriptif et d'un nombre. Le mode long est la condition par défaut.
- -l
Génère le rapport en mode court, ce qui produit une liste courte. Cette option sert aux scripts ou aux programmes qui convertissent le contenu des listes en un rapport personnalisé et formaté.
- -M serveur_maître,...
Spécifie une liste d'un ou plusieurs 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 bpimagelist. En cas d'erreur sur un serveur maître quelconque, le processus s'interrompt sur ce serveur.
Le rapport est le composé des informations que tous les serveurs maîtres de cette liste renvoient. bpimagelist questionne chacun de ces serveurs maîtres. Les serveurs maîtres renvoient les informations des images ou des médias provenant des catalogues d'image. Chaque serveur maître doit autoriser l'accès au système ayant émis la commande bpimagelist.
Le paramètre par défaut est le serveur maître pour le système exécutant la commande bpimagelist.
- -media
Spécifie les rapports de listes sur les médias amovibles basés sur un ensemble de critères. Si -media n'est pas dans la ligne de commande, le rapport porte sur des images, et non sur des médias.
- -min_changelog_key key
Imprime les enregistrements avec la clé de journal spécifiée et plus récents. Les nouvelles entrées du journal des modifications ont des valeurs de clé de journal des modifications plus grandes.
- [-new_images] [-updated_images] [-deleted_images]
Limite le rapport de journal des modifications aux images nouvelles, mises à jour ou supprimées. Par défaut, toutes les images du journal des modifications sont signalées.
- -option nom_option,...
Spécifie un ou plusieurs critères pour rechercher des images à lister. nom_option est l'une des chaînes de caractères suivantes, en majuscules ou en minuscules :
INCLUDE_PRE_IMPORT - Signale les images ayant terminé la phase 1 d'une importation.
INCLUDE_TIR - Signale les images que les sauvegardes de récupération d'image réelle ont créées.
LIST_COMPLETE_COPIES - Ne signale pas les fragments d'une copie en double qui est toujours en cours de traitement.
LIST_OLD_TO_NEW - Liste les images de la plus ancienne à la plus récente.
NO_VALIDATION - Signale les images même si elles n'ont pas été validées, soit parce qu'elles sont toujours en cours de traitement, soit en raison d'un échec du travail.
ONLY_PRE_IMPORT - Signale uniquement les images ayant terminé la phase 1 d'une importation.
ONLY_TIR - Signale uniquement les images créées par les sauvegardes de récupération d'image réelle.
INCLUDE_DELETE_PENDING - Signale les copies d'image, y compris celles qui sont définies pour expirer après leur suppression du stockage.
Par défaut, aucune restriction ne s'applique aux images sélectionnées.
- -oracle_copilot_ir
Les recherches et les affichages des images qui peuvent être utilisées pour la récupération instantanée par le Copilote Oracle.
- -policy nom
Recherche des sauvegardes à importer dans la politique spécifiée. La valeur par défaut représente toutes les politiques.
- -pt type_politique
Spécifie un type de politique. Par défaut, bpimagelist recherche tous les types de politique.
Le type_politique correspond à l'une des chaînes de caractères suivantes :
BigData DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup FlashBackup-Windows Hyper-V Informix-On-BAR LotusNotes MS-Exchange-Server MS-SharePoint MS-SQL-Server MS-Windows NDMP Oracle SAP Split-Mirror Standard Sybase Universal-share Vault VMware
- -rl niveau_conservation
Spécifie le niveau de conservation retention_level. Leretention_level est un entier compris entre 0 et 100. Par défaut,bpimagelist recherche tous les niveaux de conservation.
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.
- -server nom_serveur
Spécifie le nom d'un serveur NetBackup ou ALL. Si -server spécifie un nom de serveur, les images ou les médias du rapport sont seulement ceux ou celles qui résident sur ce serveur. Les images répondent également aux autres critères que bpimagelist spécifie. Par exemple, si -hoursago 2 est spécifié, les médias doivent contenir une image qui a été créée au cours des deux dernières heures.
La demande est dirigée au catalogue d'images qui réside sur le serveur maître local. Le serveur maître doit permettre l'accès par le système exécutant bpimagelist.
Le paramètre par défaut est de signaler tous les médias dans le catalogue d'images sur le serveur maître local, qui est équivalent à la spécification -server ALL.
- -sl étiquette_planification
Spécifie une étiquette de planification pour la sélection d'images. La valeur par défaut représente toutes les planifications.
- -st type_planification
Spécifie le type de planification de la sélection d'image. La valeur par défaut représente un type de planification. Les valeurs valides sont les suivantes :
FULL (sauvegarde complète)
INCR (sauvegarde différentielle incrémentielle)
CINC (sauvegarde cumulative incrémentielle)
UBAK (sauvegarde utilisateur)
UARC (archive utilisateur)
NOT_ARCHIVE (toutes les sauvegardes à l'exception de l'archive utilisateur)
- -stl_complete
Signale seulement les images dont le cycle de vie de stockage est complètement terminé. Impossible d'utiliser cette option avec l'option stl_incomplete.
- -stl_incomplete
Signale seulement les images dont le cycle de vie de stockage n'est pas complètement terminé. Impossible d'utiliser cette option avec l'option stl_complete.
- -stl_name nom_cycle_vie_stockage
Spécifie un nom de cycle de vie de stockage à utiliser quand vous sélectionnez des images. Seules les images avec le nom de cycle de vie de stockage spécifié sont sélectionnées.
- -tape
Affiche dans la liste seulement les images qui ont au moins un fragment qui réside sur des médias amovibles ou sur bande. Les éventuels fragments sur disque rencontrés dans ces images sont ignorés. Si une image contient des fragments à la fois sur la bande et sur le disque, cette option affiche uniquement les fragments de la bande.
- -U
Génère le rapport dans le mode utilisateur. Le rapport est formaté. Il inclut une bannière qui liste les titres de colonne. L'état est un terme descriptif au lieu d'un nombre.
- -v
Sélectionne le mode détaillé. Cette option fait que bpimagelist consigne des informations supplémentaires pour le débogage. Les informations entrent quotidiennement dans le journal de débogage d'administration NetBackup. Cette option est utile uniquement avec la fonction de débogage de journal (à savoir : lorsque le répertoire suivant est défini) :
Systèmes d'exploitation UNIX : /usr/openv/netbackup/logs/admin
install_path\NetBackup\logs\admin
EXEMPLES
Exemple 1 - Affichage de la dernière fois où les ID de média disponibles pour le serveur ont eu une image de sauvegarde pendant le temps spécifié :
# bpimagelist -media -d 01/05/2012 18:00:46 -e 01/06/2012 23:59:59 -U Media ID Last Written Server -------- ---------------- ---------- IBM000 01/06/2012 01:06 hatt AEK800 01/06/2012 03:01 hatt C0015 01/06/2012 02:01 hatt 143191 01/05/2012 23:00 hatt
Exemple 2 - Liste de toutes les images enregistrées aujourd'hui :
Exemple 2 - Liste de toutes les images enregistrées aujourd'hui - Colonnes supplémentaires non affichées :
bpimagelist -U Backed Up Expires Files KB C ICA Sched Type On Hold Policy Image DTE Mode ---------------- ---------- ----- --- - --- ----------- ------- ------- -------------- 01/03/2022 13:14 01/17/2022 3 416 N N Full Backup 0 test_fs Off 01/03/2022 13:13 01/17/2022 3 416 N N Full Backup 0 test_fs On
Exemple 3 - Liste de toutes les images enregistrées aujourd'hui que le cycle de vie du stockage n'a pas totalement traitées :
# bpimagelist -U -stl_incomplete -idonly Time: 12/6/2011 1:03:46 PM ID: escape_1323198226 FULL (0) Time: 12/6/2011 12:48:22 PM ID: gordito19_1323197302 INCR (1) Time: 12/6/2011 1:02:42 PM ID: louisebl8vm1_1323198162 FULL (0) Time: 12/6/2011 1:03:28 PM ID: monterrey_1323198208 FULL (0) Time: 12/6/2011 1:03:10 PM ID: oprahbl14vm3_1323198190 FULL (0) Time: 12/6/2011 1:03:11 PM ID: oprahbl14vm4_1323198191 FULL (0) Time: 12/6/2011 1:03:12 PM ID: oprahbl15vm3_1323198192 FULL (0) Time: 12/6/2011 1:03:17 PM ID: oprahbl15vm4_1323198197 FULL (0) Time: 12/6/2011 1:02:22 PM ID: oprahbl8vm5_1323198142 FULL (0) Time: 12/6/2011 1:02:41 PM ID: thelmabl1vm1_1323198161 FULL (0) Time: 12/6/2011 1:02:54 PM ID: thelmabl1vm2_1323198174 FULL (0) Time: 12/6/2011 1:03:01 PM ID: thelmabl2vm1_1323198181 FULL (0)
Exemple 4 - Liste de toutes les images inachevées qui ont été enregistrées aujourd'hui pour la politique de pem_tort
:
# bpimagelist -U -stl_incomplete -policy pem_tort Backed Up Expires Files KB C ICA Sched Type ... Policy ---------------- ---------- ----- ------- - --- ------------ --------- 12/06/2011 13:03 12/12/2011 86 1632 N Y Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 12 12512 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 5 32 N N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 3742 95936 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 3762 95936 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 8 64 N N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 9 32 N N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 5041 223104 N Y Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 6 32 N N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 3559 95808 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 5 32 N N Full Backup ... pem_tort
Exemple 5 - Listez les entrées du journal des modifications nouvelles et mises à jour, enregistrées depuis le 2 mai 2012 :
# bpimagelist -changelog -new_images -updated_images -d 05/02/2012 10:18:00 -json Image Change Log Key: 2 Backup ID: jumpmanvm2_1335967123 Client Type: Standard (0) Image Change Log Oper. Id: Updated (2) Image Change Log Time: Wed 02 May 2012 10:39:09 AM CDT (1335973149)
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/log.mmddyy /usr/openv/netbackup/db/images
Systèmes Windows :
install_path\NetBackup\logs\admin\log.mmddyyinstall_path\NetBackup\db\images