Technical FAQs

Ask a Question

How to reset the username or password in PowerChute Business Edition 9.5 and above

Issue
User has forgotten their username or password created during the installation, and is unable to login to the PCBE Agent.

Product
PowerChute Business Edition 9.5, 10.x

Environment
All Supported Operating Systems

Resolution:

For PowerChute Agent 9.5

1. Create a plain text file named pcbeConfig.ini, and save it to the Agent folder in the PowerChute installation folder.

On Windows systems, the default location of the folder is:
C:\ Program Files\APC\PowerChute Business Edition\Agent or
C:\ Program Files (x86)\APC\PowerChute Business Edition\Agent

On Linux systems, the default location of the folder is:
/opt/APC/PowerChuteBusinessEdition/Agent/

IMPORTANT: Make sure that the file extension of the plain text file is set to .ini, and not .ini.txt. On Windows operating systems, it may be necessary to set the folder options to show
the file extensions in Windows Explorer, to make sure that the file extension is .ini.

2. Open the pcbeConfig.ini text file with a text editor (e.g. Notepad) and add the following:

[Credentials]
username=
password=
Enter the new username and password directly after the equals sign.
- The username must be between 6 and 128 characters in length.
- The password requires:
• Minimum 8 and maximum 128 characters in length
• 1 upper and lower case letter
• 1 number or special character
• The username cannot be part of the password.

3. Save the pcbeConfig.ini file in the Agent installation folder.

4. Restart the APC PBE Agent service:

- On Windows
Go into Windows Services under Administrative Tools in the Control Panel. The display name there is APC PBE Agent. Restart the service.

- On Linux
Enter the following commands into a command prompt:
/etc/init.d/PBEAgent stop
/etc/init.d/PBEAgent start

5. If the username and password meet the requirements, the pcbeConfig.ini file is deleted from the Agent installation folder, and the new credentials are ready to use.
- If the credentials entered in pcbeConfig.ini do not meet the requirements, an error is written to the file. Check the file for the error, adjust the credentials accordingly, and restart the Agent service.

6. Log in to the PowerChute web interface with your new credentials.

For PowerChute Agent 10.x

1. Open pcbeConfig.ini that will be found in the Agent folder with a text editor.

On Windows systems, the default location of the folder is:
C:\ Program Files\APC\PowerChute Business Edition\Agent or
C:\ Program Files (x86)\APC\PowerChute Business Edition\Agent

On Linux systems, the default location of the folder is:
/opt/APC/PowerChuteBusinessEdition/Agent/

2. After opening the pcbeConfig.ini with a text editor text add the following:

[Credentials]
username=
password=
Enter the new username and password directly after the equals sign.
- The username must be between 6 and 128 characters in length.
- The password requires:
• Minimum 8 and maximum 128 characters in length
• 1 upper and lower case letter
• 1 number or special character
• The username cannot be part of the password.

3. Save the pcbeConfig.ini file in the Agent installation folder.

4. Restart the APC PBE Agent service:

- On Windows
Go into Windows Services under Administrative Tools in the Control Panel. The display name there is APC PBE Agent. Restart the service.

- On Linux
Enter the following commands into a command prompt:
/etc/init.d/PBEAgent stop
/etc/init.d/PBEAgent start

5. If the username and password meet the requirements, the pcbeConfig.ini file is deleted from the Agent installation folder, and the new credentials are ready to use.
- If the credentials entered in pcbeConfig.ini do not meet the requirements, an error is written to the file. Check the file for the error, adjust the credentials accordingly, and restart the Agent service.

6. Log in to the PowerChute web interface with your new credentials.
 
Was this helpful?
What can we do to improve the information ?