Change a Password with the Utility

Use the Password Change Utility to alter the password of administration and database accounts.

Caution:

Starting with STA 2.3.0, you must use the utility to change passwords for the STA application, database, and WebLogic console. Do not use the WebLogic Administration console as it will result in password mismatches, and you will need to reinstall STA.

Prerequisites

STA version 2.3.0 or above
You must be logged in as the system root user.
The STA application must be running. See Display the Status of the STA Application to verify.
You must know the Weblogic administrator username and password.
You must know the username and current password of the accounts you are updating.
If you are changing a database account password, you must also know the current STA database root account password.
The Oracle user path must be correctly configured. See Configure the Correct Oracle User Path.

Procedure

Verify all prerequisites listed above.
The utility will stop and restart all STA processes to implement the new passwords. Therefore, you should back up the STA database before using the utility.
On the STA server, open a terminal session. Log in as the Oracle user.
Verify that the STA application is running:
```
$ STA status all
```
It may take a few minutes. Once complete, you should see: staui service is running .... and the deployed application for staui is in an ACTIVE state

If the application is not running, restart it. See Restart the STA Application.
Start the Password Change Utility.
```
$ changeSTAPasswords.sh
```

At the prompts, enter the WebLogic administrator username and password.

Enter WebLogic Administrator username         : weblogic
Enter current WebLogic Administrator password :

The utility main menu appears.

Select password to change
 
  1) All STA Account passwords
  2) WebLogic Administrator password
  3) STA Administrator password
  4) STA Database Root User password
  5) STA Database Application User password
  6) STA Database Reports User password
  7) STA Database Administrator password
  8) Exit

Select an option and follow the prompts to change the password of the user.

If changing All STA Account passwords, review What Occurs If a Password Update Fails When Changing All Passwords.

Caution:

Always record and track password changes in a secure location. There is no way to recover a forgotten password.

The utility updates the passwords in the WebLogic server and the MySQL database.

Connecting to MySQL and updating STA Database Administrator password ....... 
.STA Backup Service does not exist.
.Updating DBA password for STA backup service.
STA Resource Monitor Service does not exist.

Password change successful. ...

The utility restarts the STA application and all associated services. This may take several minutes. When the process is done, press Enter to return to the utility Main Menu.
```
Restarting all STA services. This operation may take up to 20 minutes.
........................Press [ENTER] to return to Main Menu
```
IMPORTANT: If you changed the STA Database Administrator password, you must update the Resource Monitor and Backup Services with the new password. Then, stop and restart the Services Daemon.