IDPA: Fixing IDPA Internal VM Backups and RUCK avproxy_internal_backup_check failure using GOAV automated remediation Utility

Summary: This process walks through the steps to re-create the Integration Data Protection Appliance (IDPA) Virtual Machine (VM) Backup policies in Avamar in case they are lost.

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.

Instructions

The following procedure can be used to re-create Integration Data Protection Appliance Internal VMs Backup Policies.

Method # 1:  Automated Procedure: GoAv Tool 

1) Download and install the latest release of GoAv. Instructions and more information about this tool can be found here:  Avamar: Goav tool

2) Confirm that version is 1.69 or above:
./goav version show
The output should look like this:
admin@avamar:~/>: ./goav version show
===========================================================
GoAv    :        1.69
Avamar  :        19.4
Date    :        30 May 2024 12:47 -03
===========================================================
COMMAND :  ./goav version show
NOTE: This is not an official tool
===========================================================
GoAV : 1.69 

3) Now that we confirmed we have version 1.69 (or above) of GoAv, run the following command to run a check on the IDPA Avamar Policies: 
 
./goav idpa check multiple
The GoAv utility covers many topics, we want to focus on two: 

IDPA Backup Preferences:
The output may look like this: 

In this example, we can see the VCenter Backup Policy does not exist.
In this example, we can see the VCenter Backup Policy does not exist.

The Second Section is called: IDPA client VMs

In this example, you can see that the DPA Application VM is missing, has no backups, and is not part of a policy. The Vcenter is also not part of a Policy.
In this example, you can see that the DPA Application VM is missing, has no backups, and is not part of a policy. The vCenter is also not part of a Policy.

4) Fix the IDPA Internal VM Backup issues by running this command: 
./goav idpa fix multiple

You notice the following in the output: 

For IDPA Backup Preferences

We can see the Vcenter Policy was Fixed
We can see that the vCenter Policy was Fixed.

for IDPA client VMs: 
We now see the DPA Application server is now part of a policy (all text is green)

We now see that the DPA Application server is now part of a policy (notice the different color of the text)

GoAv is also indicating: "attempting backup, check gui."
As part of the fix, GoAv started a backup of the DPA Application VM.
 
NOTE: If you are following this KB because RUCK identified VMs without backups, the RUCK tool will not clear the Error until the backup is completed.

Additional Information

Method # 2: Manually using the Command Line: 

Here is an alternative way to automate the Integration Data Protection Appliance backup policy creation process:
=============================================================
Step 1: Log in to the Avamar using SSH/PUTTY as admin.

Step 2: Set a variable for vcsa_domain. Set this to the vCenter FQDN for your system.
vcsa_domain="vc1.sample.com"



Step 3: Create Integration Data Protection Appliance datasets:
mccli dataset add --name=DataProtectionAdvisor_Backup --domain=/$vcsa_domain/VirtualMachines
mccli dataset add --name=DataProtectionCentral_Backup --domain=/$vcsa_domain/VirtualMachines
mccli dataset add --name=DataProtectionSearch_Backup --domain=/$vcsa_domain/VirtualMachines
mccli dataset add --name=Management_VM_Backup --domain=/$vcsa_domain/VirtualMachines
mccli dataset add --name=vCenter_Backup --domain=/$vcsa_domain/VirtualMachines
mccli dataset add --name=DataDomainCloudDisasterRecovery_Backup --domain=/$vcsa_domain/VirtualMachines

Step 4: Create Integration Data Protection Appliance schedules:
mccli schedule add --name=DataProtectionAdvisor_Backup --domain=/$vcsa_domain/VirtualMachines --time="19:00" --duration="23:00"
mccli schedule add --name=DataProtectionCentral_Backup --domain=/$vcsa_domain/VirtualMachines --time="19:00" --duration="23:00"
mccli schedule add --name=DataProtectionSearch_Backup --domain=/$vcsa_domain/VirtualMachines --time="19:00" --duration="23:00"
mccli schedule add --name=Management_VM_Backup --domain=/$vcsa_domain/VirtualMachines --time="19:00" --duration="23:00"
mccli schedule add --name=vCenter_Backup --domain=/$vcsa_domain/VirtualMachines --time="19:00" --duration="23:00"
mccli schedule add --name=DataDomainCloudDisasterRecovery_Backup --domain=/$vcsa_domain/VirtualMachines --time="19:00" --duration="23:00"

Step 5: Create Integration Data Protection Appliance retentions:
mccli retention add --name=DataProtectionAdvisor_Backup --domain=/$vcsa_domain/VirtualMachines --basic="+60D"
mccli retention add --name=DataProtectionCentral_Backup --domain=/$vcsa_domain/VirtualMachines --basic="+60D"
mccli retention add --name=DataProtectionSearch_Backup --domain=/$vcsa_domain/VirtualMachines --basic="+60D"
mccli retention add --name=Management_VM_Backup --domain=/$vcsa_domain/VirtualMachines --basic="+60D"
mccli retention add --name=vCenter_Backup --domain=/$vcsa_domain/VirtualMachines --basic="+60D"
mccli retention add --name=DataDomainCloudDisasterRecovery_Backup --domain=/$vcsa_domain/VirtualMachines --basic="+60D"

Step 6: Create Integration Data Protection Appliance Policies:
mccli group add --name=DataProtectionAdvisor_Backup --enabled --domain=/$vcsa_domain/VirtualMachines --auto-proxy-mapping=true --dataset=DataProtectionAdvisor_Backup --dataset-domain=/$vcsa_domain/VirtualMachines/ --schedule=DataProtectionAdvisor_Backup --schedule-domain=/$vcsa_domain/VirtualMachines/ --retention=DataProtectionAdvisor_Backup --retention-domain=$vcsa_domain/VirtualMachines/

mccli group add --name=DataProtectionCentral_Backup --enabled --domain=/$vcsa_domain/VirtualMachines --auto-proxy-mapping=true --dataset=DataProtectionCentral_Backup --dataset-domain=/$vcsa_domain/VirtualMachines/ --schedule=DataProtectionCentral_Backup --schedule-domain=/$vcsa_domain/VirtualMachines/ --retention=DataProtectionCentral_Backup --retention-domain=$vcsa_domain/VirtualMachines/

mccli group add --name=DataProtectionSearch_Backup --enabled --domain=/$vcsa_domain/VirtualMachines --auto-proxy-mapping=true --dataset=DataProtectionSearch_Backup --dataset-domain=/$vcsa_domain/VirtualMachines/ --schedule=DataProtectionSearch_Backup --schedule-domain=/$vcsa_domain/VirtualMachines/ --retention=DataProtectionSearch_Backup --retention-domain=$vcsa_domain/VirtualMachines/

mccli group add --name=Management_VM_Backup --enabled --domain=/$vcsa_domain/VirtualMachines --auto-proxy-mapping=true --dataset=Management_VM_Backup --dataset-domain=/$vcsa_domain/VirtualMachines/ --schedule=Management_VM_Backup --schedule-domain=/$vcsa_domain/VirtualMachines/ --retention=Management_VM_Backup --retention-domain=$vcsa_domain/VirtualMachines/

mccli group add --name=vCenter_Backup --enabled --domain=/$vcsa_domain/VirtualMachines --auto-proxy-mapping=true --dataset=vCenter_Backup --dataset-domain=/$vcsa_domain/VirtualMachines/ --schedule=vCenter_Backup --schedule-domain=/$vcsa_domain/VirtualMachines/ --retention=vCenter_Backup --retention-domain=$vcsa_domain/VirtualMachines/

mccli group add --name=DataDomainCloudDisasterRecovery_Backup --enabled --domain=/$vcsa_domain/VirtualMachines --auto-proxy-mapping=true --dataset=DataDomainCloudDisasterRecovery_Backup --dataset-domain=/$vcsa_domain/VirtualMachines/ --schedule=DataDomainCloudDisasterRecovery_Backup --schedule-domain=/$vcsa_domain/VirtualMachines/ --retention=DataDomainCloudDisasterRecovery_Backup --retention-domain=$vcsa_domain/VirtualMachines/

Step 7: Manually add VMs into each backup policy group created in the above steps.


Method #3: Manually using the Avamar AUI: 


The following procedure can be used to re-create Integration Data Protection Appliance Internal VMs Backup Policies.

There are six steps to create the Backup Policy.
  • Create a Backup Group Policy.
  • Add Systems to Policy.
  • Create Datasets.
  • Create Backup Schedules
  • Create Retention Policies.
  • Summary
Log in to the Avamar user interface (AUI) and navigate to Policy>Backup Policy tab. Select the Internal Integration Data Protection Appliance vCenter and expand it and select the VirtualMachine Domain. 
This lists all Backup Policies for that domain. There should be four to six Policies there:
DataProtectionAdvisor_Backup
DataProtectionCentra_Backup
Management_VM_Backup
vCenter_Backup
DataProtectionSearch_Backup (If Search is installed).
DataDomainCloudDisasterRecovery_Backup (If CDRA is installed).
If any of these are missing use the below procedure to create them. 

Click the +ADD button in the Policy pane to create a policy.

Select: Backup Policy > vCenter > VirtualMachines > Click the +ADD button in the Policy pane to create a policy.



In the popup box, it is on item one, put in the Name for the policy, use the following names:
DataProtectionAdvisor_Backup
DataProtectionCentra_Backup
Management_VM_Backup
vCenter_Backup
DataProtectionSearch_Backup
DataDomainCloudDisasterRecovery_Backup
Then click the NEXT button.

Enter proper name for policy, then click Next

The second item is to add the Members to the policy. Click the check mark next to the servers that must be added to this policy.
For the DataProtectionAdvisor_Backup policy, select both the DPAApplicationServer and the DPADatastoreServer.
For the DataProtectionCenteral_Backup policy, select the DPC. 
For the Management_VM_Backup policy, select the DataProtection-ACM.
For the vCenter_Backup policy, select the DataProtection-VCSA.
For the DataProtectionSearch_Backup, select the Search_index.
For the DataDomainCloudDisasterRecovery_Backup, select the CDR. 

Then click the NEXT button.

Select proper members, then click Next

The third item is to create the dataset. Set the Dataset name, use the following names:

DataProtectionAdvisor_Backup
DataProtectionCentra_Backup
Management_VM_Backup
vCenter_Backup
DataProtectionSearch_Backup
DataDomainCloudDisasterRecovery_Backup
Check the box next to Linux VMware Image and open the Source Data tab, ensure that All Virtual disks item is selected. 
Click the NEXT button.

Enter Dataset name, then click Next

The fourth item is to create the Schedule. Put in the schedule name, use the following names:
DataProtectionAdvisor_Backup
DataProtectionCentra_Backup
Management_VM_Backup
vCenter_Backup
DataProtectionSearch_Backup
DataDomainCloudDisasterRecovery_Backup
Set the Backup Window to 23 hours.
Under By time point, select 23:55 and click the ADD link to add that time for the schedule.
Click the NEXT button.

Create Schedule, then click Next

The fifth item is setting retention on the backup. Put in the Retention Name, use the following:
DataProtectionAdvisor_Backup
DataProtectionCentra_Backup
Management_VM_Backup
vCenter_Backup
DataProtectionSearch_Backup
DataDomainCloudDisasterRecovery_Backup
Set the Retention period to 30 days.
Click the NEXT button.

Setting retention on backup, then click Next

Item six is the summary, check this to ensure it is correct and that the correct server is at the bottom of the screen, then click the FINISH button.

Summary

This moves back to the Backup Policy screen. Ensure the new policy that was created is shown in the Policy pane.

Ensure the new policy that was created is shown in the Policy pane.

Repeat the process for all missing internal backup policies.

 
 
 

Affected Products

PowerProtect Data Protection Appliance, Integrated Data Protection Appliance Family

Products

PowerProtect DP4400, PowerProtect DP5300, PowerProtect DP5800, PowerProtect DP8300, PowerProtect DP8800, PowerProtect Data Protection Software, Integrated Data Protection Appliance Family, Integrated Data Protection Appliance Software
Article Properties
Article Number: 000021318
Article Type: How To
Last Modified: 13 Jun 2024
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.