Avamar：如何使用 avtar 和 MCCLI 检查备份内容

Summary: 如何使用 avtar 和 MCCLI 命令行查询检查 Avamar 备份的文件和目录内容。

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

要获取受特定备份保护的文件的完整列表，请使用 mccli backup show 或 avtar --list 命令。

这些命令都可以从实用程序节点运行。

可以从有权访问 Avamar Server 的任何 Avamar Client 运行 avtar 命令。从客户端运行时， avtar 需要其他参数，例如实用程序节点的 IP 和服务器的登录凭据。

首先，确定要查询的备份的 LabelNum 。

要查找备份的 LabelNum ，请执行以下操作：    

a） 使用用户界面：    

  1. 打开备份管理屏幕。 
  2. 找到客户端。
  3. 找到您感兴趣的备份。
  4. 记下备份历史记录中“Number”列中的值。 

b） 使用 CLI： 

  1. 从 Avamar Utility Node CLI 运行 MCCLI 命令，以列出备份及其 LabelNum 值。

示例：    

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

 

确定所需备份的 LabelNum 后，可将其与 avtar 或 MCCLI 命令方法配合使用。
 

如何使用 MCCLI 查询备份内容：

  1. 下面显示了如何使用 MCCLI 检查备份中的顶级目录。
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:/

使用 --recursive 标志可以深入挖掘并查看备份的内容，包括文件和目录。

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

下面是该命令输出的一小部分摘录。

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

 

如何使用 avtar 查询备份内容：

要从 Avamar 应用工具节点 CLI 运行命令，请执行以下操作：     
avtar --list --labelnum=<backup label number> --acnt=/path/clientv
要从 Avamar 客户端（avs\bin 目录）运行命令，请执行以下操作：      
avtar --list --labelnum=<backup label number> --acnt=/path/client --hfsaddr=<Avamar utility node IP>  --id=<Avamar user> --ap= Avamar user's password>


有关 avtar 参数的信息（请参阅 Avamar 技术附录）：    

  • --id — 选择有权访问客户端域的 Avamar 用户。一个例子是 MCUser，它具有全局访问权限。
  • --list - 列出备份的内容。可以使用 --list 或 -t 。
  • --labelnum - 这可以使用用户界面或 CLI 获取。
  • --internal - 显示备份中存储的 .system_info 隐藏内部目录的内容
  • --verbose - 等效于 -v。此命令参数会增加日志中提供的详细信息。--verbose=2 （-vv）、 --verbose=3 （-vvv） 和 --verbose=4 （-vvvv） 也可用
  • --format=xml - 在 xml 中显示结果
  • --no-recursion - 不递归遍历目录（默认使用递归）。


avtar 生成的文件列表示例（不包含详细登录信息）：   

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)


avtar 生成的文件列表示例（ 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)


提醒：    

--verbose=1 提供了文件列表的其他信息，包括：   
  • 权限
  • 用户和组
  • 文件修改日期。 
-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


使用 avtar list 命令运行时，更高级别的详细级别 （2,3,4） 不提供任何其他信息。


XML 格式

如果我们指定 --format=xml、 我们还可以获取以 XML 格式显示的文件列表。

例如：     

<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" />

 

特定目录的文件列表：    

我们还可以使用 avtar 命令包含我们感兴趣的文件或目录的列表。如果未提供列表，则 avtar 从备份顶部开始。

默认情况下，avtar 以递归方式遍历所有目录以列出文件，但如果需要，可以使用 --no-recursion 标志来防止这种情况发生。

例如，以下命令仅列出“AvaDocs”目录中的文件和文件夹。请勿进入“v6”或“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

警告：    
avtar --list 命令已在具有 Windows 客户端备份的 Avamar Utility Node 上进行了测试。

--list 标志应该在其他地方起作用，但对于某些客户端类型或插件，显示方式可能不同或效果较差。

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.