Avamar: How to use the mccli command to perform a restore

Summary: How to use the mccli command to perform a restore.

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

This article explains how to use Avamar MCCLI commands to restore files.

Note: The client name and domain must be known.
 
 

1. List the available backups for the client:

mccli backup show --name=/<domain>/<client>
 

Example where the domain is "Large_Clients" and the client name is "Filesystem12.company.com":

mccli backup show --name=/Large_Clients/Filesystem12.company.com --verbose

0,23000,CLI command completed successfully.
Created                 LabelNum Size   Retention Hostname              Location Consistent Level Tier   Label            Plugin              
----------------------- -------- ------ --------- --------------------- -------- ---------------- ------ ---------------- ------------------- 
2020-06-23 10:31:30 HKT 73       4.8 GB DW        avamar1.company.com   Local    not_available    Active Daily_FS_Backup  Windows File System 
2020-06-09 10:31:21 HKT 72       4.8 GB DWM       avamar1.company.com   Local    not_available    Active Weekly_FS_Backup Windows File System
 

2. List the backup date:

mccli backup show --name=/<domain>/<client> --labelNum=<LabelNum>
 

Example for LabelNum 72:

mccli backup show --name=/Large_Clients/Filesystem12.company.com --labelNum=72

0,23000,CLI command completed successfully.
Type Date                Size   Owner   Group            Permissions Name
---- ------------------- ------ ------- ---------------- ----------- ----
Dir  2020-06-06 12:16:14 4.8 GB unknown TrustedInstaller drwxrwxrwx  C:/
 

3. List the backup contents:

mccli backup show --name=/<domain>/<client> --labelNum=<LabelNum> --recursive=true
 

Example for LabelNum 72:

mccli backup show --name=/Large_Clients/Filesystem12.company.com --labelNum=72 --recursive=true

0,23000,CLI command completed successfully.
Type Date                Size    Owner   Group            Permissions Name
---- ------------------- ------- ------- ---------------- ----------- ----
File 2016-04-13 11:07:14 11.3 KB abc     Domain Users     -rwx------  C:/Users/MyBackup/Recipes/jam.docx
File 2016-04-13 11:08:14 11.3 KB abc     Domain Users     -rwx------  C:/Users/MyBackup/Recipes/cake.docx

 

Note: If there is a lot of output, it can be redirected to a file:
  
mccli backup show --name=/<domain>/<client> --labelNum=<LabelNum> --recursive=true > <client>_<LabelNum>_contents.out
 

Example for LabelNum 72:

mccli backup show --name=/Large_Clients/Filesystem12.company.com --labelNum=72 --recursive=true > Filesystem12.company.com_72_contents.out
 

4. Determine the plugin number for the backup (based on the output from step 1).

mccli plugin show |grep -i "<Plugin>"
 

Example:

mccli plugin show |grep -i "Windows File System"
...
Windows File System                                3001  19.0.100 ALL   No       No                         No               No                No              No                      No
Windows File System                                3001  19.1.100 ALL   No       No                         No               No                No              No                      No
Windows File System                                3001  19.2.100 ALL   No       No                         No               No                No              No                      No
Windows File System                                3001  19.3.100 ALL   No       No                         No               No                No              No                      No
Windows File System                                3001  19.4.100 ALL   No       No                         No               No                No              No                      No
 

The "Windows File System" plugin Number is 3001.

5. Perform the restore:

mccli backup restore --name=/<domain>/<client> --labelNum=<LabelNum> --plugin=<plugin-number> --data=<data-to-restore> -dest-dir=<Destination-directory-to-restore-to>
 

Example:

mccli backup restore --name=/Large_Clients/Filesystem12.company.com --labelNum=72 --plugin=3001 --data=C:/Users/Recipes/jam.docx -dest-dir=C:/Users/MyBackup

Additional Information

See the following article for information about how to check the contents of a backup: Avamar: How to check backup contents using avtar and MCCLI

Affected Products

Avamar, Avamar Server
Article Properties
Article Number: 000020804
Article Type: How To
Last Modified: 24 Jul 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.