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:
-
Open the Oracle Database Classic Cloud Service console.
For detailed instructions, see Accessing the Oracle Database Classic Cloud Service Console.
-
Click the name of the database deployment whose backup credentials you want to update.
The Overview page for the deployment is displayed.
-
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 anddbname
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 anddbname
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 andnew-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.