Avamar: How To Retrieve and Understand the Data Domain Details from an Avamar grid

Summary: The purpose of this article is to understand how to gather and interpret the information about a Data Domain attached to an Avamar grid.

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

The purpose of this article is to:
  • Gather and interpret the information about a Data Domain when attached to an Avamar grid.
  • Provide a basic understanding of Data Domain details relevant to an Avamar and Data Domain integration.
 

Section 1: Retrieve the Data Domain Information.

Perform the below steps to gather and interpret the information about a Data Domain attached to an Avamar grid:

1. Log in to the Avamar Utility Node as admin.

2. Locate information regarding the attached Data Domain using the Avamar command "ddrmaint read-ddr-info":
(Highlighted are some of the key pieces of information which are explained in Section 2.)

Example 1:

ddrmaint read-ddr-info
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<avamar dpnid="xxxxxxxxx" version="2">
  <datadomain count="1">
    <ddrconfig client-map-default="true" ddos-version="5.4.0.8-404909" ddrcreatetime="xxxxxxxxxx" 
        ddrid="xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" hostname="10.xxx.xxx.xx" index="1" max-streams="50" 
        modelno="DD690" password="xxxxxxxx/xxx==" serialno="xxxxxxxxxxxx" username="Avamar-DD">
      <snmp community="public1">
        <ports getter-setter="161" trap="163">
        </ports>
      </snmp>
      <client-map>
      </client-map>
    </ddrconfig>
  </datadomain>
</avamar>
 

Example 2:

ddrmaint read-ddr-info
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<avamar dpnid="xxxxxxxxx" version="3">
  <datadomain count="1">
    <ddrconfig client-map-default="true" ddos-version="5.4.0.8-404909" ddrcreatetime="xxxxxxxx" 
        ddrid="xxxxxxxxxxxxxxxxxx1" gsan-backup-target-default="false" hostname="10.xxx.xxx.xx" 
        index="1" instant-access-limit="1" max-streams="40" max-streams-for-cp-backup="0" modelno="DD690" 
        password="xxxxxxxxx/xxxx==" serialno="xxxxxxxxx" username="Avamar-DD">
      <snmp community="IL7dsxkpJKjHM31dCP4j/w==">
        <ports getter-setter="161" trap="163">
        </ports>
      </snmp>
      <client-map>
      </client-map>
    </ddrconfig>
  </datadomain>
</avamar>
 

3. The Avamar command "mccli dd show-prop" can be used to query the overall status of the Data Domain:

mccli dd show-prop
0,23000,CLI command completed successfully.
Attribute                               Value
--------------------------------------- --------------
Hostname                                10.xxx.xxx.xx
Total Capacity (post-comp size)         5077.9 GiB
Server Utilization (post-comp use%)     4%
Bytes Protected                         0 bytes
File System Available (post-comp avail) 4888.3 GiB
File System Used (post-comp used)       189.6 GiB
User Name                               Avamar-DD
Default Replication Storage System      Yes
Maximum Streams                         50
Maximum Streams Limit                   90
DDOS Version                            5.4.0.8-404909
Serial Number                           xxxxxxxx
Model Number                            DD690
Monitoring Status                       OK
 

Section 2: Understanding the Output:

avamar dpnid="xxxxxx"

When a Data Domain is added to an Avamar grid, a data structure called an MTree (or Avamar LSU) is created. The dpnid can be used to identify the Avamar MTree on the Data Domain.

The corresponding dpnid value can be retrieved from Avamar by using the Avamar command "avmaint hfscreate":

avmaint hfscreate 
1234567890
 

hostname="10.xxx.xxx.xx" 

This is the hostname of the interface on the Data Domain which is used to communicate with Avamar.

The Data Domain commands "net show settings" and "net show hardware" (in admin-se mode) can be used to find the network interface information about the Data Domain:

net show settings
port   enabled   DHCP   IP address      netmask          type   additional setting         /prefix length
----   -------   ----   -------------   --------------   ----   ------------------
eth0   yes       no     10.xxx.xxx.xx   255.xxx.xxx.x    n/a
eth1   yes       no     10.xxx.xxx.xx   255.xxx.xxx.x    n/a
----   -------   ----   -------------   --------------   ----   ------------------
  
net show hardware
Port   Speed      Duplex   Supp Speeds   Hardware Address    Physical   Link Status
----   --------   ------   -----------   -----------------   --------   -----------
eth0   1000Mb/s   full     10/100/1000   00:15:17:c1:f2:44   Copper     yes
eth1   1000Mb/s   full     10/100/1000   00:15:17:c1:f2:45   Copper     yes
----   --------   ------   -----------   -----------------   --------   -----------
 

index="1"

When more than one Data Domain is attached to an Avamar, it is identified using the index starting from 1. A second Data Domain would have "index=2".

By default, if the backups are stored on Avamar, the client logs would have index=0 (which means the backups are stored on Avamar).

serialno="xxxxxxxx"

This is the Data Domain serial number (similar to the Avamar systemid) which is used to uniquely identify the Data domain.

The Data Domain command "system show serial" (in admin-se mode) can be used to retrieve the DD serial number:

system show serial
Serial number: AUDVCE12345ABC
 

username="Avamar-DD"

This is the DDBoost username that was used on the Avamar to add the Data Domain. The same username is used by Avamar to communicate with the Data Domain using the DDBoost API.

The DDBoost username can be retrieved from the DD using the Data Domain command "ddboost user show":
(Pre 5.5.0, the command was "ddboost show user-name")

ddboost user show
DD Boost user   Using Token Access
-------------   ------------------
Avamar-DD       -
-------------   ------------------
 

snmp community="public1" or snmp community="IL7dsxkpJKjHM31dCP4j/w=="

This value gives the SNMP community string that Avamar uses to poll the Data Domain system status.

This same can be verified from the Data Domain by using the Data Domain command "snmp show config":

snmp show config
General Configuration
---------------------
   SNMP sysLocation:HOP
   SNMP sysContact: test_test@emc.com
 
SNMP v2c Configuration
----------------------
   Community    Access      Hosts
   ----------   ---------   -----
   public1      read-only
   public11     read-only
   publicuser   read-only
   ----------   ---------   -----
 
   Trap Host              Port   Community
   --------------------   ----   ---------
   hop-avamar1-internal   163
   hop-4s-1x3-util        163
   ave701                 163
   137.xxx.xx.xxx         163
   hop-4s-sing-2          163
   --------------------   ----   ---------
 
SNMP v3 Configuration
---------------------
   User   Access   Authentication Protocol   Privacy Protocol
   ----   ------   -----------------------   ----------------
   ----   ------   -----------------------   ----------------
 
   Trap Host   Port   User
   ---------   ----   ----
   ---------   ----   ----
 
 
References:

Additional Information

To find the names of the mtrees (aka storage units) on the Data Domain, use the Data Domain command "mtree list" (in admin-se mode): 

mtree list
Name                           Pre-Comp (GiB)   Status
----------------------------   --------------   ------
/data/col1/avamar-1320791855              0.0   RW
/data/col1/avamar-1360598502              0.0   RW
/data/col1/avamar-1373047090              0.0   RW
/data/col1/avamar-1373304886             39.0   RW
/data/col1/avamar-1392825009              0.0   RW
/data/col1/avamar-1393865159              0.0   RW
/data/col1/backup                      5719.3   RW
----------------------------   --------------   ------
 D    : Deleted
 Q    : Quota Defined
 RO   : Read Only
 RW   : Read Write
 RD   : Replication Destination
 RLGE : Retention-Lock Governance Enabled
 RLGD : Retention-Lock Governance Disabled
 RLCE : Retention-Lock Compliance Enabled
 
 

The DDBoost user on the Data Domain must have admin rights (which means it can read/write) on the DD. 

This can be verified by using the Data Domain command "user show list" (in admin-se mode):

user show list 
User list from node "localhost".
Name            Uid   Role    Last Login From   Last Login Time            Status    Disable Date
-------------   ---   -----   ---------------   ------------------------   -------   ------------
sysadmin        xxx   admin   <unknown>         Tue Apr 29 11:32:30 2014   enabled   never
administrator   xxx   user    <unknown>         never                      enabled   never
ostuser         xxx   admin   <unknown>         never                      enabled   never
Avamar-DD       xxx   admin   <unknown>         Tue May 20 07:51:56 2014   enabled   never
dd-avamar       xxx   admin   <unknown>         never                      enabled   never
-------------   ---   -----   ---------------   ------------------------   -------   ------------
5 users found. 

Affected Products

Avamar, Avamar Server
Article Properties
Article Number: 000033975
Article Type: How To
Last Modified: 17 Jun 2025
Version:  9
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.