raccli switchover dataguard

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

The switchover dataguard subcommand of the raccli utility is used to perform a switchover to the standby database in your Data Guard configuration. You can run this subcommand on a compute node of either the primary or standby database.
raccli switchover dataguard [-dbname database-name]  -passwd database-password

When the switchover operation completes successfully, the roles of the two databases are reversed: what was the primary database is now the standby database, and what was the standby database is now the primary database. Both remain as members of the Data Guard configuration.

This subcommand runs asynchronously. That is, it creates a job to perform the switchover, reports the job ID of the created job, and then exits. To track the progress of the job to its completion, use the raccli describe job command.

If the subcommand fails, it reports a FAILURE status and provides a message describing the reason for the failure.


You must manually configure backups after the switchover operation completes. For instructions, see Manual backup configuration required after switchover or failover on Oracle RAC plus Data Guard deployments in Known Issues for Oracle Database Classic Cloud Service.

Options of this subcommand are as follows.

Option Description

-dbname database-name

(Optional) The database unique name of the standby database that will be the primary database after the switchover completes.

-passwd database-password

The password of the database’s SYS user.