Error: Cannot logon after changing password with aai-cfgtool-changepwd․jar on Linux

Products

• Automation Analytics & Intelligence

Issue/Introduction

When changing the default password using the aai-cfgtool-changepwd․jar tool on a Linux server, you cannot log on if the new password contains special characters like a dollar sign ($) ․​​​​‌​‍
This causes a problem with the webswing․config file ․

ERROR MESSAGE: "Login failed."

SYMPTOMS:

• You cannot log on after changing the default password.

• The webswing․config file becomes corrupted.

CONTEXT: Occurs when running the password change tool on a Linux command line ․

IMPACT: Users cannot access the system.

 

Environment

 

• OS: Linux

• Application: Automation Analytics & Intelligence (AAI) 24․X

 

Cause

Linux treats the dollar sign ($) as the start of a variable name when entered on the command line without quotes ․
This causes the rest of the password to be treated as a variable, corrupting the password hash ․

 

Resolution

1․ AVOID VARIABLE SUBSTITUTION

Command: /opt/java/jdk/bin/java -jar aai-cfgtool-changepwd․jar <Current Password> 'Password$123'

 

EXPECTED:
The OS treats the dollar sign as a literal character rather than a variable when single quotes are used ․
NOTE: Enclose the new password in single quotes if it contains a dollar sign ($) ․

 

2․ RECOVER LOCKED ACCOUNT

Stop Webswing.
Backup the webswing․config file.
Use the hashed password below in the file for masteradmin ․ $hashed$JDmXIPBUBQs6nQe-kyGU4F2YXvTEWuVjEZHjUxmRjz

EXPECTED:
The configuration is reset with the default hashed password ․

 

3․ RESTART AND LOG IN

Start the Webswing ․
Log in using the default password, which is Ma5ter@dminPassword ․

EXPECTED: Successful login ․

VERIFY SUCCESS:

• You can successfully log into the system using the new password or the reset default password ․

Additional Information

Unable to login to WebSwing after changing masteradmin password: Caused by: java.lang.NumberFormatException: For input string: "100.0"