Professional Documents
Culture Documents
DN09258918
Issue 1-1
Approved on 19th May, 2022
This document includes Nokia proprietary and condential information, which may not be
distributed or disclosed to any third parties without the prior written consent of Nokia. This
document is intended for use by Nokia’s customers (“You”/”Your”) in connection with a
product purchased or licensed from any company within Nokia Group of Companies. Use this
document as agreed. You agree to notify Nokia of any errors you may nd in this document;
however, should you elect to use this document for any purpose(s) for which it is not
intended, You understand and warrant that any determinations You may make or actions
You may take will be based upon Your independent judgment and analysis of the content of
this document.
Nokia reserves the right to make changes to this document without notice. At all times, the
controlling version is the one available on Nokia’s site.
NO WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
ANY WARRANTY OF AVAILABILITY, ACCURACY, RELIABILITY, TITLE, NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, IS MADE IN RELATION TO THE
CONTENT OF THIS DOCUMENT. IN NO EVENT WILL NOKIA BE LIABLE FOR ANY DAMAGES,
INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR
CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT,
REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA THAT MAY ARISE
FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT, EVEN IN THE CASE OF
ERRORS IN OR OMISSIONS FROM THIS DOCUMENT OR ITS CONTENT.
© 2022 Nokia.
<
Troubleshooting Nokia Archive Cloud
<
Troubleshooting Nokia Archive Cloud
Symptoms
It is impossible to perform Client integration.
Information that operation is failed appears.
Cause
Unable to contact Client
Purpose
During the Client integration, the following log appears:
2020-11-18 11:47:33,144 ERROR Backup Engine server is not able to resolve client
hostname: client_hostname
integrated
For more information about the necessary ports, see the Port Requirements chapter in
Avamar Product Security Guide.
<
Troubleshooting Nokia Archive Cloud
For more information about managing memory, see the Tuning Performance chapter in Dell
EMC Avamar- Operational Best Practices Guide document.
Example
linuxsecurity::init(/private/meta.json) lgetxattr(trusted.glusterfs.crypt.att.size)
linuxsecurity::init(/private/meta.json) lgetxattr(trusted.glusterfs.crypt.att.cfmt)
Symptoms
It is impossible to delete Client.
Information that operation is failed appears.
Cause
Activities are in progress
Purpose
During the Client deletion process, the following log appears:
2020-11-18 11:58:45,068 ERROR Client operation failed. Error: Client delete failed.
▪ Check if any activities (backup or restore) for the specified Client are in progress.
<
Troubleshooting Nokia Archive Cloud
Procedure
1 If any activity for the desired Client is in progress, wait until the activity is done.
2 Perform the Client deletion operation again. For more information, see the Deleting
Client chapter in Administering Nokia Archive Cloud.
Symptom
The backup operation is not successful.
Causes
Scripts related causes
Connectivity related causes
Causes
Scripts are not in the correct path
Shell interpreter in scripts is missing
Scripts have no executable rights
<
Troubleshooting Nokia Archive Cloud
or
or
Procedure
1 Move scripts under the /etc/avamar/scripts/ directory.
Note:
2 Perform the backup operation again. For more information, see the Backup
Management chapter in Administering Nokia Archive Cloud.
Procedure
1 In the Backup Engine Node log (on client in /usr/local/avamar/var/clientlogs
folder or Avamar GUI), one of the following messages appears:
Procedure
1 Add the shell interpreter (#!/bin/bash) at the begging of the script.
<
Troubleshooting Nokia Archive Cloud
Procedure
1 In the Backup Engine Node log (on client in /usr/local/avamar/var/clientlogs
folder or Avamar GUI), one of the following messages appears:
or
path:/usr/local/avamar/scripts/<script_name> (Log #1)
or
path:/usr/local/avamar/scripts/<script_name> (Log #1)
2017-06-28 22:05:36 avtar Error <7001>: Exiting avtar with run-at-end script
chmod +x /etc/avamar/scripts/<exec_script.sh>
Causes
No connection to Data Domain
Authentication error occurs in connection to Data Domain
Backups fail with Error Code 10008
Purpose
In the Backup Engine Node log (on client in /usr/local/avamar/var/clientlogs folder
or Avamar GUI), the following message appears:
<
Troubleshooting Nokia Archive Cloud
Procedure
1 Check if Data Domain is properly configured.
For more information see the Data Domain verification chapter in Administering Nokia
Archive Cloud.
Purpose
In the Backup Engine Node log (on client in /usr/local/avamar/var/clientlogs folder
or Avamar GUI), the following message appears:
with token:5ba93c9db0cff93f52b521d7420e43f6eda2784f
open failed DDR result code: 4904, desc: Invalid API argument.
Procedure
1 Check if Data Domain is properly configured.
For more information see the Data Domain verification chapter in Administering Nokia
Archive Cloud.
Purpose
In the Backup Engine Node log (on client in /usr/local/avamar/var/clientlogs folder
or Avamar AUI), the following message appears:
<
Troubleshooting Nokia Archive Cloud
2017-08-11 09:34:58 avtar Info <10540>: - Resolved Data Domain Server name
DataDomain: 10.92.53.129
encryption strength: 2
auth_mode: 2
client_cert /usr/local/avamar/etc/cert.pem
client_key: /usr/local/avamar/etc/key.pem
server_cert:
/tmp/.tmp_avamar/DD_1.0_Test_sto29-1502433280000_598d5010_3c7a708e.pem
chain_cert: /usr/local/avamar/etc/chain.pem
2017-08-11 09:34:58 avtar Info <19155>: - Establishing a connection via token to the
Data Domain system with certificate authentication (Connection mode: A:2 E:2).
2017-08-11 09:35:03 avtar Warning <18125>: Calling DDR_OPEN_VIA_TOKEN returned
2017-08-11 09:35:03 avtar Error <10509>: Problem logging into the DDR server:'',
only GSAN communication was enabled.
2017-08-11 09:35:03 avtar FATAL <17964>: Backup is incomplete because file
"/ddr_files.xml" is missing
2017-08-11 09:35:03 avtar Info <10642>: DDR errors caused the backup to not be
2017-08-11 09:35:03 avtar Info <12530>: Backup was not committed to the DDR.
2017-08-11 09:35:03 avtar FATAL <8941>: Fatal server connection problem, aborting
2017-08-11 09:35:03 avtar Info <6149>: Error summary: 4 errors: 10542, 8941, 10509,
17964
code 10008: cannot establish connection with server (possible network or DNS
failure))
Procedure
1 To retrieve the Data Domain information, perform the following steps:
Provide the password in the Password text box and confirm it in Verify
Password.
Note:
1.5 In the Edit Data Domain window, click Next twice and then Finish.
The It may take a long time to update Data Domain. Please wait... message
appears. Wait until the update is finished.
<
Troubleshooting Nokia Archive Cloud
ddboost enable
Step result
Connection with the server is established.
Purpose
Service Not Available. The GUI Service is temporarily unavailable. Please refresh
your browser. If the problem persists, please contact DataDomain support for
assistance.
This issue can occur when Data Domain system is under heavy load (high
backup/replication/cleaning activity) or if there was a temporary communication issue with
the web service.
DDOS upgrade to 6.x family from 5.6.x or 5.7.x platforms can also cause a connection
problem.
For environments that use self-signed SHA-256 certificates, the certificates must be
regenerated manually after the DDOS upgrade process is complete. Systems that connect
to the Data Domain system must reestablish trust with it.
Purpose
Procedure
1 Close the web browser session with the Data Domain GUI service.
Result
The Data Domain GUI is now available.
<
Troubleshooting Nokia Archive Cloud
Procedure
1 Log in as the brc user to the Management Node on port 7722 using SSH:
2 Execute the arccli client reintegrate command, specifying the Client hostname as
follows:
where:
<CLIENT_HOSTNAME> is a hostname of the integrated Client.
Result
The Client is reintegrated and the following log information is visible:
Symptoms
--subprocesstimeoutsecs=300
<
Troubleshooting Nokia Archive Cloud
channels (rmanChannels)
file per set (backupFilesPerSet)
section size (sectionSize)
Symptoms
Cause
Datastore space limit is exceeded
VMware backup failed with error No proxy
VMware image backups fails with Error 10056
VM snapshot backup fails due to incorrect pre-evaluation of available space
Procedure
1 Log in as the brc user to the Management Node on port 7722 using SSH:
2 Execute the arccli client show command, specifying the Client hostname as
follows:
<
Troubleshooting Nokia Archive Cloud
where:
PROXY_HOSTNAME is a hostname of the integrated VMware Proxy.
Result
The proxy details information is visible:
+------------------------+---------------------------------+
| Attribute | Value |
+------------------------+---------------------------------+
| Client | proxy_hostname |
| Enabled | Yes |
| vCenter | vcenter_hostname |
| Backup Configurations | |
+------------------------+---------------------------------+
The snapshot create task fails with one the following errors:
2020-06-03 15:09:45 avvcbimage Warning <18652>: Too many extra snapshot files (3)
were found on this Windows VMs datastore. This can cause a problem for the backup or
restore.
2020-06-03 15:09:45 avvcbimage FATAL <0000>: [IMG0002] The datastore information from
Too many pre-existing snapshots on the datastore will not permit a restore or backup.
(wrap-up stage)
creation/pre-script/post-script failed.
Purpose
To resolve the problem, follow the steps below:
Procedure
1 Look for avvcbimage Info <14677> in the logs and verify if there are files like
<
Troubleshooting Nokia Archive Cloud
File:'VMNAME-000002-ctk.vmdk
File:'VMNAME-000002-sesparse.vmdk
File:'VMNAME-000002.vmdk
File:'VMNAME-000005-ctk.vmdk
File:'VMNAME-000005-sesparse.vmdk
File:'VMNAME-000005.vmdk
File:'VMNAME-000006-ctk.vmdk
File:'VMNAME-000006-sesparse.vmdk
File:'VMNAME-000006.vmdk
File:'VMNAME-766073b0.hlog
...
File:'vmware-50.log
File:'vmware-51.log
File:'vmware-52.log
File:'vmware.log
File:'vmx-VMNAME-3818966866-1.vswp
File:'vmx-zdump.000
2 The easiest and fastest way to fix this issue is doing a Datastore vMotion.
4 If it still fails, verify if the Datastore has changed, looking for avvcbimage Info
<19704> in the current and previous log:
5 After the Datastore vMotion in the log, the file date modification must be updated
for all files, and the additional used files were cleaned.
<
Troubleshooting Nokia Archive Cloud
File:'TSPEGASUS-682f3bfa.hlog
File:'TSPEGASUS-aux.xml
File:'TSPEGASUS-ctk.vmdk
File:'TSPEGASUS-e40ee848.vswp
File:'TSPEGASUS-flat.vmdk
File:'TSPEGASUS.nvram
File:'TSPEGASUS.vmdk
File:'TSPEGASUS.vmsd
File:'TSPEGASUS.vmx
File:'TSPEGASUS.vmx.lck
File:'TSPEGASUS.vmxf
File:'TSPEGASUS.vmx~
File:'TSPEGASUS_1-ctk.vmdk
File:'TSPEGASUS_1-flat.vmdk
File:'TSPEGASUS_1.vmdk
File:'vmmcores-1.gz
File:'vmware-0.log
File:'vmware-48.log
File:'vmware-49.log
File:'vmware-50.log
File:'vmware-51.log
File:'vmware-52.log
File:'vmware.log
File:'vmx-TSPEGASUS-3826182216-1.vswp
File:'vmx-zdump.000
<
Troubleshooting Nokia Archive Cloud
-- snapshot_max_change_percent=0.
Symptoms:
Causes:
Password for ddboost user has expired.
Purpose
<
Troubleshooting Nokia Archive Cloud
Purpose
The password for the ddboost user must be changed within the number of days specified
by the password policy. When the password has not been changed, the ddboost user is
locked.
Note:
Before starting this procedure, check the Data Domain IP and a password for an
admin user on the Backup Engine Node (Avamar). It is recommended to log in on the
Backup Engine Node as an admin user via ssh on a separate console.
There is a time limitation up to 10 minutes to finish the procedure. After this time,
when the procedure is not finished, ddboost user will be blocked.
To unlock and change the password for ddboost user, execute the following steps:
Procedure
1 Log in to the Data Domain as sysadmin user and execute:
Step result
Status of the ddboost user (the exemplary user: boost-ci) is locked.
Step result
Number of maximum attempts appears.
where:
<
Troubleshooting Nokia Archive Cloud
Note:
Step result
Passwords matched.
6 After log in to the Backup Engine Node (Avamar) as the admin user, execute:
confirm=<NewDdBoostUserPassword> --name=<DataDomainIp>
where:
NewDdBoostUserPassword is a new password for the ddboost user.
DataDomainIp is an IP address of Data Domain.
Step result
0,31005,Data Domain system updated but the hostname may not be valid.
Attribute Value
------------ ------------
dd 10.41.119.63
hostname 10.41.119.63
ipv6Hostname
ipv4Hostname 10.41.119.63
7 Log in as the sysadmin user or switch back to the Data Domain console and execute:
Step result
Status of the ddboost user (the exemplary user: boost-ci) is enabled.
where:
<
Troubleshooting Nokia Archive Cloud
Purpose
PM data collection task takes more time than the schedule interval is set to, which results in
NetAct receiving delayed PM data.
For information on how to change the interval, see the Changing OMAgent PM data
collection schedule interval chapter in Administering Nokia Archive Cloud.