Issue:
Password error: unable to log on to PowerChute Network Shutdown web UI due to unknown username or password.
Would like to change the authentication phrase use to communicate with the Network Management Card via the pcnsconfig.ini file.
Product:
PowerChute Network Shutdown (PCNS) v3.X, 4.X, 5.X
Environment:
All supported Operating Systems.
Cause:
Lost/unknown username or password for web user interface.
Would like to change the authentication phrase use to communicate with the Network Management Card via the pcnsconfig.ini file.
NOTE: if the password for the PowerChute VMware Virtual Machine is unknown see Schneider Electric FAQ000244469 Steps to reset root password on the AlmaLinux PowerChute Virtual Appliance (VM)
Solution:
To change your username, password or authentication phrase:
On Linux enter from command window enter sudo service PowerChute stop or systemctl stop PowerChute
C:\Program files\APC\PowerChute\group1
On Linux the default path is
/opt/APC/PowerChute/group1
You can also enter the Authentication Phrase user for communications with the Network Management Card
authenticationPhrase= new phrase (note the capital P use with the word Phrase )
On Linux enter from command window enter sudo service PowerChute start or systemctl start PowerChute
The acceptable characters for username and password are:
• the alphabet in both lowercase and uppercase (a to z and A to Z)
• numbers from 0 to 9
• these characters: _!\"#$%&'()*+,-./:;<=>?@^`{|}[]~
The password requires:
• Minimum 8 and maximum 128 characters in length See NOTE 1 Below!
• One upper and one lowercase letter
• One number and special character
• The username cannot be part of the password
• Leading and trailing white spaces in passwords are removed
• Passwords containing a white space are kept
The username must be between 1–10 characters.
The authentication phrase must be 15–32 ASCII characters.
NOTE 1: "The maximum allowed character limit for the password is 128, as documented in all our user documents. However, currently, PowerChute only allows 32 characters. During password setting/resetting, PowerChute will validate and allow setting a 128-character password. No errors will be displayed as part of the validation. However, users cannot log in with a password greater than 32 characters."
NOTE 2: If the username or password do not meet the requirements listed above you will be unable to login to the PowerChute web interface.
For security, the username, password, and authentication phrase lines will be deleted from the pcnsconfig.ini file when the PowerChute service is restarted.
Released for:APC Netherlands
