Avamar : Comment vérifier le contenu des sauvegardes à l’aide d’avtar et de MCCLI

Summary: Vérification du contenu des fichiers et des répertoires d’une sauvegarde Avamar à l’aide des requêtes de ligne de commande avtar et MCCLI.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Pour obtenir la liste complète des fichiers protégés par une sauvegarde particulière, utilisez la commande mccli backup show ou avtar --list. 

Ces commandes peuvent toutes deux être exécutées à partir du nœud utilitaire.

La commande avtar peut être exécutée à partir de n’importe quel client Avamar ayant accès à l’instance d’Avamar Server. Lorsqu’il est exécuté à partir d’un client, avtar nécessite des paramètres supplémentaires tels que l’adresse IP du nœud utilitaire et les informations d’identification de connexion au serveur.

Tout d’abord, identifiez le LabelNum de la sauvegarde que vous souhaitez interroger.

Pour trouver le LabelNum d’une sauvegarde :    

a) Utilisation de l’interface utilisateur :    

  1. Ouvrez l’écran Backup Management. 
  2. Localisez le client.
  3. Recherchez la sauvegarde qui vous intéresse.
  4. Notez la valeur dans la colonne « Number » de l’historique des sauvegardes. 

b) Utilisation de l’interface CLI : 

  1. Exécutez une commande MCCLI à partir de l’interface de ligne de commande Avamar Utility Node pour répertorier les sauvegardes ainsi que leurs valeurs LabelNum .

Exemples :    

admin@utilitynode:~/>: mccli backup show --domain=/full/domain/path --name=clientname.domain.com

Created                 LabelNum Size        Retention
----------------------- -------- ----------- ---------
2012-04-20 11:31:43 IST 34       132686304   N
2012-03-03 08:34:38 GMT 28       93336576    N
2012-03-03 08:33:34 GMT 27       6600942     N
2011-12-27 12:00:44 GMT 24       20730800    N

 

Une fois que le LabelNum de la sauvegarde requise est identifié, il peut être utilisé avec la méthode de commande avtar ou MCCLI.
 

Comment interroger le contenu des sauvegardes à l’aide de MCCLI :

  1. La figure suivante montre comment utiliser MCCLI pour vérifier les répertoires de premier niveau dans la sauvegarde.
mccli backup show --name=/clients/client.customer.com --labelNum=123
0,23000,CLI command completed successfully.
Type Date                Size    Owner   Group            Permissions Name
---- ------------------- ------- ------- ---------------- ----------- ----
Dir  2016-12-19 08:39:15 3.2 GB  unknown TrustedInstaller drwxrwxrwx  C:/
Dir  2016-12-26 10:51:28 0 bytes SYSTEM  unknown          drwxrwxrwx  E:/

L’utilisation de la balise --recursive permet d’aller plus loin et de voir le contenu de la sauvegarde, y compris les fichiers et les répertoires.

mccli backup show --name=/clients/client --labelNum=123 --recursive=true

Vous trouverez ci-dessous un petit extrait de la sortie de la commande.

Type Date                Size        Owner          Group            Permissions Name
File 2012-07-23 19:09:33 174 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/AppData/Roaming/Microsoft/Windows/Start Menu/desktop.ini
Dir  2009-07-14 02:34:59 0 bytes     Administrators unknown          drwxrwxr-x  C:/Users/Default/AppData/Roaming/Microsoft/Windows/Templates/
Dir  2011-05-12 18:34:59 1.4 MB      SYSTEM         unknown          drwxrwxr-x  C:/Users/Default/AppData/Roaming/Microsoft/Windows/Themes/
File 2011-05-12 18:35:00 4.1 KB      SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/AppData/Roaming/Microsoft/Windows/Themes/slideshow.ini
File 2012-10-15 14:30:00 1.4 MB      SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/AppData/Roaming/Microsoft/Windows/Themes/TranscodedWallpaper.jpg
Dir  2009-07-14 05:08:56 0 bytes     SYSTEM         unknown          drwxrwx--x  C:/Users/Default/Application Data/
Dir  2012-07-23 19:09:33 67.2 KB     SYSTEM         unknown          dr-xr-xr-x  C:/Users/Default/Contacts/
File 2010-11-21 02:51:05 66.8 KB     SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Contacts/Administrator.contact
File 2012-07-23 19:09:33 412 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Contacts/desktop.ini
Dir  2009-07-14 05:08:56 0 bytes     SYSTEM         unknown          drwxrwx--x  C:/Users/Default/Cookies/
Dir  2012-07-23 19:09:33 282 bytes   Administrators unknown          dr-xr-xr-x  C:/Users/Default/Desktop/
File 2012-07-23 19:09:33 282 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Desktop/desktop.ini
Dir  2012-07-23 19:09:33 402 bytes   Administrators unknown          dr-xr-xr-x  C:/Users/Default/Documents/
Dir  2009-07-14 05:08:56 0 bytes     SYSTEM         unknown          drwxrwx--x  C:/Users/Default/Documents/My Music/
Dir  2009-07-14 05:08:56 0 bytes     SYSTEM         unknown          drwxrwx--x  C:/Users/Default/Documents/My Pictures/
Dir  2009-07-14 05:08:56 0 bytes     SYSTEM         unknown          drwxrwx--x  C:/Users/Default/Documents/My Videos/
File 2012-07-23 19:09:33 402 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Documents/desktop.ini
Dir  2012-07-23 19:09:33 282 bytes   Administrators unknown          dr-xr-xr-x  C:/Users/Default/Downloads/
File 2012-07-23 19:09:33 282 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Downloads/desktop.ini
Dir  2012-07-23 19:09:33 2.6 KB      Administrators unknown          dr-xr-xr-x  C:/Users/Default/Favorites/
Dir  2011-11-07 19:04:30 306 bytes   SYSTEM         unknown          dr-xr-xr-x  C:/Users/Default/Favorites/Links/
File 2011-11-07 19:04:30 80 bytes    SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Favorites/Links/desktop.ini
File 2012-07-23 17:33:42 226 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Favorites/Links/Web Slice Gallery.url
Dir  2010-11-21 02:51:27 666 bytes   SYSTEM         unknown          drwxrwxr-x  C:/Users/Default/Favorites/Microsoft Websites/
File 2012-07-23 17:33:42 133 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Favorites/Microsoft Websites/IE Add-on site.url
File 2012-07-23 17:33:42 133 bytes   SYSTEM         unknown          -rwxrwxr-x  C:/Users/Default/Favorites/Microsoft Websites/IE site on Microsoft.com.url

 

Comment interroger le contenu de la sauvegarde à l’aide d’avtar :

Pour exécuter la commande à partir de la CLI d’Avamar Utility Node :     
avtar --list --labelnum=<backup label number> --acnt=/path/clientv
Pour exécuter la commande à partir d’un client Avamar (répertoire avs\bin) :      
avtar --list --labelnum=<backup label number> --acnt=/path/client --hfsaddr=<Avamar utility node IP>  --id=<Avamar user> --ap= Avamar user's password>


Informations sur les paramètres avtar (voir l’addendum technique Avamar) :    

  • --id : sélectionnez un utilisateur Avamar ayant accès au domaine du client. Par exemple, MCUser, qui dispose d’un accès mondial.
  • --list : répertorie le contenu d’une sauvegarde. L’option --list ou -t peut être utilisée.
  • --labelnum - cela peut être obtenu à l’aide de l’interface utilisateur ou de la CLI.
  • --internal : affiche le contenu du répertoire interne masqué .system_info stocké dans la sauvegarde
  • --verbose - Équivalent à -v. Ce paramètre de commande augmente les détails fournis dans le journal. --verbose=2 (-vv) --verbose=3 (-vvv) et --verbose=4 (-vvvv) sont également disponibles
  • --format=xml - Affiche les résultats en xml
  • --no-recursion - Ne parcourt pas les répertoires de manière récursive (la valeur par défaut est d’utiliser la récursivité).


Exemple de liste de fichiers générés par avtar (sans connexion explicite) :   

avtar --list --labelnum=34 --acnt=/yesman/SomeAvamarClient.client.customer.com

avtar Info <5551>: Command Line: /usr/local/avamar/bin/avtar.bin --flagfile=/usr/local/avamar/etc/usersettings.cfg --server=avmtest5 --vardir=/usr/local/avamar/var --bindir=/usr/local/avamar/bin --id=root --password=********* --vardir=/usr/local/avamar/var --bindir=/usr/local/avamar/bin --sysdir=/usr/local/avamar/etc --list --sequencenumber=34 --account=/yesman/SomeAvamarClient.client.customer.com
avtar Info <6555>: Initializing connection (Avamar Deduplication Engine v2.0.0)
avtar Info <5552>: Connecting to Avamar Server (avmtest5)
avtar Info <5554>: Connecting to one node in each datacenter
avtar Info <5583>: Login User: "root", Domain: "default", Account: "/yesman/SomeAvamarClient.client.customer.com"
avtar Info <5580>: Logging in on connection 0 (server 0)
avtar Info <5582>: Avamar Server login successful
avtar Info <5550>: Successfully logged into Avamar Server
avtar Info <8745>: Backup from Windows XP Professional SP 3.0 host "/yesman/SomeAvamarClient.client.customer.com" (SomeAvamarClient) with plugin 3001 - Windows Filesystem
avtar Info <5538>: Backup #34 label "MOD-xxxxxxx" timestamp 2012-04-20 11:31:43 IST, 56 files, 126.5 MB
C:/
C:/Documents and Settings/
C:/Documents and Settings/user/
C:/Documents and Settings/user/My Documents/
C:/Documents and Settings/user/My Documents/AvaDocs/
C:/Documents and Settings/user/My Documents/AvaDocs/300-009-591-ADS_Rekick.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/ADS/
C:/Documents and Settings/user/My Documents/AvaDocs/ADS/ADS Gen1-4 rekickstart -300-009-591-ADS_Rekick.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/ADT 1 - Installation - 300-008-863.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/ADT 1 - Security 300-008-865.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/ADT logs.TXT
C:/Documents and Settings/user/My Documents/AvaDocs/Avamar 6.0 for VMware - 300-011-626.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/Avamar PSB07A_Draft_0.2.docx
C:/Documents and Settings/user/My Documents/AvaDocs/Configuration of High-Availability ADS Network Avamar Data Store Gen3 Technical Note - 300-011-174.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/DataDomain/
C:/Documents and Settings/user/My Documents/AvaDocs/DataDomain/MR-1CN-DDSADMIN.50G3.lb.gd.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/Tech Addendum - 300-008-817.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/v5 Backup Clients 300-008-819.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/v5 Software server installation - 300-008-827.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/v6/Utility Node Replacement Tech Note300-007-551.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/v6/v6 Avamar for VMware - 300-011-626.pdf
C:/Documents and Settings/user/My Documents/AvaDocs/v6/v6 Avamar for Windows Servers 300-011-627.pdf

avtar Info <5314>: Command completed (exit code 0: Success)


Exemple de liste de fichiers générés par avtar (avec journalisation verbose=1 )
 

avtar --list --labelnum=34 --verbose=1 --acnt=/yesman/SomeAvamarClient.customer.com

avtar Info <5551>: Command Line: /usr/local/avamar/bin/avtar.bin --flagfile=/usr/local/avamar/etc/usersettings.cfg --server=avmtest5 --vardir=/usr/local/avamar/var --bindir=/usr/local/avamar/bin --id=root --password=********* --vardir=/usr/local/avamar/var --bindir=/usr/local/avamar/bin --sysdir=/usr/local/avamar/etc --list --sequencenumber=34 --verbose=1 --account=/yesman/SomeAvamarClient.customer.com

avtar Info <6555>: Initializing connection (Avamar Deduplication Engine v2.0.0)
avtar Info <5552>: Connecting to Avamar Server (avmtest5)
avtar Info <5554>: Connecting to one node in each datacenter
avtar Info <5583>: Login User: "root", Domain: "default", Account: "/yesman/SomeAvamarClient.customer.com"
avtar Info <5580>: Logging in on connection 0 (server 0)
avtar Info <5582>: Avamar Server login successful
avtar Info <5550>: Successfully logged into Avamar Server
avtar Info <8745>: Backup from Windows XP Professional SP 3.0 host "/yesman/SomeAvamarClient.customer.com" (SomeAvamarClient) with plugin 3001 - Windows Filesystem
avtar Info <5538>: Backup #34 label "MOD-xxxxxxxxx" timestamp 2012-04-20 11:31:43 IST, 56 files, 126.5 MB
drwxrwxrwx Administrators/SYSTEM    132686301   0% 2012-04-19 09:13:11 C:/
drwxrwxr-x Administrators/SYSTEM    132686301   0% 2010-10-06 13:09:09 C:/Documents and Settings/
drwxrwx--- Administrators/SYSTEM    132686301   0% 2012-04-20 08:18:23 C:/Documents and Settings/user/
dr-x------   user/Domain Users  132686301   0% 2012-04-06 19:32:50 C:/Documents and Settings/user/My Documents/
drwx------   user/Domain Users  132686301   0% 2012-03-27 10:15:01 C:/Documents and Settings/user/My Documents/AvaDocs/
-rwx------   user/Domain Users     337081   0% 2011-03-18 22:54:00 C:/Documents and Settings/user/My Documents/AvaDocs/300-009-591-ADS_Rekick.pdf
drwx------   user/Domain Users    7109132   0% 2011-12-20 15:40:16 C:/Documents and Settings/user/My Documents/AvaDocs/ADS/
-rwx------   user/Domain Users     740667   0% 2011-11-23 11:59:22 C:/Documents and Settings/user/My Documents/AvaDocs/ADS/ADS Gen1-4 rekickstart -300-009-591-ADS_Rekick.pdf
-rwx------   user/Domain Users    3831369   0% 2011-12-20 15:40:16 C:/Documents and Settings/user/My Documents/AvaDocs/ADS/ADS Gen4 - single node install - 300-011-545.pdf
-rwx------   user/Domain Users    2537096   0% 2011-07-11 08:39:07 C:/Documents and Settings/user/My 
-rwx------   user/Domain Users       2717   0% 2011-03-03 11:56:19 C:/Documents and Settings/user/My Documents/AvaDocs/ADT logs.TXT
-rwx------   user/Domain Users    3950628   0% 2011-07-20 13:34:51 C:/Documents and Settings/user/My Documents/AvaDocs/Avamar 6.0 for VMware - 300-011-626.pdf
-rwx------   user/Domain Users    2783560   0% 2011-05-13 14:33:45 C:/Documents and Settings/user/My Documents/AvaDocs/Avamar PSB07A_Draft_0.2.docx
-rwx------   user/Domain Users     818759   0% 2011-05-11 11:37:42 C:/Documents and Settings/user/My Documents/AvaDocs/Configuration of High-Availability ADS Network Avamar Data Store Gen3 Technical Note - 300-011-174.pdf
drwx------   user/Domain Users    7241382   0% 2011-12-19 17:26:51 C:/Documents and Settings/user/My Documents/AvaDocs/DataDomain/
avtar Info <5314>: Command completed (exit code 0: Success)


Remarques :    

--verbose=1 fournit des informations supplémentaires avec la liste des fichiers, notamment :   
  • Autorisations
  • Utilisateur et groupe
  • Date de modification du fichier. 
-rwx------   xxxxxxxx/Domain Users     337081   0% 2011-03-18 22:54:00 C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/300-009-591-ADS_Rekick.pdf


Les niveaux de verbosité supérieurs (2, 3, 4) ne fournissaient pas d’informations supplémentaires lorsqu’ils étaient exécutés avec la commande avtar list .


Mise en forme XML

Si nous spécifions --format=xml, Nous pouvons également obtenir une liste de fichiers qui s’affiche au format XML. 

Par exemple :     

<file date="2011-04-21 09:00:28" internal="0" group="Domain Users" protection="-rwx------" name="Windows Guide v5 300-010-672.pdf" size="3476325" links="0" user="tabitha" />

 

Listes de fichiers pour un répertoire spécifique :    

Nous pouvons également inclure, avec la commande avtar, une liste de fichiers ou de répertoires qui nous intéressent. Si aucune liste n’est fournie, avtar démarre en haut de la sauvegarde. 

Par défaut, avtar parcourt tous les répertoires de manière récursive pour répertorier les fichiers, mais si nécessaire, cela peut être empêché à l’aide de la balise --no-recursion .

Par exemple, la commande suivante répertorie les fichiers et dossiers dans le répertoire « AvaDocs » uniquement. Ne descendez pas dans les répertoires « v6 » ou « ADS ».

avtar --list  --labelnum=34 --no-recursion --acnt=/yesman/SomeAvamarClient.customer.com "C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs"
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/300-009-591-ADS_Rekick.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/ADS/
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/ADS Gen3 customer service guide - 300-008-858.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/ADS Gen3 System Installation Manual - 300-008-856.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/ADT 1 - Installation - 300-008-863.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/ADT 1 - Security 300-008-865.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/ADT logs.TXT
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Avamar 6.0 for VMware - 300-011-626.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Avamar PSB07A_Draft_0.2.docx
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Configuration of High-Availability ADS Network Avamar Data Store Gen3 Technical Note - 300-011-174.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/DataDomain/
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/EMC_Software_Customer_Guide.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Error Codes -v5 - 300-008-813.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/EscTemplate.txt
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Exch Guide v5 300-008-821.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/hotkeys.txt
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Installation Guide v5 - 300-008-827.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/IP Hostname change tech note - 300-007-539.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/May 2011 - avamar-replication-wp.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/MCCLI Guide v5 - 300-008-818.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Operational Best Pract - 300-008-815.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Oracle Guide v5 300-008-824.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Tech Addendum - 300-008-817.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v5 Backup Clients 300-008-819.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v5 NDMP 300-008-823.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v5 Product Security Guide - 300-008-816.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v5 Release Notes 300-008-811.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v5 Software server installation - 300-008-827.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v5 SysAdmin 300-008-814.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/v6/
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Vmware Guide v5 - 300-010-712.pdf
C:/Documents and Settings/xxxxxxx/My Documents/AvaDocs/Windows Guide v5 300-010-672.pdf
avtar Info <5314>: Command completed (exit code 0: Success)

 

Additional Information

Avertissements:    
La commande avtar --list a été testée sur Avamar Utility Node avec une sauvegarde du client Windows. 

La balise --list devrait fonctionner ailleurs, mais peut s’afficher différemment ou être moins efficace avec certains types de clients ou plugins.

Affected Products

Avamar

Products

Avamar
Article Properties
Article Number: 000060516
Article Type: How To
Last Modified: 25 Jul 2025
Version:  10
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.