Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bplist — répertorie les fichiers sauvegardés et archivés sur tous les hôtes NetBackup
Synopsis
[-A | -B] [-C client] [-S master_server] [-k policy] [-t policy_type] [-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-flops options] [-Listseconds] [-T] [-Translateownership] [-unix_files] [-nt_files] [-s date] [-e date] [-I] [-PI] [-keyword keyword_phrase] [filename] [-Listpolicy] [-nboptimized | -nbnormal]
Sur les systèmes UNIX, le chemin d'accès à cette commande est /usr/openv/netbackup/bin/.
Sur les systèmes Windows, le chemin de répertoire vers cette commande est install_path\NetBackup\bin\
DESCRIPTION
La commande bplist affiche une liste de fichiers précédemment archivés ou sauvegardés selon les options spécifiées. Vous pouvez choisir le fichier ou le répertoire et la période que vous voulez que la liste couvre. Des répertoires peuvent être périodiquement affichés à une profondeur spécifiée. bplist affiche uniquement les fichiers auxquels vous avez un accès de lecture. La commande ne donne la liste des fichiers que lorsque c'est le compte administrateur qui effectue la sauvegarde utilisateur.
Vous devez posséder ou avoir un accès en lecture aux répertoires des chemins d'accès au fichier. Vous pouvez lister les fichiers qui ont été sauvegardés ou archivés par le client seulement si l'administrateur de NetBackup vous a validés dans ce sens.
Si vous créez le répertoire suivant avec l'accès en écriture publique, bplist crée un fichier journal de débogage dans ce répertoire que vous pouvez utiliser pour le dépannage :
Systèmes UNIX : usr/openv/netbackup/logs/bplist/
Systèmes Windows : install_path\NetBackup\logs\bplist\
OPTIONS
- -A | -B
Spécifie la production de listes à partir des archives (-A) ou des sauvegardes (-B). Par défaut, la valeur est -B.
- -b | -c | -u
Spécifie une autre valeur date-heure à utiliser pour l'impression avec l'option -l :
-b affiche la date et l'heure de sauvegarde de chaque fichier.
-c affiche la date et l'heure de la dernière modification d'inode (systèmes UNIX) ou la date et l'heure de création (systèmes Windows) pour chaque fichier.
-u affiche la date et l'heure du dernier accès à chaque fichier.
Le paramètre par défaut est d'afficher l'heure de la dernière modification de chaque fichier.
- -C client
Spécifie un nom de client à utiliser pour trouver des sauvegardes ou des archives à répertorier. Ce nom doit être le même que celui de la configuration NetBackup. Par défaut, il s'agit du nom du client en cours.
- -F
Spécifie que dans la sortie de la liste, les liens symboliques (qui s'appliquent uniquement aux clients UNIX) se terminent avec un caractère de fin @ et les fichiers exécutables avec un caractère de fin *.
- filename
Nomme le fichier ou le répertoire à lister. Tous les fichiers ou répertoires spécifiés doivent s'afficher à la fin, à la suite de toutes les autres options. Si vous ne spécifiez pas de chemin d'accès, le répertoire de travail actuel est celui utilisé par défaut.
Pour les systèmes d'exploitation Windows, utilisez une majuscule pour la lettre du lecteur. Par exemple :
C:\NetBackup\log1
Pour les répertoires, si vous n'utilisez pas l'option -R, incluez le séparateur à la fin du chemin d'accès comme suit :
Systèmes d'exploitation UNIX :
bplist -l "/home/user1/*"
Systèmes Windows :
bplist -l "D:\WS_FTP.LOG\*"
Si vous utilisez le métacaractère d'astérisque (*), utilisez les guillemets autour du nom de fichier pour que la commande fonctionne correctement.
- -flops options
Répertorie les fichiers NetBackup.
- -I
Spécifie une recherche qui n'est pas sensible à la casse. La casse n'est pas tenue en compte pour la comparaison de noms (par exemple, Cat est identique à cat).
- -k politique
Nomme la politique à rechercher pour créer la liste. Si ce paramètre n'est pas spécifié, toutes les politiques sont recherchées.
- -keyword keyword_phrase
Spécifie une expression de mot-clé utilisée par NetBackup lors de la recherche de sauvegardes ou d'archives permettant de restaurer des fichiers. L'expression doit correspondre à celle associée précédemment à la sauvegarde ou à l'archive par l'option -k de la commande bpbackup ou bparchive.
Vous pouvez utiliser cette option à la place des autres options de restauration ou associez-la à ces dernières. Cela permet de restaurer plus facilement les sauvegardes et les archives. Utilisez les métacaractères suivants pour simplifier la mise en correspondance des mots-clés ou des parties de mots-clés dans l'expression :
* correspond à n'importe quelle chaîne de caractères.
? correspond à tout caractère unique.
[ ] correspond à l'une des séquences de caractères spécifiée entre crochets.
[ - ] correspond à une plage de caractères, séparée par un tiret "-".
La longueur maximale de l'expression de mot-clé est de 128 caractères. Tous les caractères imprimables sont acceptés, y compris l'espace (" ") et le point (".").
L'expression doit être entourée par des guillemets ("...") ou par des apostrophes ('…').
La chaîne NULL (vide) représente l'expression de mot-clé par défaut.
Remarque :
L'expression de mot-clé est ignorée lorsque vous utilisez les types de politique suivants : DB2, Informix-On-BAR, Oracle, SAP, MS-SQL-Server, Sybase.
- -l
Sur les systèmes Windows, -l affiche les détails de fichier.
Sur les systèmes UNIX, -l liste les détails de fichier suivants au format long : mode, propriétaire, groupe, taille en octets et heure de la dernière modification de chaque fichier (consultez la section d'exemples). La liste affiche le mode de chaque fichier sous forme de dix caractères représentant les autorisations de fichier UNIX standard. Le premier caractère est l'un des caractères suivants :
d (spécifie un répertoire)
l (spécifie un lien)
m (spécifie un fichier qui a été migré par Veritas Storage Migrator pour UNIX ou Veritas Data Lifecycle Manager)
- (spécifie un fichier)
Les neuf caractères suivants affichent les trois jeux d'autorisations. Le premier jeu affiche les autorisations du propriétaire, le jeu suivant affiche les autorisations du groupe d'utilisateurs et le dernier jeu affiche les autorisations pour tous les autres utilisateurs. Chacun jeu spécifie les trois autorisations, de lecture, d'écriture et d'exécution, suivantes :
r = le fichier est accessible en lecture
w = le fichier est accessible en écriture
x = le fichier est exécutable
- = l'autorisation indiquée n'est pas accordée
- -Listpolicy
Inclut le nom de type de planification et le nom de la politique dans la sortie de commande.
- -Listseconds
Spécifie que l'horodatage en secondes soit utilisé lorsque l'option -l est utilisée.
- -nboptimized
Spécifie le filtre de commande de sortie afin d'afficher uniquement les images Windows sauvegardées avec l'indicateur optimisé pour la déduplication Windows.
- -nbnormal
Spécifie le filtre de commande de sortie afin d'afficher uniquement les images Windows non sauvegardées avec l'indicateur optimisé pour la déduplication Windows.
- -nt_files
Liste les fichiers et les répertoires au format Windows. Cette option s'applique uniquement aux systèmes Windows. Par exemple :
C:\users\test
- -PI
Spécifie une recherche indépendante du chemin d'accès, ainsi NetBackup recherche un fichier ou un répertoire spécifié sans prendre en compte le chemin d'accès. Par exemple, un fichier portant le nom test est présent dans les trois répertoires suivants. La recherche du mot test trouve les trois instances du fichier :
Systèmes UNIX :
/tmp/junk/test /abc/123/xxx/test /abc/123/xxx/yyy/zzz/test
Systèmes Windows :
\tmp\junk\test \abc\123\xxx\test \abc\123\xxx\yyy\zzz\test
- -r
Sur les systèmes Windows, -r liste les images du disque qui ont été sauvegardées. Par défaut, les systèmes de fichiers sont répertoriés.
Sur les systèmes UNIX, -r liste les partitions brutes sauvegardées. Par défaut, les systèmes de fichiers sont répertoriés.
- -R [n]
Liste périodiquement les sous-répertoires qui sont détectés à une profondeur de n. La valeur n par défaut est 999.
- -s date, -e date
Spécifie la date de début (-s) et la date de fin (-e) de la liste.
-s spécifie une date et une heure de début pour les listes. La liste générée affiche uniquement les images se trouvant dans les sauvegardes ou les archivages survenues aux date et heure spécifiées ou ultérieurement.
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 "À propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
La plage des dates valides s'étale entre le 01/01/1970 0:00:00 et le 19/01/2038 3:14:07. Le paramètre par défaut correspond à la date en cours moins six mois.
La commande -e spécifie une date et une heure de fin pour la création de listes. La liste générée affiche uniquement les fichiers provenant des sauvegardes ou des archivages survenues aux date et heure spécifiées ou précédemment. Utilisez le même format pour la date et l'heure de début. Par défaut, il s'agit de la date et de l'heure en cours.
- -S serveur_maître
Systèmes d'exploitation UNIX : -s spécifie le nom du serveur NetBackup. Le paramètre par défaut est la première entrée de serveur (SERVER) trouvée dans le fichier
/usr/openv/netbackup/bp.conf
.Systèmes Windows : -s spécifie le nom du serveur NetBackup. La valeur par défaut correspond au serveur spécifié en tant que serveur en cours dans l'onglet Serveurs de la boîte de dialogue Spécifier les ordinateurs NetBackup. Pour afficher cette boîte de dialogue, démarrez l'interface Sauvegarde, archivage et restauration sur le client. Cliquez ensuite sur Spécifier les ordinateurs NetBackup dans le menu Fichier.
- -t type_politique
Spécifie l'un des numéros suivants selon le type de politique. La valeur par défaut est 0 (zéro) pour tous les clients, sauf pour les clients Windows, pour qui le paramètre par défaut est 13.
0 = Standard
4 = Oracle
6 = Informix ON-BAR
7 = Sybase
8 = Microsoft SharePoint
11 = DataTools-SQL-BackTrack
13 = MS-Windows
15 = Microsoft SQL Server
16 = MS-Exchange-Server
17 = SAP
18 = DB2
19 = NDMP
20 = FlashBackup
21 = Split-Mirror
25 = Lotus Notes
29 = FlashBackup-Windows
35 = NBU-Catalog
39 = Enterprise-Vault
40 = VMware
41 = Hyper-V
44= BigData
- -T
Liste les répertoires dans les sauvegardes d'images réelles. Par défaut, les sauvegardes d'images non réelles sont listées.
Remarque :
Les informations de récupération d'image réelle (TIR) n'apparaissent pas pour des sauvegardes complètes synthétiques, même si ces informations sont utilisées pour des sauvegardes complètes synthétiques.
- -Translateownership
Sur les systèmes Linux pour les sauvegardes Linux VMware uniquement : traduit l'ID d'utilisateur (UID) et l'ID de groupe (GID) de la personne détenant les fichiers vers le nom d'utilisateur et le nom de groupe. Par défaut pour les sauvegardes Linux VMware, bplist affiche l'UID et le GID.
Le client sur lequel vous exécutez la commande bplist et l'option -Translateownership doit être le même que le client que vous spécifiez avec l'option -C.
Sur les systèmes d'exploitation autres que Linux, cette option est sans effet.
- -unix_files
Liste les fichiers et les répertoires au format UNIX. Cette option s'applique seulement à UNIX. Par exemple :
/C/users/test
EXEMPLES
Exemple 1 - Liste récursive au format long des fichiers sauvegardés dans /home/usr1
(UNIX) ou D:\WS_RTP.LOG
(Windows).
Pour les systèmes d'exploitation UNIX :
# bplist -l -R /home/usr1 lrwxrwxrwx usr1;usr@ eng;None 0 Apr 28 12:25 /home/usr1/dirlink drwxr-xr-x usr1;usr@ eng;None 0 Apr 04 07:48 /home/usr1/testdir drwxr-x--- usr1;usr@ eng;None 0 Apr 04 07:49 /home/usr1/dir -rwxr----- usr1;usr@ eng;None 1002 Apr 02 09:59 /home/usr1/dir/file lrwxrwxrwx usr1;usr@ eng;None 0 Apr 04 07:49 /home/usr1/dir/link
Sur les systèmes Windows :
# bplist -l -R D:\WS_FTP.LOG -rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG -rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG -rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG
Exemple 2 - Liste des fichiers sauvegardés et associés à l'ensemble ou une partie de l'expression de mot clé "MyHomeDirectory".
UNIX: # bplist -keyword "*MyHomeDirectory*" -l /home/kwc/
Windows: # bplist -keyword "*MyHomeDirectory*" -l C:\home\kwc\
Exemple 3 - Liste des fichiers archivés et associés à l'ensemble ou une partie de l'expression de mot clé "MyHomeDirectory".
UNIX: # bplist -A -keyword "*MyHomeDirectory*" -l /home/kwc/
Windows: # bplist -A -keyword "*MyHomeDirectory*" -l C:\home\kwc\
Exemple 4 - Liste récursive et détaillée de la sortie de bplist sur un serveur maître Windows depuis un client Windows. Entrez la commande suivante pour lister les fichiers sauvegardés sur le lecteur D du slater de client Windows et associés à l'ensemble ou une partie du mot-clé "Win NT" :
# bplist -keyword "*Win NT*" -C slater -R -l C:\client_data_2 drwx------ root;usr@ root;None 0 Aug 28 17 C:\client_data_2\ -rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt drwx------ root;usr@ root;None 0 Aug 28 17 C:\client_data_2\ -rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt
La colonne d'utilisateur (racine; usr@
) pour les images de Windows affiche l'utilisateur qui a sauvegardé le fichier et le domaine owner@domain, séparés par un point-virgule. La colonne de groupe (racine;Aucun
) pour les images de Windows est le groupe qui a sauvegardé le fichier et le domaine group@domain, séparés par un point-virgule.
Exemple 5 - Répertorier les fichiers d'une sauvegarde Linux VMware et traduire l'UID et le GID vers le nom d'utilisateur et le nom de groupe :
# bplist -Translateownership -S host0.example.com -C client0.example.com -R 1 -l -t 40 -E -unix_files -b /user1_home drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/ drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/user_data/ drwxr-xr-x root root 0 Sep 09 10:39 /user1_home/root_data/ drwxr-xrwx root root 0 Sep 09 10:39 /user1_home/root_data_write/ drwxr-xr-x root root 0 Sep 09 10:39 /user1_home/root_data.orig/ drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/444.txt/
FICHIERS
Systèmes UNIX : /usr/openv/netbackup/logs/bplist/log.jjmmaaa
Systèmes Windows : install_path\NetBackup\logs\bplist\*.log