Dell EMC Avamar
Dell EMC Avamar
Dell EMC Avamar
Release Notes
Rev. 01
November 2020
Dell Inc.
These release notes contain supplemental information about the Avamar 19.4 release. Topics include:
• Revision history.........................................................................................................................................................................................................2
• Product description..................................................................................................................................................................................................2
• New features and changes.................................................................................................................................................................................... 2
• Fixed problems.......................................................................................................................................................................................................... 6
• Known problems and limitations........................................................................................................................................................................... 6
• Environment and system requirements............................................................................................................................................................29
• International language support........................................................................................................................................................................... 30
• Technical notes.......................................................................................................................................................................................................33
• Documentation........................................................................................................................................................................................................40
• Installation and upgrade........................................................................................................................................................................................43
• Troubleshooting and getting help...................................................................................................................................................................... 45
Revision history
The following table presents the revision history of this document:
Product description
Avamar is backup and recovery software with integrated data deduplication technology. Avamar solves the challenges that are
associated with traditional data protection, enabling fast, reliable backup and recovery for remote offices, VMware
environments, Data Domain and Cloud Tier, and data center LANs.
Unlike traditional solutions, Avamar reduces the size of backup data at the source—before it transfers across the network and
stores to disk. As a result, Avamar delivers fast, efficient daily full backups despite slow or congested infrastructure, and data
encryption for added security. Avamar uses patented RAIN technology for high availability, and a scalable grid architecture
enables you to upgrade capacity and performance when necessary.
NOTE: Data Domain is now PowerProtect DD. References to Data Domain or DD systems in this documentation, in the UI,
and elsewhere in the product include PowerProtect DD systems and older Data Domain systems. In many cases the UI has
not yet been updated to reflect this change.
2
Client enhancements
Avamar 19.4 features the following client-related changes and enhancements:
● NDMP backup that was done from Unity can now be restored to PowerStore. Avamar can restore data to the original NAS
system, in case you have moved to PowerStore from Unity.
● Manage client-initiated backups and client-initiated file system restores from Avamar Administrator and AUI.
Virtual Disk Development Kit (VDDK) 7.0 and SLES 12 SP5 proxy
enhancements
Avamar 19.4 features the following VDDK-related changes and enhancements:
● Avamar 19.4 describes the VDDK 7.0 update to support vSphere 7.0. VDDK 7.0 also provide additional support for ESXi 7.0
and vCenter Server 7.0. There is an upgrade available for proxy host operating system to SLES 12 SP5.
3
The operating system upgrade does not affect the functionality or interfaces of the Avamar software. However, take note of
the following important points:
● The Avamar platform operating system security rollup supports Avamar servers that run SLES 12 SP5 starting with release
2020R1.
● The upgrade changes some underlying operating system commands, such as the move from systemv to systemd.
● The upgrade also updates some underlying libraries and dependencies.
● All new installations of Avamar 19.4 and SLES 12 deploy with a 1 GB /boot partition to improve compatibility with future
kernel upgrades. Upgrades from SLES 11 preserve the existing 100 MB /boot partition.
Prerequisites
Review the following items when you create your deployment or upgrade plan:
● All nodes in the server must run one of the following operating systems:
○ SLES 12 SP5
○ SLES 12 SP4
○ SLES 11 SP4
○ SLES 11 SP3
○ SLES 11 SP1
● Avamar 7.5.1 or later is a prerequisite for the upgrade to Avamar 19.4.
If the server or NDMP accelerator node runs an older release, upgrade to a supported version before you start the upgrade
to Avamar 19.4.
Before you upgrade, verify that the Avamar server or NDMP accelerator node meets the prerequisites.
Upgrades from older releases of Avamar or the NDMP accelerator client software might require intermediate upgrades to a
supported Avamar release and operating system. Ensure that your upgrade plan includes any necessary incremental steps,
and that the server or NDMP accelerator node meets the prerequisites for any intermediate upgrades.
You cannot upgrade an Avamar server to 19.4 if it uses Blowfish for its data-at-rest encryption. Instead, install a new 19.4
server and migrate the data from the old server.
The Avamar software upgrade workflow package integrates both the operating system upgrade to SLES 12 SP5 and the
software upgrade to Avamar 19.4. The upgrade workflow migrates the operating system and Avamar software configurations
and then replaces the existing system partitions.
Initial startup might take longer as the upgrade workflow installs necessary drivers and firmware, and configures new packages.
The upgrade workflow also takes checkpoints and performs health checks before and after the upgrade. The operating system
upgrade process is the same for AVE and for ADS single-node and multi-node servers.
For NDMP accelerator nodes, the process is similar. However, in this case, the Avamar accelerator upgrade workflow package
contains the new operating system and the new accelerator software.
You cannot upgrade VMware proxies from one operating system to another by using the ISO file. Instead, remove the existing
proxies and use the Proxy Deployment Manager (PDM) to deploy replacement Avamar 19.4 proxies. Remove any proxies that
you manually deployed. The Avamar for VMware User Guide provides more information.
4
FIPS mode
The Avamar software upgrade workflow disables Federal Information Processing Standard (FIPS) mode. If FIPS mode is enabled
before the upgrade, you must reenable FIPS mode after the upgrade completes.
NOTE: The upgrade workflow disables FIPS if the original version is 19.1. If the original version before upgrade is 19.3 and
later, upgrade workflow will not disable FIPS.
The Avamar Product Security Guide provides more information about FIPS mode.
Steps
1. Through the AUI:
For Avamar 18.1 and later, the AUI provides the preferred graphical method.
a. Log in to the AUI.
b. In the AUI header pane, click .
The About dialog box opens, and lists the installed Avamar version.
2. Through the command line:
Where the AUI is not available, verify the Avamar component versions with the following commands.
a. Log in to the server as admin.
b. Check the MCS version by typing the following command:
mcserver.sh --version
Information similar to the following is displayed in the command shell:
version: 19.1.0-38
c. Check the gsan version by typing the following command:
gsan --version
Information similar to the following is displayed in the command shell:
version: 19.1.0-38
build date: Apr 25 2019 19:23:45
d. Check the avtar version by typing the following command:
avtar --version
Information similar to the following is displayed in the command shell:
version: 19.1.0-38
build date: Apr 25 2019 19:32:16
Verify that the Avamar component versions match.
Compatibility updates
Avamar 19.4 features the following software compatibility updates.
● Avamar client, server, and storage node support for Data Domain operating system (DDOS) versions 7.3.x
● Avamar client support for:
○ 64-bit versions of Red Hat Enterprise Linux (RHEL) 7.8 and 8.2
○ 64-bit version of SUSE Linux Enterprise Server (SLES) 15 SP2
5
○ 64-bit versions of CentOS 7.8 and 8.2
○ MacOS 10.15.4
○ 64-bit version of Windows 10 2004
○ 64-bit versions of Oracle Linux 7.8 and 8.2
○ AIX 7.2 TL4
● NDMP support for:
○ Isilon update to oneFS 9.0
○ Ontap version 9.7
● Avamar client support for the 64-bit version of Debian 10 and Ubuntu 19.04 and 19.10
● Avamar SAP-Oracle support for:
○ Oracle-Linux 7
○ Solaris Sparc 11.4
○ Red Hat Enterprise Linux (RHEL) 8
● Avamar Oracle support for Solaris Sparc 11.4
● Avamar DB2 11.5 support for:
○ Windows server 2019
○ Red Hat Enterprise Linux (RHEL) 8.1
● NDMP support for:
○ PowerStore versions 1.0
○ PowerMax
○ Oracle ZFS version 8.9.x
● Cloud Director Data Protection Extension (CD DPE) support for Cloud Director 10
● Avamar Proxy support vSphere 7.0
● Instant Access support vSphere 7.0
● vCenter plug-in support vSphere 7.0
Updated software and database compatibility information is provided in the E-LAB Navigator at https://
elabnavigator.emc.com/eln/elnhome.
Fixed problems
This section lists the problems that were observed in previous releases of Avamar that are resolved in Avamar 19.4 release.
6
Avamar server known problems and limitations
The following list describes known problems for this release of the Avamar server:
325781 AWS: build 19.4.0.77 Kernel error is observed during boot time of an NA
kernel error: Cannot AWS instance: Cannot get hvm parameter
get hvm parameter CONSOLE_EVTCHN
CONSOLE_EVTCHN
320300 ADS4T-SLES11- After kickstart with SLES 12 SP5 v8 ISO, the Run ethtool -s to reset the
SP4-64-0001.02.iso and eth0 interface runs at 100 Mbps on some gen4t advertised link speed to
Gen4T, eth0 (shared port) nodes, which are not as expected. If same node is 1000Mbps.
sometimes auto- kickstarted with SLES 11 SP3 1.64, the eth0
negotiates to 100 Mbps interface runs at 1000 Mbps. These nodes only
run 1000 Mbps with SLES 11 SP3 and run 100
Mbps with SLES 11 SP4, SLES 12 SP4, or SLES 12
SP5.
321198 AdaptecEventMonitorServ On ADS Gen4T with SLES 12 SP5, systemctl NA
ice.service incorrectly status
reported as inactive AdaptecEventMonitorService.service
(seen as EventMonitor in 'ps' listings) incorrectly
shows the status as Inactive, even though the
service is up.
319081 AWS m5: get kernel error Kernel error is observed during boot time of an NA
EDAC skx: Can't get tolm/ AWS m5 instance. It is an indicator that the VM
tohm every boot time Host implements the Skylake platform
incompletely; the tohm missing message is
printed when the operating system tries to
decode the EDAC information, and fails to access
the required I/O registers. The right way is to
implement those registers in the VM Host
emulation.
317657 hwfaultd - add check for When the file system is full, an undefined NA
file system free space behavior is observed on ADS.
approaching 100% full
321131 Avamar upgrade failed at The root cause of failure of the Avamar Upgrade NA
Install Gen4T system tools workflow is claimed to be an underlying system
(95 of 170) pathology that is particular to
a4t84d8.datadomain.com. In the case of
7
Table 2. Avamar server known problems and limitations (continued)
Bug Problem statement Description Workaround
number
a4t84d8.datadomain.com, the get-platform-logs
command appeared to be unresponsive without
completing, which is a strong indication that the
BMC on a4t84d8.datadomain.com is in a bad
state. If the BMC remains in a bad state, then it
might be necessary to do a power-drain
procedure, which involves shutting down the
node as gracefully as it will allow, and then pulling
utility power - either via remote power control or
by physically pulling the power cords - waiting a
minute or so, and then re-connecting power and
restarting the node.
299817 After root-to-root MC MC restore fails with clients violate foreign key The support team must update db
esc 29070 restore fails with "clients" constraint after root-to-root replication. schema with the provided script
violates foreign key manually.
constraint
319461 WC - Win FS Restore - To turn the xflag into official flag, a new NA
esc 37431 SR<16968788> - Not all procedure in flag handling that modifies many
permissions are restored APIs must be included.
when using --restore-acls-
only flag
321158 When FIPS is on, every This issue is being investigated by SUSE. The NA
time is boots, there are fatal errors reported seem to be safe to ignore.
dracut-pre-trigger
modprobe FATAL Model
not found messages on
console
318619 Updating gen4t-sys zip to In gen4t-sys-2.3, which is the payload included NA
include latest ipmiutil-emc with Avamar 19.3.0-122 , it is still bundling the
rpm older ipmiutil-emc-2.7.9-8.x86_64.rpm. The
required fix must bundle ipmiutil-
emc-2.7.9-11.x86_64.rpm with a new gen4t-
sys-2.4.zip, and update the workflows to include
the gen4t-sys-2.4.zip payload.
317003 urgent restore fails with Urgent restore fails with an error when the SSD If the SSD is empty, using avmaint
esc 36763 error Failed to is empty. stripestate to bring the stripe
retrieve backup online sets it right and the stripe
list from account is rebuilt because it is missing
xxx (error code 18 from the disk.
MSG_ERR_NOT_PRESENT
)
320741 When VM backup jobs are VM backup job work orders are not created Remove duplicated entries in
esc 37619 configured to connect to correctly if the backup is to a specific Data MCDB.
Data Domain, the Domain in that dedicate customer environment.
proxyDirectives section of This is because of the incorrect database
the work order are not operations in that environment, which caused to
created have duplicated entries in MCDB.
322055 Serviceability report is Serviceability report becomes unresponsive for an NA
unresponsive for 1 hour on hour because /usr/local/avamar/bin/
multi-node Avamar rptSiteInventory.pl is unresponsive. This
issue is observed when the SUDO is not working
on data node.
314532 Command output The output of the systemctl status NA
indicates that zzdpn.service command indicates that the
zzdpn.service failed zzdpn.service failed, even if all DPN services
8
Table 2. Avamar server known problems and limitations (continued)
Bug Problem statement Description Workaround
number
such as GSAN, MCS, and avinstaller are running
normally. This error can be ignored, as there is no
negative impact to functionality of the currently
running server.
NOTE: Operating system-based shutdowns
of the Avamar server can result in data loss.
The section "Powering off or restarting the
server" of the Avamar Administration Guide
provides more information about operating
system shutdown and reboot best practices.
311781 Jetty component on The Jetty component on the Avamar server and Upgrade the Jetty component to
Avamar server and proxy proxy node is not at the minimum recommended a minimum of version 9.4.16.
node requires upgrade version.
310471 MCS running MCS runs syncDisplayNameWithVmware if the NA
syncDisplayNameWithVm Rename VM event name contains ^vmfs/
ware when Rename VM volumes/*.vmx prefix. This issue typically
event name contains .vmx takes a day to correct itself automatically with
prefix the next vCenter synchronization.
309554 IPv4 traffic initiated by In a dual stack environment where both Avamar To avoid any IPv4 traffic, remove
Avamar in a dual stack and Data Protection Central (DPC) have IPv4 and Avamar from DPC, and then re-
environment IPv6 addresses configured, the communication add Avamar.
should occur using IPv6 since this is the preferred
network. However, IPv4 traffic is observed when
Avamar is connecting to the DPC for the first
time.
309181 mcserver.sh --init fails to If you run mcserver.sh with --init or -- NA
esc 34646 run mcrootca successfully restore in the incorrect context, directories
and also fails to decrypt might be deleted. Note that the mcserver.sh
passwords for --init command is designed only for internal
rmi_ssl_keystore_AP/ execution from the workflow framework during a
rootAP and viewuserAP new installation. An error occurs if you execute
the command manually.
46224 Scheduled backups are Scheduled backups are missed during daylight During days when Daylight Saving
missed during daylight savings time transitions Time (DST) transitions occur, if
savings time transitions you have backups that are
scheduled to run during the
following times, the backups do
not occur:
● For the Spring DST transition,
daily backups that are
scheduled during the hour
from 2:00 a.m. through 2:59
a.m. do not occur.
● For the Autumn DST
transition, daily backups that
are scheduled during the hour
from 1:00 a.m. through 1:59
a.m. do not occur.
The interim solution to this
problem is to avoid scheduling
backups during these time ranges,
or to perform an ad-hoc backup
when the scheduled backup does
not occur.
9
Avamar Virtual Edition known problems and limitations
There are no known problems and limitations for this release of the Avamar Virtual Edition (AVE).
326661 Redirected restore from Windows server Redirected restore from Windows server to Linux NA
esc 38896 to Linux fails in 18.2 with path not found fails in Avamar Administrator.
in backup error.
325077 IDPA 2.6.0: Avamar restarts agents Avamar restarts agents when the changing NA
when changing AV password. appliance password. Due to this, all active backup
jobs must be stopped to change password.
324449 ESRS registration for AVE or AV grid ESRS gateway has issues supporting IPv6. Avamar NA
fails in IPv6 configured IDPA appliance. gets wrong response from ESRS Gateway REST
API, which causes Avamar to mark ESRS as
disconnected.
10
Table 5. Avamar Administrator known problems and limitations (continued)
Bug Problem statement Description Workaround
number
263268 Storage utilization capacity of Avamar The storage utilization capacity of Avamar server NA
server node reporting inaccurately node that you displayed in the Avamar
Administrator is approximate and not an exact
value, and has no impact capacity for additional
backups.
52801 Progress Bytes column in the Activity The value that appears in the Progress Bytes NA
Monitor displays different values from column in the Activity Monitor for backups with
one Level 0 backup to the next the Windows File System plug-in is different from
one Level 0 backup to the next for an unchanged
backup set. The issue is a display issue only and
does not affect the validity of the backup itself.
11
Table 7. File level restore client known problems and limitations (continued)
Bug number Problem statement Description Workaround
304444 Files not cleaned up on target device When a workorder failure occurs during a file level NA
when workorder failure occurs during restore on Linux due to insufficient space on the
file level restore on Linux target device, the partially copied files do not get
cleaned up from the target device, which can result
in disk space issues. For example, if restoring 5 GB
of files and the target device has only 2 GB of free
space, the file level restore fails when the device
capacity is reached, but the 2 GB of already copied
files remain on the target device.
Restore operations fail when deselecting a few files from a folder containing 20,000
files
To workaround this issue, complete the following:
1. Use Apache Tomcat to enable Port 8543 which has an unlimited post size. Port 443 has a post size limit and causes restore
operations to fail from folders with 20,000 or more files.
2. Start the Data Protection Backup and Recovery File-Level Restore UI.
3. Browse to https://VMware_Backup_Appliance_Host:8543/flr.
4. Select the files that you are required to restore. Ensure that all the files in the folder are not selected.
12
Table 9. Data Domain system integration known problems and limitations (continued)
Bug Problem statement Description Workaround
number
address so that a
successful connection
can be established.
202755 Avamar backups exceeding Any type of Avamar backup to Data Domain that NA
10 hours require minimum exceeds 10 hours fails if the DDOS version is earlier
DDOS version 6.1.1.5-581137 than 6.1.1.5-581137. Ensure that all Data Domain
systems are updated to this version at a minimum.
175640 Avamar cloud tiering does not Because of Data Domain bug 175640, the Avamar cloud NA
support Data Domain tiering solution does not support Data Domain Hardware
Hardware HA in DDOS 6.0 HA in DDOS 6.0. A patch is available from Data Domain
to resolve this issue.
297904 Replication of Data Domain When you delete the Avamar client from the replication NA
backups to target device target device in the Avamar Management Console UI,
does not occur immediately the replicated Data Domain backups on the device are
when Avamar client is set to "expired." As a result, if you initiate another
deleted from the target replication before garbage collection has completed on
device the target server, the Data Domain backups will not be
immediately replicated to the target device.
If you want to replicate the backups immediately,
manually launch garbage collection on the target server,
and then restart the replication.
51085 New Bytes % displays 0% When performing file system backups to a Data Domain NA
until backup is complete system, the New Bytes % field displays 0% until the
backup completes.
53567 hfscheck fails after clients When you remove clients from the /REPLICATE NA
are removed from the / domain and the client backups are on a Data Domain
REPLICATE domain and then system, the garbage collection process removes the
re-replicated replicated backup files from the Data Domain system
that is the replication destination. If the client is then
replicated to the Data Domain system again,
subsequent hfschecks fail with a
MSG_ERR_DDR_ERROR error.
287264 Changing Data Domain When you configure a Data Domain system using the NA
system from FQDN to IP FQDN of the Avamar server, and then update the
results in error system to use the IP address instead, the update fails
with an error indicating "Failed to connect to Data
Domain system." Knowledgebase article 503612
available on the Support page provides more
information.
288864 Avamar does not display the If a backup is stored on the cloud tier, the Avamar GUI NA
cloud unit name for a backup displays Cloud as the storage location rather than the
that is stored on the cloud exact name of the cloud unit.
tier
300657 Trigger group backup takes With Data Domain Cloud Disaster Recovery (DD Cloud NA
up to 3 minutes in CDR DR) enabled and operating in Advanced Mode,
Advanced Mode interactions between DD Cloud DR and the Avamar
server cause group backups to start approximately 3
minutes after you trigger the backup.
13
All backup clients and plug-ins known problems and limitations
The following list describes known problems for this release of all backup clients and plug-ins.
Table 10. All backup clients and plug-ins known problems and limitations
Bug Problem statement Description Workaround
number
32873 Special ACLs are not supported The avtar process does not support backup or restore of NA
special UNIX and Linux ACLs such as setuid and
setgid bits, or mandatory file lock bits in newer versions
of Linux.
52496 Cluster Configuration Tool fails to In a dual stack environment, when the Avamar server’s NA
activate virtual cluster clients in IPv6 address is used during configuration with the Avamar
dual stack environments Cluster Configuration Tool, the Cluster Configuration Tool
fails to correctly activate virtual cluster clients.
The interim solution to this problem is to use the Cluster
Configuration Tool to create the cluster client, but clear
the Bring the cluster client online and activate it with
the Avamar server checkbox. Then manually create the
virtual cluster client and with Avamar Administrator, and in
Policy Management, edit the client and select the
Activated checkbox in the Edit Client dialog box.
56606 Level 1 backup to Data Domain After a level 0 backup has been performed for a client with NA
with over 16 critical disks may more than 16 critical disks, cache file information for one or
default to level 0 more of the disks may no longer be available. The
subsequent level 1 backups are also performed as level 0.
297679 Manage Dataset for Source Data When creating a Dataset, under Source Data the File/ NA
option has discrepancies for MC Folder Path can only be added manually.
AUI
302911 Backup not supported for Avamar requires a Windows cluster to function as NA
SharePoint farms configured with designed. Configurations on clusterless architectures such
SQL clusterless AAG as SQL clusterless AAG are therefore not supported by
Avamar.
AIX, HP-UX, Linux, CentOS, and Solaris client known problems and
limitations
The following list describes known problems for this release of the Avamar clients for AIX, HP-UX, Linux, and Solaris:
Table 11. AIX, HP-UX, Linux, CentOS, and Solaris client known problems and limitations
Bug number Problem statement Description Workaround
322219 Server is unable to detect plug- The following issues were observed with Oracle, Manually restart the
ins and backup or restore jobs Sybase, DB2, SAP, and Lotus plug-ins for SLES12 avagent service.
are waiting for client. SP4 and SLES 15/15 SP1 platforms:
● Until you manually restart the avagent service,
the server is unable to detect the plug-ins.
● The backup/restore jobs are waiting for the
client until you manually restart the avagent
service.
312367, 312368 SLES version 11 still appears in Several package names in Avamar 19.2, such as NA
some package names AvamarBundle and avinstaller-bootstrap, still
indicate SLES version 11 in the package name.
14
Table 11. AIX, HP-UX, Linux, CentOS, and Solaris client known problems and limitations (continued)
Bug number Problem statement Description Workaround
307231 Limitations to avagent services The following limitations apply to the avagent NA
on SLES 12 SP3 or later service for Avamar on SuSE Enterprise Linux
(SLES) version 12 SP3 or later:
● You can only perform a manual stop and restart
the avagent service after running avregister.
● The avagent service does not start
automatically after a system restart. A manual
restart of avagent is required
26077 Push upgrade on Linux fails for Using Avamar upgrade to push an Avamar client NA
non-default installation location upgrade to a Red Hat Enterprise Linux or SuSE
Linux Enterprise Server client fails when the
Avamar client software is installed in a non-default
location. The use of the rpm option --relocate
to install the Avamar client in a non-default location
causes subsequent push upgrades to fail.
249425 Unable to configure Linux Fast Linux Fast Incremental cannot be configured on NA
Incremental at runlevel 5 in SUSE 12 filesystems that are protected at runlevel
SUSE12 5. The interim solution to this problem is to
configure the file systems to be protected in run
level 3.
Table 12. Microsoft Exchange VSS plug-in known problems and limitations
Bug number Problem statement Description Workaround
Data Domain token Avamar release 7.5 introduced Data Domain token NA
authentication issue with clients authentication for the Microsoft application plug-ins.
earlier than Avamar release 7.5 Data Domain token-based authentication is not
supported for clients before release 7.5. The interim
solution to this problem is to upgrade the clients to
release 7.5, or to disable token-based authentication
on the Avamar server.
54465 Restore of an incremental If you restore a full backup of an Exchange database Rerun the restore
backup fails after restore a full and then you restore a subsequent incremental and use the Move
backup backup of the database, the restore fails. logs path plug-in
option to move the
existing log files to a
different directory.
Table 13. Microsoft Hyper-V VSS plug-in known problems and limitations
Bug number Problem statement Description Workaround
323821 [Windows 2019]AV-Hyper-V VSS VSS synthetic full original location restores and NA
Synthetic full restores fail with an redirected-restores fail with error: Hyper-V VSS
error: Hyper-V VSS Writer Writer failed in Post-Restore event
failed in Post-Restore on Windows 2019 S2D and on Windows
15
Table 13. Microsoft Hyper-V VSS plug-in known problems and limitations (continued)
Bug number Problem statement Description Workaround
event on Windows 2019 S2D 2019. For Windows 2019, RCT workflow is
and on Windows 2019 recommended.
324145 [Windows 2019] AV-Hyper-V VSS VSS redirected restores fail with error: Hyper-V NA
redirected restores fail with an VSS Writer failed in Post-Restore
error: Hyper-V VSS Writer event on Windows 2019 S2D and on
failed in Post-Restore Windows 2019. For Windows 2019, RCT workflow
event on Windows 2019 S2D is recommended.
and on Windows 2019
274173 Command-line interface restores Restore operations from the command-line interface NA
from backups on Cloud fail for do not work for Microsoft application plug-ins (SQL,
Microsoft application plug-ins SharePoint, Exchange, Hyper-V) when the backup
resides in the Cloud.
For these restore operations, use the Avamar
Management Console's Avamar Administrator
window.
290914 Logfile option cannot be used for When performing backups for Microsoft application NA
Hyper-V, SharePoint, and plug-ins including Hyper-V, SharePoint and
Exchange backups to specify an Exchange, you cannot use the logfile option to
alternate path for log file specify an alternate file path location for the
generation generated log files. Logs can only be generated in
the default path, C:\Program Files\avs\var
\.
313896 [Windows 2019]For SMB VMs RCT Whenever we have VMs hosted on secondary nodes NA
Incremental backup fails for vms or remote nodes(passive nodes) other than the
hosted on remote nodes(passive primary node the incremental backups fail with
nodes) unable to get the RCT extents error.
Data Domain token authentication Avamar release 7.5 introduced Data Domain token NA
issue with clients earlier than authentication for the Microsoft application plug-ins.
Avamar release 7.5 Data Domain token-based authentication is not
supported for clients before release 7.5. The interim
solution to this problem is to upgrade the clients to
release 7.5, or to disable token-based authentication
on the Avamar server.
322762 esc Avamar Config checker is unable to Avamar Config Checker fails to get the version of NA
38247 get the integration services version Integration Services for VMs hosted on Hyper-V
for Hyper-V VM in Hyper-V 2016/2019 nodes.
2016/2019 environment.
Table 14. Microsoft SharePoint VSS plug-in known problems and limitations
Bug number Problem statement Description Workaround
246462 Granular Level Recovery on SharePoint GLR may fail with the following error: Ensure that the latest
SharePoint 2007 with Invalid mount letter, most likely updates for Windows
Windows 2008 R2 fails caused by AvFS mount failure. 2008 R2 have been
when most recent Windows installed.
update is not installed
Data Domain token Avamar release 7.5 introduced Data Domain token NA
authentication issue with authentication for the Microsoft application plug-
clients earlier than Avamar ins. Data Domain token-based authentication is not
release 7.5 supported for clients before release 7.5. The
16
Table 14. Microsoft SharePoint VSS plug-in known problems and limitations (continued)
Bug number Problem statement Description Workaround
interim solution to this problem is to upgrade the
clients to release 7.5, or to disable token-based
authentication on the Avamar server.
54465 Restore of an incremental If you restore a full backup of an Exchange Rerun the restore and
backup fails after restore a database and then you restore a subsequent use the Move logs path
full backup incremental backup of the database, the restore plug-in option to move
fails. the existing log files to a
different directory.
Table 15. Microsoft SQL Server plug-in known problems and limitations
Bug number Problem statement Description Workaround
49416 Restore of differential backup After a database is removed from an availability NA
after database is removed group, restores from differential backups of the
from availability group may fail database might fail.
Redirected restores fail when Redirected restore using the Restore to NA
location is set in Restore different SQL server instance or location
Options dialog box option fails when the location is set using the
Set Destination field in Restore Options dialog
box. To work around this issue, set path on the
Restore Command Line options page.
54465 Restore of an incremental If you restore a full backup of a SQL database Rerun the restore
backup fails after restore a full and then you restore a subsequent incremental and use the Move
backup backup of the database, the restore fails. logs path plug-in
option to move the
existing log files to a
different directory.
Data Domain token Avamar release 7.5 introduced Data Domain NA
authentication issue with token authentication for the Microsoft
clients earlier than Avamar application plug-ins. Data Domain token-based
release 7.5 authentication is not supported for clients
before release 7.5. The interim solution to this
problem is to upgrade the clients to release 7.5,
or to disable token-based authentication on the
Avamar server.
17
Microsoft Windows client known problems and limitations
The following list describes known problems for this release of the Avamar Client for Windows:
18
Oracle database plug-in known problems and limitations
The following list describes known problems for this release of the Avamar Plug-in for Oracle:
48182 RMAN CLI backups with RMAN CLI backups with Oracle RAC configuration do not NA
Oracle RAC configuration reflect the scan name in the Activity window. The interim
do not reflect the scan solution for this problem is to copy $ORACLE_RAC_VAR/
name in Activity window avoracle.cmd to $ORACLE_RAC_VAR/clientlogs/
avoracle.cmd.
273929 Best practices for Oracle When a cloud tiering policy is configured for Avamar plug- The best practice to avoid
and Lotus plug-ins to ins for Oracle and Lotus, an earlier Full/L0 backup that is this issue is to select a
avoid issues with performed through the plug-in may already have been Full/L0 backup interval
incremental backup when moved to the cloud tier. If this problem is the case, that is smaller than the age
using a cloud tier subsequent incremental/L1 backups do not complete, threshold configured for
because no parent full/L0 backup is found on the active moving backups to cloud
tier. tier. This step guarantees
that the last Full/L0
For the Oracle plug-in, if this issue is encountered, the
backup is always available
following error message is written to the plug-in log and
in the Active tier. For
the incremental backup fails: An incremental
Oracle and Lotus plugins,
backup was requested but there is no
after the incremental
previous full backup. Please perform a
backup failure, you can
full backup before any subsequent full
either recall the last
backups.
Full/L0 backup from the
For the Lotus plug-in, the following error message is cloud tier, or perform a
written to the plug-in log and the incremental backup new Full/L0 backup
fails: No Full backup found, Incremental instead of the incremental.
backups cannot be taken without a full Then subsequent
backup incremental backups
complete successfully.
277013 Data Domain On Windows systems, when the Avamar Plug-in for NA
authentication problem Oracle does not have sufficient rights to the <install-
when Avamar Plug-in for dir>\avs\etc\.tmp directory, the Data Domain is
Oracle installation has unable to write its authentication certificate to the
insufficient rights directory, and backups fail. Interim solutions to this
problem are:
19
Table 18. Oracle database plug-in known problems and limitations (continued)
Bug Problem statement Description Workaround
number
281689 Known problem in When a backup is initiated from the Avamar Administrator NA
Oracle, DB2, and Sybase and fails in the late stages of the backup operation, it is
plug-in for snapview possible that the plug-in application considers the backup
failures to be successful. You cannot perform a restore operation
on this backup from Avamar Administrator. Restoring
such a backup might still be possible by using a command-
line restore. This step is documented as a supported
operation in the Oracle Plug-in user guide.
How to identify the issue:
1. The database reports the backup as successful,
although the Avamar Administrator reports it as failed.
2. Failed backup log messages include an error message
that is generated during the late stages of the backup.
For the Avamar Plug-in for Oracle, DB2, and Sybase
ASE, the failure is logged with the error message
Failed to create the snapview.
However, the database data has been
successfully backed up and is marked
as a hidden backup. Restore is
available through CLI only. See the
plug-in documentation for information
about restoring hidden backups.
283392 Running two RMAN When two concurrent backup sessions are initiated on the NA
backups on same same database by using Oracle RMAN CLI by using a task
database results in file (for monitoring through the Avamar Administrator),
unexpected results one of the backups may fail. The following error message
displays on the CLI:
20
IBM DB2 plug-in known problems and limitations
The following list describes known problems for this release of the Avamar Plug-in for DB2:
21
SAP with Oracle plug-in known problems and limitations
The following list describes known problems for this release of the Avamar Plug-in for SAP with Oracle:
Table 20. SAP with Oracle plug-in known problems and limitations
Bug number Problem statement Description Workaround
51870 Oracle Optimized Deduplication When backing up a SAP with Oracle database to a NA
option is not supported with Data Data Domain system, the Oracle Optimized
Domain Deduplication option is not supported.
22
Table 21. Sybase ASE plug-in known problems and limitations
Bug number Problem statement Description Workaround
Table 22. IBM Lotus Domino plug-in known problems and limitations
Bug Problem statement Description Workaround
number
314742 Domino plug-in cannot The Avamar Plug-in for Lotus Domino is unable to Ensure that the DAOS folder
restore NLO file with restore an individual NLO file when the overwrite name in the NLO path is in
overwrite option selected option is selected due to case-sensitive path ALL CAPS.
comparison for the NLO path.
305687 Avlotus backups complete On the Lotus plug-in for some AIX systems, a NA
successfully but report backup is displayed as completed with errors, even
"[AvlotusMonitorCancel]INT when the backup is successful and available for
ERNALERROR: recovery, due to an assertion failure that occurs
<0001>assert error" while unlocking a mutex at the end of the backup.
This error can be ignored.
239003 Server field in Activity The Server field in the Activity windows is blank NA
window is blank for the CLI for restore operations that are performed on the
restore operation command line.
273929 Best practices for Oracle When a cloud tiering policy is configured for The best practice to avoid this
and Lotus plug-ins to avoid Avamar plug-ins for Oracle and Lotus, an earlier issue is to select a Full/L0
issues with incremental Full/L0 backup that is performed through the backup interval that is smaller
backup when using a cloud plug-in may already have been moved to the cloud than the age threshold
tier tier. If this problem is the case, subsequent configured for moving
incremental/L1 backups do not complete, because backups to cloud tier. This
no parent full/L0 backup is found on the active step guarantees that the last
tier. Full/L0 backup is always
available in the Active tier. For
For the Oracle plug-in, if this issue is encountered,
Oracle and Lotus plugins, after
the following error message is written to the plug-
the incremental backup
in log and the incremental backup fails: An
failure, you can either recall
incremental backup was requested but
the last Full/L0 backup from
there is no previous full backup.
the cloud tier, or perform a
Please perform a full backup before
new Full/L0 backup instead of
any subsequent full backups.
the incremental. Then
For the Lotus plug-in, the following error message subsequent incremental
is written to the plug-in log and the incremental backups complete
backup fails: No Full backup found, successfully.
Incremental backups cannot be taken
without a full backup
23
Table 23. Replication known problems and limitations (continued)
Bug number Problem statement Description Workaround
creation or completes with status of the job displays as VALID in the Asset Management
an exception displays as window of the AUI, with no warning to indicate that any issue
VALID in the AUI occurred.
309388 Restore of replicated You cannot perform a restore of a replicated backup when the NA
backups fails when source system with the Avamar source backup and the destination
and destination Avamar system for the restore are attached to the same Data Domain.
system attached to the
same Data Domain
309624 Replication fails if both IPV4 Replication to the Avamar destination in a pure IPv6 Remove the IPv4
and IPv6 records exist in the environment (where both IPv4 and IPv6 records exist in the entry from the
DNS server for the Avamar DNS server but IPv4 is not configured) fails, with an error DNS.
destination message in the Activity logs of Avamar Administrator
indicating "Unable to connect to the IPv4 address of the
Destination Avamar."
309501 Replication status was failed Due to a timeout that occurs when there are 5000 or more NA
at Avamar destination but clients in a domain, the destination system for a replication
replication was actually displays the replication job as "Failed" even though the job
successful was actually completed successfully, as indicated on the
source.
192169 Incorrect statistics appear When you replicate Avamar backup data from one Data NA
for replication of Avamar Domain system to another Data Domain system, incorrect
backup data on a Data statistics appear for:
Domain system
● The file total in the avtar log file.
● The progress bytes in the Activity Monitor in Avamar
Administrator.
262220 Invalid certificate after Reconfiguring the destination server for replication fails with NA
upgrading and reconfiguring the following an error message under the following
a replication destination conditions:Could not log in to remote
server destination. Check credentials and hostname
or IP. Authentication failed.
● After a replication is performed from a source Avamar
server to a destination Avamar server that uses
certification-based authentication.
● Upgrading the destination server to a new version of
Avamar.
● Deleting the replication configuration.
The interim solution for this problem is to issue the following
commands at the source server:
rm -rf /usr/local/avamar/etc/<destination
server IP>
rm -rf /usr/local/avamar/etc/client/
<destination server IP>
277208 Check for Remote backups During replication, when the Check for Remote backups NA
before deletion not working before deletion option is selected, the server deletes the
replication destination record even if remote backups exist on
the replication destination system.
24
Avamar Data Migration Enabler known problems and limitations
The following list describes known problems for this release of the Avamar Data Migration Enabler (ADMe).
Table 24. Avamar Data Migration Enabler known problems and limitations
Bug number Problem statement Description Workaround
253574 Staging and tape out of Due to a known limitation with the ADMe software, staging NA
Sybase backups not and tape out of backups that are created with the Sybase
supported plug-in is not supported in this release.
309934 Jetty service continues When you run the service jetty stop command to Stop the back-end jetty
to run in proxy virtual stop the jetty service in the proxy virtual machine, the process manually.
machine after stop back-end process continues to run.
command
25
Table 26. VMware known problems and limitations (continued)
Bug number Problem statement Description Workaround
309541 Limitations to vCenter Note the following limitations related to support for Perform the following
High Availability vCenter High Availability (VCHA): workaround
● If the proxy is not available after the VCHA event, a 1. Bring the proxy
restart order gets issues for all failed/restarted jobs, back online, and
which will not complete because the proxy is not then perform an on-
available. demand backup with
● If Hot Add transport mode is used for the virtual disks the same proxy.
and the proxy fails, all the associated clients with Hot Disks will be
Add disks in the proxy will fail, and a new backup consolidated and
cannot be performed. the backups will
proceed.
2. Manually remove all
Hot Add disks from
the proxy.
307561 Image-level virtual Performance issues are observed when performing 1400 NA
machine restore for a or more image-level virtual machine restores at the same
very large (1400+) time.
number of virtual
machines at the same
time is not supported
esc 34477 Domain user not For non-Windows platforms, you cannot perform file-level NA
supported for file-level restore of a virtual machine backup as a Domain user. The
restore of virtual user can be part of the Standard or Administrators group.
machine backup
Exclude the proxy from Including the Avamar proxy in a backup consumes a large NA
the virtual machine amount of space. When using other VMware software
backup if performing the instead of the Avamar software to perform the virtual
backup with other machine backup, it is recommended that you exclude the
VMware software proxy virtual machine from the backup.
Adding vCenter as IPv6 When you register or add a VMware vCenter client to NA
address is not supported, Avamar, ensure that you specify the fully qualified domain
use FQDN instead name (FQDN) of the vCenter. Using the IPv6 address is
not supported
300223 If a rule is not created to PDM registration fails and the following error message When using rule based
exclude proxy VMs when appears if a rule is not created to exclude proxy VMs protection, create a rule
rule based protection is when rule based protection is used: Could not to exclude proxy VMs.
used, PDM registration register proxy: invalid domain
fails
293950 Virtual machine client After a vCenter high availability fail-over, virtual machine If this issue occurs,
jobs in waiting, failed or client jobs that were in a waiting, failed or cancelled state restart the Avamar
cancelled state might before the fail-over might not be restarted by the Avamar Management Console
not get restarted after Management Console. services.
fail-over
292446 During a restore, the If a virtual machine with the Active Directory role is Perform the following
virtual machine restored by using the Avamar backup data loss might workaround:
Generation ID might not occur as a result of a USN rollback. In this scenario, the
1. Restore the virtual
increment which might restored virtual machine retains the same virtual
machine from the
cause data loss GenerationID as the source virtual machine.
backup.
2. Do not start the
virtual machine.
3. Take a snapshot of
the virtual machine
by using VMware.
26
Table 26. VMware known problems and limitations (continued)
Bug number Problem statement Description Workaround
291803 When logged in as Local Due to the introduction of User Account Control (UAC) in On the guest operating
user with administrator Microsoft Windows 7 and later versions, when logged in system, turn off Admin
role, Advanced Policy as a Local user with the administrator role, the Advanced Approval Mode in the
Builder fails to install/ Policy Builder fails to install/upgrade/register client UAC settings for the
upgrade/register client agents on SQL virtual machines. admin group.
agents on SQL Virtual
machines
248775 Proxy running on non The virtual machine proxy can get abruptly powered off if NA
PDL datastore is getting the proxy is engaged in a hotadd backup of a VMCP-
powered off during a enabled virtual machine, in the event of a permanent
PDL of virtual machine device loss of the virtual machine datastore. This problem
datastore might occur due to HA attempting to restart the proxy
virtual machine, as it would have mounted the VMDK of
the virtual machine.
The interim solution to this problem is to ensure that the
next schedule starts correctly, which manually removes all
the hotadd disks from the Avamar proxy, and power it
back on. A snapshot consolidation may also be required
for the virtual machine.
248502 Support for validation of When using the mccli backup validate, validation NA
VMware image backup in is scheduled but the activity is in waiting-client state. The
MCCLI is limited --dest-client-name and --dest-client-
domain options are not currently supported when
validating a non /REPLICATE client backup.
HotAdd mode does not Due to a known limitation with VMware, documented in NA
work with a VSAN disk the VDDK 6.0.1 release notes regarding vSAN 6.1, ESXi
hosts do not allow HotAdd of a vSAN disk on a proxy
virtual machine with datastore types other than vSAN. As
a result, in a vSAN 6.1 environment, attempts to hotadd a
VMDK vSAN datastore by a proxy residing outside vSAN
fails. If hotadd mode is desired, host the proxy on the
vSAN datastore.
263450 File-level restore not Avamar does not support the use of GPT/EFI drives on NA
supported for GPT/EFI Windows 2012 for file-level restore operations when the
drives on Windows 2012 drive has been edited by a disk tool from a third party
when drive has been software vendor. Before mounting the drive for file-level
edited by third party disk restore, verify that all the disks on the virtual machine
tool have valid/supported partitions.
278280 Instant Access that is Instant Access restores are not supported for data that is NA
not supported with cloud migrated to the cloud using the cloud tiering feature.
tiering
282640 Restoring a remote Restoring a remote backup fails when the restore is to a NA
backup fails when the specific ESXi that is different from the original ESXi
restore is to a specific server. The interim solutions to this problem are:
ESXi that is different
● If a local backup exists, restore the local backup to the
from the original ESXi
specific ESXi.
server
● If a local backup does not exist, and the original ESXi
is running, restore the remote backup to original ESXi
27
Table 26. VMware known problems and limitations (continued)
Bug number Problem statement Description Workaround
avrepl --[replscript]restore=true --
operation=replicate --
[replscript]dstaddr=SRC_ADDR
--[replscript]dstid=repluser --
dstpassword=Chang3M3Now. --
ap=Chang3M3Now. --
[replscript]dpnname=SRC_ADDR
--[replscript]dstencrypt=tls /
REPLICATE/CLIENTPATH
319375 Backup failed in Avamar In Avamar release 19.3, Virtual Machine backup is not NA
19.3 with VMC 1.9 supported with VMware VMC 1.9 release.
319308 Backup failed in Avamar In Avamar release 19.3, Virtual Machine backup is not NA
19.3 with VMC 1.10 supported with VMware VMC 1.10 release.
320131 vddk errors seen for vddk error during VM Image backup and restore "Error NA
successful VM Image while loading feature config file: /etc/vmware/
backup and restores vsphereFeatures/vsphereFeatures.cfg, using
default feature state values". This is treated as warning
message from proxy perspective and safe to ignore.
Table 27. File Level Restore Client known problems and limitations
Bug Problem statement Description Workaround
number
280373 Issue when browsing a large number When browsing a folder with large number of files (more
of files with Internet Explorer than 40,000), Internet Explorer may take more than 2
minutes to complete loading the page, and is not
responsive during the loading process. The interim
solution to this problem is to use another browser, such
as Chrome or FireFox.
28
Supportability package known problems and limitations
The following list describes known problems for the release of Avamar supportability packages:
29
Data Domain system requirements
Updated, detailed, supported DD OS and DD Boost version information is available in the E-LAB Navigator at https://
elabnavigator.emc.com/eln/modernHomeDataProtection.
● Arabic ● Japanese
● Bulgarian ● Korean
● Chinese (Simplified and Traditional) ● Latvian
● Croatian ● Lithuanian
● Czech ● Norwegian
● Danish ● Polish
● Dutch ● Portuguese (Brazilian)
● Estonian ● Romanian
● Finnish ● Russian
● French ● Slovak
● German ● Slovenian
● Greek ● Spanish (Iberian and Latin American)
● Hebrew ● Swedish
● Hungarian ● Turkish
● Italian
Windows files and folders You can back up and restore individual files and folders with file and folder names
in local languages.
File and folders names appear in the local language in Avamar Administrator and
Avamar Web Restore.
Microsoft Exchange databases You can back up and restore databases with the database name in supported local
languages.
Microsoft Exchange folders and You can back up and restore individual folders and messages with the folder or
messages message name in supported local languages.
Microsoft SQL Server databases You can back up and restore databases with the database name in supported local
languages.
● Arabic ● Japanese
● Bulgarian ● Korean
● Chinese (Simplified and Traditional) ● Latvian
30
● Croatian ● Lithuanian
● Czech ● Norwegian
● Danish ● Polish
● Dutch ● Portuguese (Brazilian)
● Estonian ● Romanian
● Finnish ● Russian
● French ● Slovak
● German ● Slovenian
● Greek ● Spanish (Iberian and Latin American)
● Hebrew ● Swedish
● Hungarian ● Turkish
● Italian
The following table describes additional international language support details in UNIX and Linux environments.
EUC-JP You can back up and recover EUC-JP encoded files and
directories with names in the Japanese language on Solaris.
NOTE: EUC-JP encoded file and directory names do not
render correctly in either Avamar Administrator or Avamar
Web Restore. This issue does not apply to the client web
UI available through Avamar Desktop/Laptop.
UTF You can back up and restore individual UTF-encoded files and
directories with file and directory names in supported local
languages.
File and directory names appear in the local language in
Avamar Administrator and Avamar Web Restore.
31
To correctly restore files with international characters by using the Avamar Web Restore feature, use a Zip utility that supports
international characters. Examples are:
● Winrar 3.80 or later
● Winzip 12.0 or later
● 7zip 4.65 or later
Do not use Microsoft Windows compressed folders with the Avamar Web Restore feature. These compressed folders do not
reliably handle international characters.
32
x-eucJP-Open x-IBM1006 x-IBM1025
x-IBM1046 x-IBM1097 x-IBM1098
x-IBM1112 x-IBM1122 x-IBM1123
x-IBM1124 x-IBM1381 x-IBM1383
x-IBM33722 x-IBM737 x-IBM834
x-IBM856 x-IBM874 x-IBM875
x-IBM921 x-IBM922 x-IBM930
x-IBM933 x-IBM935 x-IBM937
x-IBM939 x-IBM942 x-IBM942C
x-IBM943 x-IBM943C x-IBM948
x-IBM949 x-IBM949C x-IBM950
x-IBM964 x-IBM970 x-ISCII91
x-ISO-2022-CN-CNS x-ISO-2022-CN-GB x-iso-8859-11
x-JIS0208 x-JISAutoDetect x-Johab
x-MacArabic x-MacCentralEurope x-MacCroatian
x-MacCyrillic x-MacDingbat x-MacGreek
x-MacHebrew x-MacIceland x-MacRoman
x-MacRomania x-MacSymbol x-MacThai
x-MacTurkish x-MacUkraine x-MS932_0213
x-MS950-HKSCS x-mswin-936 x-PCK
x-SJIS_0213 x-UTF-16LE-BOM X-UTF-32BE-BOM
X-UTF-32LE-BOM x-windows-50220 x-windows-50221
x-windows-874 x-windows-949 x-windows-950
x-windows-iso2022jp
Technical notes
This section describes important notes and tips for using Avamar.
33
Do not use the avmgr command
Improper use of the avmgr command line utility can destroy all access to data in the Avamar system. Use this command only at
the explicit direction of Customer Service.
Vulnerability scanning
As part of every Avamar release, the product is scanned for vulnerabilities using at least two common vulnerability assessments
tools. This release was scanned with Foundstone and Nessus. Various customers scan the Avamar solution by using tools such
as eEye Retina without issue. However, it is possible that the usage of other port/vulnerability scanners might cause disruption
to normal operation of the Avamar server. Therefore, it might be necessary to disable scanning of the Avamar server when
problems occur.
VMware image proxies are not available for backups when they are in sleep mode
and you restart the MCS
If you stop the MCS and do not restart the MCS within 5 minutes, then VMware image proxies go into a sleep mode for 40
minutes. When you restart the MCS, it might take some time until all proxies reconnect to the MCS and are available for
backups. This issue can occur when performing backups after a rollback.
To ensure that all proxies are available, open the avagent.log file on each proxy, and ensure that the following messages
appear at the bottom of the log:
yyyy-mm-dd hh:mm:ss avagent Info <5964>: Requesting work from 10.2.345.678
yyyy-mm-dd hh:mm:ss avagent Info <5264>: Workorder received: sleep
yyyy-mm-dd hh:mm:ss avagent Info <5996>: Sleeping 15 seconds
The messages indicate that the proxy can connect to the MCS. The avagent.log file is available in the /usr/local/
avamarclient/var directory.
34
Token based authentication notes
Data Domain version 5.7.1.x or later supports token based authentication. Previous versions fall back to traditional connection.
Clients must use a resolvable Fully Qualified Domain Name to use token based authentication.
35
● backuponly
● restoreonly
● backuprestore
● replonly
NOTE: This change does not affect the Avamar Web Restore LDAP login screen.
36
● For a multi-node server, log in to the utility node as root.
2. Switch user to root by typing the following command:
su -
4. Open the Avamar Desktop/Laptop properties file, dtlt.properties, in a plain text editor.
5. Add the showWRClientList key with the value of true:
showWRClientList=true
If the key exists, set the value to true.
Restore of files with special characters in file name when Avamar server LANG
variable is not set
When the LANG variable is not set on an Avamar server, using Avamar Web Restore to restore a file with special characters in
the file name fails. To fix this issue, set the LANG variable in /etc/locale.conf and reboot the Avamar server.
37
Log files are time/date stamped in UTC time
Some client log and other files that are created in the VARDIR are time/date stamped in Universal Time Code (UTC) time
(Greenwich Mean Time) and not the local time. This step can cause confusion when looking for a particular log file.
38
Retention must expire before February 7, 2106 for 32-bit Windows and Linux clients
For backups of 32-bit Windows or 32-bit Linux client computers, do not assign a retention period for a date after February 7,
2106. If an extended retention period is assigned to a 32-bit Windows client, the backup completes with exceptions. For 32-bit
Linux clients, the backups complete but do not appear in Avamar Administrator.
Issues when running multiple CLI backup or restore operations at a time for a client
Stability issues occur when multiple command line interface (CLI) backup or restore operations are run at a time for a client. To
work around this issue, perform only one CLI operation at a time for each client.
Do not use Personal Identifiable Information (PII). Do not use PII in the password, such as:
● Your name
● Your username
● Your birthday
● Names of pets
● Names of your children
● Name of your alma mater
● Keywords that are associated with your hobbies
Do not use words from the dictionary. Do not use any word that can be found in the dictionary as
your full password.
Use strong passwords. Always use strong passwords when creating passwords.
Strong passwords include:
● At least eight characters
● Special characters such as a percent sign (%) or
ampersand (&)
● Non-alphabetic characters
● Both uppercase and lowercase characters
Use different passwords for user accounts Always use a different password for each user account.
Change your password regularly ● Change your most critical passwords on a regular basis.
● Change your passwords at least every 6 months.
● When you change your password, avoid using variations of
a previous password.
● Immediately change your password if you expect another
person has access to your account, or knows your
password.
● Always change your password as soon as you receive an
account.
39
Password protection best practices
Create a password that you can remember without needing to store it. However, if the password must be stored, follow these
recommendations:
● Use a password vault application to protect and help manage your passwords.
● If passwords must be written down on a piece of paper, store the paper in a secure place and destroy it when it is no longer
needed.
● Do not put your username and password on a post-it note under your keyboard.
● Do not write down your username and password in the same place.
● Use caution regarding where passwords are saved on computers. Some dialog boxes, such as those for remote access and
other telephone connections, present an option to save or remember a password. Selecting this option poses a potential
security threat.
● Never share your passwords with anyone and do not give your password to anyone over the phone.
Documentation
This section describes the documentation and information products that are available with this release of Avamar.
40
Avamar Management Console Command Line Interface (MCCLI) Programmer Guide
This document describes how to install, configure, and use the Avamar Management Console Command Line Interface (MCCLI),
which is a Java software application that provides command-line access to Avamar Administrator features.
41
Avamar for Oracle User Guide
This document describes how to install Avamar in an Oracle database environment, and how to back up and restore Oracle
databases.
E-lab Navigator
E-LAB Navigator
Provides server, client, and platform compatibility and interoperability information. The E-LAB Navigator at https://
elabnavigator.emc.com/eln/elnhome.
42
Technical notes and white papers
Avamar technical notes provide technical details on specific product features, including step-by-step tasks, where necessary.
White papers provide an in-depth technical perspective of a product or products as applied to critical business issues or
requirements. Both technical notes and white papers are available on Online Support at https://www.dell.com/support.
Your comments
Comments and suggestions help to continue to improve the accuracy, organization, and overall quality of the user publications.
Send comments and suggestions about this document to DPAD.Doc.Feedback@emc.com.
Include the following information:
● Product name and version
● Document name and revision (for example, 01)
● Page numbers
● Other details to help address documentation issues
43
Table 32. Installation and upgrade of other Avamar components
Component Location for installation and upgrade procedures
Avamar Management Web user interface (AUI) Avamar Administration Guide
Avamar Administrator Avamar Administration Guide
Avamar Management Console Command Line Interface Avamar Management Console Command Line Interface
(MCCLI) (MCCLI) Programmer Guide
Avamar 19.2 to Avamar 19.4 1. Ensure that all Avamar clients are running Avamar 19.2 client software.
2. Upgrade the Data Domain systems to DD OS 6.2 or later.
3. Upgrade the Avamar server to release 19.4.
4. (Optional) Upgrade the Avamar clients to release 19.4.
Avamar 19.1 to Avamar 19.4 1. Ensure that all Avamar clients are running Avamar 19.1 client software.
2. Upgrade the Data Domain systems to DD OS 6.2 or later.
3. Upgrade the Avamar server to release 19.4.
4. (Optional) Upgrade the Avamar clients to release 19.4.
Avamar 18.2 to Avamar 19.4 1. Ensure that all Avamar clients are running Avamar 18.2 client software.
2. Upgrade the Data Domain systems to DD OS 6.2 or later.
3. Upgrade the Avamar server to release 19.4.
4. (Optional) Upgrade the Avamar clients to release 19.4.
44
Table 33. Upgrade Avamar with a Data Domain system (continued)
Upgrade path Steps
Avamar 18.1 to Avamar 19.4 1. Ensure that all Avamar clients are running Avamar 18.1 client software.
2. Upgrade the Data Domain systems to DD OS 6.2 or later.
3. Upgrade the Avamar server to release 19.4.
4. (Optional) Upgrade the Avamar clients to release 19.4.
Avamar 7.5.1 to Avamar 19.4 1. Ensure that all Avamar clients are running Avamar 7.5.1 client software.
2. Upgrade the Data Domain systems to DD OS 6.2 or later.
3. Upgrade the Avamar server to release 19.4.
4. (Optional) Upgrade the Avamar clients to release 19.4.
NOTE: If you fail to perform the upgrade steps or you perform the steps out of sequence, then backup failures and data
corruption on the backup device can occur. All Avamar and Data Domain upgrades should be planned ahead of time with the
assistance of the Remote Proactive Avamar Upgrade team. Do not attempt to proceed without their assistance and
planning.
Knowledgebase
The Knowledgebase contains applicable solutions that you can search for either by solution number (for example, KB000xxxxxx)
or by keyword.
To search the Knowledgebase:
1. Go to https://www.dell.com/support.
2. Under the Support tab, click Knowledge Base.
3. Type either the solution number or keywords in the search box. Optionally, you can limit the search to specific products by
typing a product name in the search box and then selecting the product from the list that appears.
45
Online communities
Go to Community Network at https://www.dell.com/community for peer contacts, conversations, and content on product
support and solutions. Interactively engage online with customers, partners, and certified professionals for all products.
Live chat
To engage Customer Support by using live interactive chat, click Join Live Chat on the Service Center panel of the Avamar
support page.
Service requests
For in-depth help from Customer Support, submit a service request by clicking Create Service Requests on the Service Center
panel of the Avamar support page.
NOTE: To open a service request, you must have a valid support agreement. Contact a sales representative for details
about obtaining a valid support agreement or with questions about an account.
To review an open service request, click the Service Center link on the Service Center panel, and then click View and manage
service requests.
Enhancing support
It is recommended to enable ConnectEMC and Email Home on all Avamar systems:
● ConnectEMC automatically generates service requests for high priority events.
● Email Home sends configuration, capacity, and general system information to Customer Support.
46
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the
problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 2001 - 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Other trademarks may be trademarks of their respective owners.