Updating the Password for Backing Up to the Storage Cloud

Whenever the password is changed for an Oracle Cloud user whose credentials are used for backing up to an Oracle Storage Cloud container, you need to update the user’s password in the Oracle Wallet file that maintains the credentials.

Because Oracle Cloud requires users to change their passwords on a regular basis, you need to perform this task regularly.

You can update the password by using the Oracle Database Classic Cloud Service console or, if desired, by using one of the ways listed in Other Ways to Update the Password at the end of this topic.

Updating the Password by Using the Oracle Database Classic Cloud Service Console

Note:

Currently, you cannot use the Oracle Database Classic Cloud Service console to update the password on database deployments hosting an Oracle Real Application Clusters (RAC) database. Instead you must use the raccli utility. See Updating the Password by Using the raccli Utility.

Go to the Backup page of the deployment whose backup credentials you want to update:
1. Open the Oracle Database Classic Cloud Service console.
  
  For detailed instructions, see Accessing the Oracle Database Classic Cloud Service Console.
2. Click the name of the database deployment whose backup credentials you want to update.
  
  The Overview page for the deployment is displayed.
3. Click the Administration tile.
  
  The Backup page for the deployment is displayed.
Click Configure Backups.

The Configure Backups window is displayed.
Enter the Cloud user name and new password.
Click Save and then confirm the operation.

Other Ways to Update the Password

For database deployments hosting single-instance databases, you can use the bkup_api utility. See Updating the Password by Using the bkup_api Utility.
For database deployments hosting Oracle Real Application Clusters (RAC) databases, you can use the raccli utility. See Updating the Password by Using the raccli Utility.

Updating the Password by Using the bkup_api Utility

You use the bkup_api utility to update the Oracle Wallet file containing the backup user’s password:

Connect as the opc user to the compute node.

For detailed instructions, see Connecting to a Compute Node Through Secure Shell (SSH).
Start a root-user command shell:
```
$ sudo -s
#
```
Enter this bkup_api command to generate a file containing the current backup settings:
```
# /var/opt/oracle/bkup_api/bkup_api get config [--file=filename] --dbname=dbname
```
where filename is an optional parameter used to specify a name for the file that will be generated and dbname is the database name for the database that you want to act on.
Edit the generated file, setting the value of the bkup_oss_passwd parameter to the new password.
Enter this bkup_api command to update the backup settings using the file you generated:
```
# /var/opt/oracle/bkup_api/bkup_api set config --file=filename --dbname=dbname
```
where filename is used to specify a name for the file that will be used to update the backup settings and dbname is the database name for the database that you want to act on.
You can use this bkup_api command to check the status of the update:
```
# /var/opt/oracle/bkup_api/bkup_api configure_status
```
Exit the root-user command shell:
```
# exit
$
```

Any changes you make by using the bkup_api command are not reflected in the Oracle Database Classic Cloud Service console.

Updating the Password by Using the raccli Utility

This topic does not apply to Oracle Cloud Infrastructure or to Oracle Cloud at Customer.

On database deployments hosting an Oracle Real Application Clusters (RAC) database you use the raccli utility to update the Oracle Wallet file containing the backup user’s password:

Note:

If you have used the update rdk subcommand of the raccli utility to update the cloud tooling to 16.4.5 or later, you must manually update the opc installer for the Oracle Database Cloud Backup Module before you use the update backupconfig subcommand. For instructions, see in Updating the cloud tooling on a deployment hosting Oracle RAC requires manual update of the Oracle Database Cloud Backup Module in Known Issues for Oracle Database Classic Cloud Service.

Connect to the compute node as the opc user.

For detailed instructions, see Connecting to a Compute Node Through Secure Shell (SSH).
Update the password:
```
$ raccli update backupconfig -params '{"cloudStorageUser":"user-name","cloudStoragePwd":"new-password"}'
```
where user-name is the user name of the Oracle Cloud user whose credentials are used to access the Storage Cloud Service container and new-password is this user's new password.

If the update succeeds, output from the command indicates that the wallet was successfully created and the credentials are valid. If you could not authenticate, you entered the wrong password and need to try again with the correct credentials.