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.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.
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.
If a password update fails, the utility does not modify the affected account and exits the change operation. However, all earlier password changes remain and do not revert back.
The change All STA Account Passwords operation breaks the password change into six transactions, one for each account: Weblogic user, STA administrator, database root, STA application user, STA report user, and STA database administrator. In total, you will enter about 20 passwords, including the current passwords for each account and the new passwords which you will enter twice to ensure they are not mis-typed. You should carefully enter all passwords. The update operation will fail if you incorrectly enter an existing password, and the utility does not always allow you to correct a mistake. When the failure occurs, the utility does not modify the affected account and exits the password change operation. However, it does update any earlier password changes that you made before the failure.
If a failure occurs while updating all password, you should verify which passwords were changed and track the password changes in a secure location. There is no way to recover a forgotten password.
When you have finished specifying new passwords, the utility makes specific updates to the applications.
The utility:
Synchronizes the new passwords between the WebLogic server, MySQL database, and STA application, as applicable.
Stops and restarts all STA processes. Some library transactions will be lost during this process.
If you changed the STA database administrator password, the utility does not automatically update the Backup Service and Resource Monitor Service with the new password. You must update the services with the new password and then restart the Services Daemon.
The STA Password Change Utility logs track all updates made by the utility. The logs can useful for troubleshooting issues with the STA utility or the accounts themselves.
The logs are located in the following directory:
/var/log/tbi/changeutilityFollowing is a sample directory listing showing the files.
$ ls -l /var/log/tbi/changeutility
-rw-r--r-- 1 oracle oinstall 126 Feb 22 09:44 STAChangeUtility-0.log
The log records when the STA Password Change Utility is used. For each log, there may be up to 10 different log files in the directory, each with a sequential number, 0 to 9, indicating their order. Log "0" is always the active log, and logs "1" through "9" are historical. Log files have a 1.0 MB size limit, and when log "0" reaches the limit, the logs are rotated—log "0" becomes log "1", log "1" becomes log "2", and so on—and a new log "0" is started. Any existing log "9" is overwritten by log "8" and effectively deleted, or rolled off.