Avamar: DB2 archivelog backup may fail with "avtar Error <5126>: Login error 69: Authentication failure (Invalid password? User disabled?"

Summary: DB2 archivelog backup may fail with "avtar Error <5126>: Login error 69: Authentication failure (Invalid password? User disabled?"

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

Symptoms



DB2 archivelog backup fails.

avtar error message:
avtar Error <5126>: Login error 69: Authentication failure  (Invalid password?  User disabled?

Cause

The password was changed in the Avamar server or the password was encrypted on a different computer than the one backing up the archivelogs.

Resolution

  1. Validate the password is correct by manually running avtar:  
 avtar --backups --path=/clients/ppointlinux1 --id=<avamar_user_name> --password=<password> --sysdir=/usr/local/avamar/etc --logfile=/tmp/cli_test/avdb2.log --vardir=/usr/local/avamar/var --debug=true
 

Note 1: The password is found in the DB2 option file. The following KB article contains information about the Archivelog Configuration and the option file:  525117:  Avamar: How to check Avamar DB2 Plugin Archivelog Configuration

Note 2: This is the password for the Avamar user referenced by --id switch in the avtar command.
  1. If the previous command fails with "Login error 69: Authentication failure (Invalid password? User disabled?", then Encrypt the correct password.
If the Avamar password is Changeme_1, encode it using the following command:  
Example:
 
avtar --encodepassword=Changeme_1
7993d24246b0671d2fc8ac8a6ded7afa7938ceb13669810c4787345ac29bf9ed5aa28017372xxxx
 

Note 1: The  long hexadecimal number is the encoded password.

Note 2: if Password is unknown then change it using the Avamar Administrator GUI.
 
Example:  
Assuming the Avamar user is called "avamar":
  • Open the Avamar Administrator UI
  • Click on Administration
  • Right Click on the "avamar" user and Select: Edit User
  • Set the new password
kA2f1000000K7tMCAS_2_0 
  • Encrypt the new password.
  • Add the new encoded password to the option file.
 Example:  
 
--path=/clients/ppointlinux1
--id=avamar
--password=7993d24246b0671d2fc8ac8a6ded7afa7938ceb13669810c4787345ac29bf9ed5aa28017372xxxx
--sysdir=/usr/local/avamar/etc
--logfile=/tmp/cli_test/avdb2.log
--avtar-before-after-days-search=1
--vardir=/usr/local/avamar/var
--debug=true

Affected Products

Avamar

Products

Avamar, Avamar Plug-in for IBM DB2
Article Properties
Article Number: 000062912
Article Type: Solution
Last Modified: 20 May 2025
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.