Avamar: Resolve 'Reached the Maximum Number' Error in Instant Access Restore
Summary: Instant Access (IA) restore fails with "Reached the maximum number of instant access sessions that are allowed on the Data Domain system."
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.
Symptoms
Instant Access (IA) restore job does not complete with error:
Reached the maximum number of instant access sessions that are allowed on a Data Domain system.
Cause
The Data Domain object in Avamar only has "1" stream that is configured for Instant Access.
Resolution
- Verify the Data Domain version. If the Data Domain version is before 6.0, then only one Instant Access stream is allowed. Otherwise, Instant Access streams can be set up to 32.
- Log in to the Avamar server as admin and run:
ddrmaint read-ddr-info --format=full
admin@av-server:~/>: ddrmaint read-ddr-info --format=full ====================== Read-DDR-Info ====================== System name : dd-server System ID : 63719A6C285F1AF9379190F02BD5EF48CC1A2458 DDBoost user : ddboost System index : 1 Replication : True CP Backup : True Model number : DD VE Version 5.0 Serialno : AUDVXNR73ESKXR DDOS version : 7.2.0.95-692608 System attached : 2023-07-17 14:50:03 (1689605403) System max streams : 20 RL Mode : -1 RL Status : -1 admin@av-server:~/>:
- Verify the Instant Access Limit flag values:
mccli dd show-prop --xml | grep InstantAccessLimit
admin@av-server:~/>: mccli dd show-prop --xml | grep InstantAccessLimit <InstantAccessLimit>10</InstantAccessLimit> admin@av-server:~/>:
- Verify that Instant Access restore is allowed in
mcserver.xml:
grep "ddr_instant_access_enabled" /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml
admin@av-server:~/>: grep "ddr_instant_access_enabled" /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml <entry key="ddr_instant_access_enabled" value="true" /> admin@av-server:~/>:
- Verify that the Instant Access limit modification is allowed in
mcserver.xml:
grep "ddr_can_modify_ir_limit" /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml
admin@av-server:~/>: grep "ddr_can_modify_ir_limit" /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml <entry key="ddr_can_modify_ir_limit" value="false" /> admin@av-server:~/>:
- Back up the
mcserver.xmlfile:
cp -p /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml /usr/local/avamar/var/mc/server_data/prefs/x-mcserver.xml-`date -I`.bkp
admin@av-server:~/>: cp -p /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml /usr/local/avamar/var/mc/server_data/prefs/x-mcserver.xml-`date -I`.bkp admin@av-server:~/>: ls -ltrh /usr/local/avamar/var/mc/server_data/prefs/*mcserver.xml* -rw-r----- 1 admin admin 59K Aug 13 09:21 /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml -rw-r----- 1 admin admin 59K Aug 13 09:21 /usr/local/avamar/var/mc/server_data/prefs/x-mcserver.xml-2021-09-30.bkp admin@av-server:~/>:
- Edit the
mcserver.xmlusing vi and change the parameter value below:
From:
<entry key="ddr_can_modify_ir_limit" value="false" />
To:
<entry key="ddr_can_modify_ir_limit" value="true" />
- Save the change and verify if the change was successful.
grep "ddr_can_modify_ir_limit" /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml
admin@av-server:~/>: grep "ddr_can_modify_ir_limit" /usr/local/avamar/var/mc/server_data/prefs/mcserver.xml <entry key="ddr_can_modify_ir_limit" value="true" /> admin@av-server:~/>:
- Restart the Management Console Service (MCS):
mcserver.sh --restart --v --force
- Edit the Data Domain from the Avamar User Interface (AUI), Avamar Administrator console or through mccli command.
- Verify if the value changed:
mccli dd show-prop --xml | grep InstantAccessLimit
admin@av-server:~/>: mccli dd show-prop --xml | grep InstantAccessLimit <InstantAccessLimit>32</InstantAccessLimit> admin@av-server:~/>:
- Start IA restore jobs to verify that multiple IAs are now allowed.
- Resume the backup scheduler service and check if all services are up and enabled:
dpnctl start sched dpnctl status
admin@av-server:~/>: dpnctl start sched Identity added: /home/admin/.ssh/admin_key (/home/admin/.ssh/admin_key) dpnctl: INFO: Resuming backup scheduler... dpnctl: INFO: Backup scheduler resumed. dpnctl: INFO: No /usr/local/avamar/var/dpn_service_status exist. admin@av-server:~/>:
admin@av-server:~/>: dpnctl status Identity added: /home/admin/.ssh/admin_key (/home/admin/.ssh/admin_key) dpnctl: INFO: gsan status: up dpnctl: INFO: MCS status: up. dpnctl: INFO: emt status: up. dpnctl: INFO: Backup scheduler status: up. dpnctl: INFO: Maintenance windows scheduler status: enabled. dpnctl: INFO: Unattended startup status: enabled. dpnctl: INFO: avinstaller status: up. dpnctl: INFO: ddrmaint-service status: up. dpnctl: INFO: ESE status: up. admin@av-server:~/>:
Affected Products
Avamar, Avamar Client for VMware, Avamar ServerArticle Properties
Article Number: 000317425
Article Type: Solution
Last Modified: 07 May 2025
Version: 2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.