Avamar: How to Use Goav Client Bare Metal Recovery Menu

Summary: This article explains how to use the 'goav client bmr' command set.

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 feature is supported in Goav version 1.66 and later.
Download and Install the Goav tool at Avamar: Goav tool
Once Goav has been placed on Avamar, go to the directory and make the tool executable. 
chmod a+x goav

Client Bare Metal Recovery (BMR) Menu:

Usage:
  goav client bmr [command]

Available Commands:
  backups        List BMR backups for the client(s).
  details        Show BMR backup metadata for the client(s).
  download-logs  Download BMR Offline Restore Logs for the client. Label number is required.
  list           List Avamar clients.
  logs           Display BMR logs for the client(s).

Flags:
  -h, --help   help for bmr

Global Flags:
  -d, --debug      debug output
  -f, --force      Ignore Configuration
  -n, --noheader   Do not display header

Use "goav client bmr [command] --help" for more information about a command.

Commands Explained:

  • List Avamar clients with Windows VSS Plug-in installed:  
./goav client bmr list --name <Client Name> --domain <Avamar Domain>
Partial names are allowed for <Client Name>.

For example, the below command lists all the clients with 'sql' in its name in /clients Domain: 
./goav client bmr list --name sql --domain /clients
To list one or more clients, matching <Client Name> in all Avamar Domains use --recursive flag. 
./goav client bmr list --name <client name> --recursive
  • List BMR backups for one or more clients: 
./goav client bmr backups --name <Client Name> --domain <Avamar Domain>
Partial names are allowed for <Client Name>.

To list BMR backups for one or more clients, matching <Client Name> in all Avamar Domains use --recursive flag: 
./goav client bmr backups --name <Client Name> --recursive
To list BMR backups for the client with the CID provided, use --cid flag: 
./goav client bmr backups --cid <Client CID>
To list the latest BMR backup, add the --latest flag.

For example, the below command lists the latest BMR backup for each client (containing 'sql' in the name) in /clients Domain: 
./goav client bmr backups --name sql --domain /clients --latest
  • Show BMR details for one or more clients:
Show source client (machine) configuration from BMR backup metadata (disk number and size, is critical or not, firmware type: BIOS/UEFI, operating system type, so on), by Client CID or Avamar Domain or Client Name 
./goav client bmr details --name <Client Name> --domain <Avamar Domain> --labelnum <Label Number>
Partial names are allowed for <Client Name>.

If no Backup Label Number is specified (no --labelnum), client configuration (BMR backup metadata) for the latest VSS backup is shown.
 
For example, the below command shows source machine configuration (latest VSS backup) for all the clients (containing 'sql' in the name) in /clients Domain: 
./goav client bmr details --name sql --domain /clients
 
To export the output to a .csv or .txt file, use --format=csv or --format=txt flag.

For example, the below command saves the output to a .csv formatted file:  
./goav client bmr details --name sql --domain /clients --format=csv
  • Display BMR logs for the client(s):

List Bare Metal Recovery Wizard "Offline Restore Logs" stored on Avamar Server and available for restore. 

./goav client bmr logs --name <Client Name> --domain <Avamar Domain>
Partial names are allowed for <Client Name>.

To list Bare Metal Recovery Wizard "Offline Restore Logs" for one or more clients, matching <Client Name> in all Avamar Domains use --recursive flag: 
./goav client bmr logs --name <Client Name> --recursive
For example, the below command lists Bare Metal Recovery Wizard "Offline Restore Logs" for each client (containing 'sql' in the name) in /clients Domain: 
./goav client bmr logs --name sql --domain /clients

 

  • Download BMR Offline Restore Logs for the client. Label number is required.

Restore Bare Metal Recovery Wizard "Offline Restore Logs" to /home/admin/goavlogs/BMR-<clientname>-<Label number> folder on Avamar Server:

./goav client bmr download-logs --name <Client Name> --domain <Avamar Domain> --labelnum <Label Number>

 To restore Bare Metal Recovery Wizard "Offline Restore Logs" to Windows client machine, use --target <path_to_windows_client_on Avamar>.

 For example, the below command restores Bare Metal Recovery Wizard "Offline Restore Logs" (label number "12") for "sql.domain.com" client to Windows client /clients/sql-1.domain.com

./goav client bmr download-logs --name sql.domain.com --domain /clients --labelnum 12 --target sql-1.domain.com

 By default, the logs will be restored to C:/BMR-<clientname>-<Label number> folder on Windows client.

To restore the logs to a specific folder on Windows client, use --folder  <folder_path>. For example, --folder c:/Restore

To show BMR log restore job status for the specified client, re-run the previous command with --status flag:

For example, the below command shows Bare Metal Recovery Wizard "Offline Restore Logs" restore job status for target Windows client: /clients/sql-1.domain.com

./goav client bmr download-logs --name sql.domain.com --domain /clients --labelnum 12 --target sql-1.domain.com --status

Affected Products

Avamar
Article Properties
Article Number: 000223619
Article Type: How To
Last Modified: 13 Jan 2025
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.