Avamar: How to Use Goav Integration Data Protection Appliance feature

Summary: This article explains how to use the Goav Integration Data Protection Appliance feature to resolve issues between Avamar and Integration Data Protection Appliance.

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 was added in Goav version 1.69.

 

Download and Install Goav tool

See Dell article 000192151 Avamar: Goav tool to download and install the Avamar Goav tool.

 

Command

Use the Integration Data Protection Appliance feature by running the following command:

./goav idpa
This feature enables users to efficiently manage and resolve various internal IDPA client or policy-related issues. It enables users to check for and rectify multiple issues within clients or policies, streamlining the process and ensuring smoother operations.

Usage:
  goav idpa [command]

Available Commands:
  check       Allows the user to check for multiple internal IDPA client or policy issues.
  fix         Allows a user to fix multiple internal client and policy issues.

Flags:
  -h, --help   help for idpa

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

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

 

Check the help screen for usage on check command:

 ./goav idpa check --help
Allows the user to check for multiple internal IDPA client or policy issues.

Usage:
  goav idpa check [command]

Aliases:
  check, show

Command for checking multiple issues:
  multiple    Allows the user to check for multiple common issues with IDPA clients and policies.

Additional Commands:
  clients     Check the status of internal IDPA clients.
  policy      Check the status of internal IDPA backup policies.
  proxy       Check the status of internal IDPA proxy.
  vcenter     Check the status of the internal IDPA vCenter connection.
  vms         Check the status of internal IDPA VMs

Flags:
  -h, --help   help for check

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

 

Use Case

In order to complete an Integration Data Protection Appliance upgrade, the upgrade tool requires Integration Data Protection Appliance configuration in Avamar and state to be healthy and properly configured. goav idpa automates fixing problems.

Examples

IDPA vCenter Certificate Status:

  CERTIFICATE STORE |            CERTIFICATE ALIAS             | CERTIFICATE EXPIRATION DATE
--------------------+------------------------------------------+------------------------------
  MACHINE_SSL_CERT  | __MACHINE_CERT                           | Feb 8 18:13:46 2026 GMT
  TRUSTED_ROOTS     | cd580a4bf7507f72aa2806256f5152c897e4e5b1 | Feb 3 18:23:46 2034 GMT
  machine           | machine                                  | Feb 8 18:16:06 2026 GMT
  vsphere-webclient | vsphere-webclient                        | Feb 8 18:16:06 2026 GMT
  vpxd              | vpxd                                     | Feb 8 18:16:07 2026 GMT
  vpxd-extension    | vpxd-extension                           | Feb 8 18:16:07 2026 GMT
  data-encipherment | data-encipherment                        | Dec 14 01:50:09 2025 GMT

  STS CERTIFICATE | VALID
------------------+--------
  LEAF Cert       | true
  ROOT Cert       | true

IDPA vCenter Status:

               IDPA VCENTER              |          STATUS
-----------------------------------------+----------------------------
  /vc-4400-crk-2.dpad.example.com | vCenter connection(s) OK.


Internal VMs from vCenter:

        VM NAME        | POWER STATUS |                               VCENTER PATH
-----------------------+--------------+----------------------------------------------------------------------------
  AVProxy              | poweredOn    | /DPappliance/vm/DataProtection/ProtectionSoftware/AVProxy
  AVE                  | poweredOn    | /DPappliance/vm/DataProtection/ProtectionSoftware/AVE
  DPADatastoreServer   | poweredOn    | /DPappliance/vm/DataProtection/ReportingAndAnalytics/DPADatastoreServer
  DPAApplicationServer | poweredOn    | /DPappliance/vm/DataProtection/ReportingAndAnalytics/DPAApplicationServer
  DPC                  | poweredOn    | /DPappliance/vm/DataProtection/DataProtectionCentral/DPC
  DDVE                 | poweredOn    | /DPappliance/vm/DataProtection/ProtectionStorage/DDVE
  DPSIndexMaster       | poweredOn    | /DPappliance/vm/DataProtection/Search/DPSIndexMaster
  DataProtection-VCSA  | poweredOn    | /DPappliance/vm/Discovered virtual machine/DataProtection-VCSA
  DataProtection-ACM   | poweredOn    | /DPappliance/vm/Discovered virtual machine/DataProtection-ACM

Internal vCenter domain clients:

        VM NAME        |                                         AVAMAR CLIENT PATH
-----------------------+-----------------------------------------------------------------------------------------------------
  DataProtection-ACM   | /vc-4400-crk-2.dpad.example.com/VirtualMachines/DataProtection-ACM_B9kfIpLYPPA8HEpD1xafYA
  DataProtection-VCSA  | /vc-4400-crk-2.dpad.example.com/VirtualMachines/DataProtection-VCSA_U2SMAxDpPOSKS9IoveciJw
  DPAApplicationServer | /vc-4400-crk-2.dpad.example.com/VirtualMachines/DPAApplicationServer_EAub2SApN5yDnsD2QMaH3A
  DPADatastoreServer   | /vc-4400-crk-2.dpad.example.com/VirtualMachines/DPADatastoreServer_iktjR7LVOkOIYc3Bx3BLOQ
  DPC                  | /vc-4400-crk-2.dpad.example.com/VirtualMachines/DPC_VudUhrCvMXKjnBIAzR0JrA
  DPSIndexMaster       | /vc-4400-crk-2.dpad.example.com/VirtualMachines/DPSIndexMaster_cNaGnyyNNnuyvq2MUcHSMQ


Internal Proxy vCenter Status:

            IDPA PROXY HOSTNAME           | VM NAME | POWER STATUS
------------------------------------------+---------+---------------
  prxy-4400-crk-2.dpad.example.com | AVProxy | powered on

Internal Proxy Status:

                IDPA PROXY                |  DOMAIN  |        VERSION        | ACTIVATED |      LAST CHECK-IN
------------------------------------------+----------+-----------------------+-----------+---------------------------
  prxy-4400-crk-2.dpad.example.com | /clients | 19.4.100-116_HF334141 | true      | 2024-06-07T21:58:11.000Z

IDPA Backup Preferences:

         BACKUP POLICY         | DATASET | SCHEDULE | RETENTION | POLICY
-------------------------------+---------+----------+-----------+---------
  DataProtectionAdvisor_Backup | Found   | Found    | Found     | Found
  DataProtectionCentral_Backup | Found   | Found    | Found     | Found
  Management_VM_Backup         | Found   | Found    | Found     | Found
  vCenter_Backup               | Found   | Found    | Found     | Found
  DataProtectionSearch_Backup  | Found   | Found    | Found     | Found

IDPA client VMs:

      IDPA VM NAME     | AVAMAR CLIENT |       LAST BACKUP        | POWER STATE |      POLICY MEMBERSHIP
-----------------------+---------------+--------------------------+-------------+-------------------------------
  DPAApplicationServer | is registered | 2024-06-06T23:49:45.000Z | powered on  | DataProtectionAdvisor_Backup
  DPADatastoreServer   | is registered | 2024-06-06T23:51:45.000Z | powered on  | DataProtectionAdvisor_Backup
  DPC                  | is registered | 2024-06-06T23:51:34.000Z | powered on  | DataProtectionCentral_Backup
  DataProtection-ACM   | is registered | 2024-06-06T23:49:55.000Z | powered on  | Management_VM_Backup
  DataProtection-VCSA  | is registered | 2024-06-06T23:58:04.000Z | powered on  | vCenter_Backup
  DPSIndexMaster       | is registered | 2024-06-06T23:49:24.000Z | powered on  | DataProtectionSearch_Backup

 

Explanation of Checks

  • vCenter Check:
    Checks the status of the internal Integration Data Protection Appliance vCenter connection
    Checks the status of the internal Integration Data Protection Appliance vCenter certificates

  • Virtual Machine Check:
    Checks the status of internal Integration Data Protection Appliance VMs

  • Proxy Check:
    Checks the status of internal Integration Data Protection Appliance proxy

  • Policy Check:
    Checks the status of internal Integration Data Protection Appliance backup policies (Groups, Retentions, Schedules, Datasets)

  • Clients Check:
    Checks Integration Data Protection Appliance client status (registered, last backups, power state, policy membership)

 

Explanation of Fixes

  • vCenter Fix:
    Regenerates new vCenter certificates if they have expired

  • Virtual Machine Fix:
    Checks the status of internal Integration Data Protection Appliance VMs and retires and readds them to backup policies if needed

  • Proxy Fix:
    Checks the status of the internal Integration Data Protection Appliance proxy and re-register the proxy if needed

  • Policy Fix:
    Ensures the Integration Data Protection Appliance expected policy settings that they are present in Avamar and if needed, re-creates Groups, Retentions, Schedules, and Datasets settings

  • Clients Fix:
    Check Integration Data Protection Appliance client status (registered, last backups, power state, policy membership) and starts a manual backup if needed

 

Affected Products

PowerProtect Data Protection Appliance

Products

Avamar
Article Properties
Article Number: 000225881
Article Type: How To
Last Modified: 11 Jun 2024
Version:  1
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.