Avamar: Immutable Backup (aka Limited Backup Management) Feature

Summary: This knowledge article provides information relating to the Immutable Backup (aka Limited Backup Management) Feature.

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

This feature allows a type of retention lock to be configured on all (both existing and new) Avamar backups.

After applying this one-way procedure, the backup metadata (such as expiration date, retention tag, and so forth) cannot be changed.

For replicated data, the remote backups are not locked if the remote grid does not have this feature enabled.

 

IDPA Avamar Immutable Backup Feature Supportability

At the time of publication, the IDPA version of Avamar does not support Immutable Backup. 

 

Immutable Backup requirements:

The immutable feature is inbuilt and available in Avamar version 19.8.

The feature can be enabled in older code versions by installing a hotfix:

The minimum requirement is Avamar version 19.4.0-116 with Management Console Server (MCS) hotfix 333200.

Note: This only enables the Immutable Backup Feature on Avamar, NOT Data Domain. Refer to the "Immutable Backup behavior with Data Domain" section below.
 
 

Immutable Backup Features:

Once the limited backup is configured, the following operations cannot be performed in the in MC UI or Avamar Web Interface (AUI):
    • Change the expiration date of local and remote backups while retiring clients.
    • Delete clients.
    • Change the expiration date of a backup.
    • Change the retention type of a backup.
    • Delete a backup.
Warning: Existing backups immediately become immutable when this feature is enabled.
 
 

How to enable and verify Immutable Backup:

To enable this feature, the following command must be run as admin on the Avamar Utility Node: 

Caution: Carefully, evaluate your decision because THIS IS IRREVERSIBLE!
 
avmaint config immutablebackups=true --confirmthisisnotreversible --ava
 

To verify the Parameter is enabled:

avmaint config | grep immutablebackups
 

Expected output:

immutablebackups="true"
 
 

Immutable Backup behavior if an attempt is made to delete or change a backup:

Avamar Web Interface (AUI):

If an attempt is made to delete or change a backup in the Avamar AUI, the error "Error occurred while deleting backup :[object Object]" is displayed:

 

Avamar Command Line:

If an attempt is made to delete or change a backup in the Avamar command line, the error "ERROR! Exit Code 20: Insufficient Privileges" is displayed:

mccli backup delete --name=/clients/DB.SQL-01 --created=2022-03-03 --labelNum-42 
1,22559,The backup has more than one retention tag.
 
mccli backup delete --name=/clients/DB.SQL-01 --created=2022-03-03 --labelNum-42 --force
1,22531,Unexpected exception occurred.
Attribute Value
--------- ------------------------------------------------
exception 0  ERROR!  Exit code 20: Insufficient privileges
 
 

Immutable Backup behavior if an attempt is made to revert the parameter:

If an attempt is made to revert the parameter, the error "server_expection(MSG_ERR_INVALID_PARAMETERS)" is displayed:

avmaint ocnfig immutablebackups=false --ava
ERROR: avmaint: config: server_exceptin(MSG_ERR_INVALID_PARAMETERS)
 

Rechecking the configuration confirms that the setting is true:

avmaint config | grep immutablebackups
immutablebackups="true"
 

It is not possible to unset or revert this feature once enabled.

 

Immutable Backup behavior with Data Domain:

Enabling Immutable Backup on Avamar DOES NOT enable the Data Domain Retention Lock feature. Any data on the Data Domain is not locked until data protection is configured.

To enable Avamar Immutable Backup and Data Domain Compliance Mode Retention Lock, the Avamar grid must be running one of the following versions:
      • 19.4.0-124 + Hotfix Suite
      • 19.7.0-82 + Hotfix Suite
      • 19.8+
Note: Avamar version 19.4.0-116 does NOT support the Data Domain Retention Lock.
 

The following article provides the steps to enable Avamar Immutable Backup and Data Domain Compliance Mode Retention Lock: Avamar: Enabling Avamar Immutable Backup and Data Domain Compliance Mode Retention Lock.

Affected Products

Avamar
Article Properties
Article Number: 000196948
Article Type: How To
Last Modified: 11 نوفمبر 2025
Version:  17
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.