Use Oracle Data Guard with Exadata Cloud Infrastructure

Learn to configure and manage Data Guard groups in your VM cluster.

About Using Oracle Data Guard with Exadata Cloud Infrastructure

Oracle Data Guard provides a comprehensive set of services that create, maintain, manage, and monitor one or more standby databases to enable production Oracle databases to survive disasters and data corruptions.

Oracle Data Guard maintains these standby databases as copies of the production database. Then, if the production database becomes unavailable because of a planned or an unplanned outage, Oracle Data Guard can switch any standby database to the production role, minimizing the downtime associated with the outage. Oracle Data Guard can be used with traditional backup, restoration, and cluster techniques to provide a high level of data protection and data availability. Oracle Data Guard transport services are also used by other Oracle features such as Oracle Streams and Oracle GoldenGate for efficient and reliable transmission of redo from a source database to one or more remote destinations.

For complete information on Oracle Data Guard, see the Oracle Data Guard Concepts and Administration documentation and Oracle Data Guard Broker Concepts on the Oracle Database Documentation portal.

This topic explains how to use the Console or the API to configure and manage Data Guard resources in your VM cluster.

When you use the Console or the API to enable Data Guard for an Exadata database compute node database:

  • The standby database that is created is a physical standby.
  • The versions of peer databases (primary and standby) are identical.
  • The standby database is deployed as an open, read-only database (Active Data Guard).
  • A primary database can support up to a maximum of six standby databases.

Prerequisites for Using Oracle Data Guard with Exadata Cloud Infrastructure

An Exadata Cloud Infrastructure Oracle Data Guard implementation requires two existing Exadata VM Clusters: one containing an existing database that is to be duplicated by Data Guard, and one that will house the new standby database by Data Guard.

Note

Oracle strongly recommends the primary and standby databases for any production workloads be on different Exadata Cloud Infrastructures for better fault isolation and disaster protection. If you are adding a new standby in the same region with multiple availability domains, Oracle recommends choosing a separate availability domain for complete availability domain or data center fault isolation. If you are adding a new standby across regions, the standby will have fault isolation for a regional failure as well.

When enabling Data Guard, you must create a new Database Home on the standby instance to host the new standby database. Alternatively, you can provision the standby database within an existing Database Home on the standby instance. For information on creating the required resources for the standby system, see the following topics:

You can use a custom database software image to that contains the necessary patches for your databases when creating a Database Home on either the primary or the standby Exadata instance. See Oracle Database Software Images for information on working with custom Oracle Database software images.

If you choose to provision a standby database in an existing Database Home, ensure that the target Database Home on the standby instance has all required patches that are in use for the primary database before you provision the standby database. See the following topics for more information on patching an existing Database Home:

If you are creating a Data Guard group and you are using customer managed keys to encrypt the database, you must have configured the Vault Service and created a master key. See To administer Vault encryption keys and Key and Secret Management Concepts.

Network Requirements for Data Guard

Before setting up Data Guard ensure that your Exadata Cloud Infrastructure environment meets the following network requirements:

  • The primary and standby databases can be part of VM clusters in different compartments.
  • If you want to configure Oracle Data Guard across regions, then you must configure remote virtual cloud network (VCN) peering between the primary and standby databases. Networking is configured on the cloud VM cluster resource for systems using the The new Exadata Resource Model, and on the DB system resource for system using the old resource model. See Remote VCN Peering using an RPC .

    For Exadata Data Guard configurations, OCI supports the use of hub-and-spoke network topology for the VCNs within each region. This means that the primary and standby databases can each utilize a "spoke" VCN that passes network traffic to the "hub" VCN that has a remote peering connection. See Transit Routing inside a hub VCN for information on setting up this network topology.

  • To set up Oracle Data Guard within a single region, both Exadata Cloud Infrastructure instances must use the same VCN. When setting up Data Guard within the same region, Oracle recommends that the instance containing the standby database be in a different availability domain from the instance containing the primary database to improve availability and disaster recovery.
  • Configure the ingress and egress security rules for the subnets of both Exadata Cloud Infrastructure instances in the Oracle Data Guard association to enable TCP traffic to move between the applicable ports. Ensure that the rules you create are stateful (the default).

    For example, if the subnet of the primary Exadata Cloud Infrastructure instance uses the source CIDR 10.0.0.0/24 and the subnet of the standby instance uses the source CIDR 10.0.1.0/24, then create rules as shown in the subsequent example.

Note

The egress rules in the example show how to enable TCP traffic only for port 1521, which is a minimum requirement for Oracle Data Guard to work. If TCP traffic is already enabled for all destinations (0.0.0.0/0) on all of your outgoing ports, then you need not explicitly add these specific egress rules.

Security Rules for Subnet of Primary Exadata Cloud Infrastructure instance

Ingress Rules:
Stateless: No
Source: 10.0.1.0/24 
IP Protocol: TCP 
Source Port Range: All 
Destination Port Range: 1521
Allows: TCP traffic for ports: 1521
Egress Rules:
Stateless: No
Destination: 10.0.1.0/24 
IP Protocol: TCP 
Source Port Range: All
Destination Port Range: 1521
Allows: TCP traffic for ports: 1521

Security Rules for Subnet of Standby Exadata Cloud Infrastructure instance

Ingress Rules:
Stateless: No
Source: 10.0.0.0/24 
IP Protocol: TCP 
Source Port Range: All 
Destination Port Range: 1521
Allows: TCP traffic for ports: 1521
Egress Rules:
Stateless: No
Destination: 10.0.0.0/24 
IP Protocol: TCP 
Source Port Range: All
Destination Port Range: 1521
Allows: TCP traffic for ports: 1521

For information about creating and editing rules, see Security Lists .

Password Requirements

To change the SYS password or rotate TDE keys, use OCI API.

Known Issues for Exadata Cloud Infrastructure and Data Guard

Possible TDE key replication issue, and MRP and DG LCM operation failures.

KMS RPM libkmstdepkcs11_1.286-1.286-1-Linux.rpm is the latest available which supports active replication of key between cross-region KMS vaults (source and target), and it is recommended to upgrade the RPM on clusters participating in Data Guard. OCI Vault cross-region Data Guard works with a lower version of RPM, but the older version does not guarantee active replication of keys. If the TDE keys have any replication issue between vaults, Data Guard replication might have an impact (MRP fails on standby cluster due to missing key on target vault) and MRP could resume only after the keys are replicated to the target vault. To avoid MRP and DG LCM operation failures, upgrade the libkms RPM on both the clusters, and restart the databases (only databases using customer-managed keys).

Adding a Node to a VM Cluster

When adding a node to a VM cluster, an instance of the Data Guard database is automatically created on the new node. However, metadata updation on the remote database, that is, the primary database if addition is done on the standby database and vice versa, must be done manually.

This can be done by copying over the addinstance JSON file, /var/opt/oracle/dbaas_acfs/<dbname>/addInstance.json created at the end of instance addition and running the /var/opt/oracle/ocde/rops update_instance <dbname> <path to addInstance JSON> command on any node of the remote cluster.

Removing a Node from a VM Cluster

When removing a node from a VM cluster, the instance and it's metadata on the removing node is deleted automatically. However, deletion of the corresponding metadata on the remote database, that is, the primary database if removal is done on the standby database and vice versa, must be done manually.

This can be done by running the /var/opt/oracle/ocde/rops remove_instance <dbname> <Instance Name> command on any node of the remote cluster.

Working with Data Guard

Oracle Data Guard ensures high availability, data protection, and disaster recovery for enterprise data.

The primary and standby databases constitute a Data Guard group. Most of your applications access the primary database. A standby database is a transactionally consistent copy of the primary database.

Data Guard maintains the standby database by transmitting and applying redo data from the primary database. If the primary database becomes unavailable, you can use Data Guard to switchover or failover the standby database to the primary role. This is true even if you have more than one standby database.

Switchover

A switchover reverses the primary and standby database roles.

Each database continues to be part of the Data Guard group in its new role. A switchover ensures no data loss. You can use a switchover before you perform planned maintenance on the primary database. Performing planned maintenance on an Exadata database virtual machine with a Data Guard group is typically done by switching the primary to the standby role, performing maintenance on the standby, and then switching it back to the primary role.

Failover

A failover transitions the standby database into the primary role after the existing primary database fails or becomes unreachable.

The failover may or may not result in data loss depending upon the protection mode and whether your primary and target standby databases were synchronized at the time of the primary database failure. For more information refer to Manual Failover in the Data Guard documentation.

Reinstate

Reinstates a database into the standby role in a Data Guard group.

You can use the reinstate command to return a failed database into service after correcting the cause of failure.

Note

You cannot terminate a primary database that is part of a Data Guard group that contains one or more standby databases. You will have to terminate the standby databases first. Alternatively, you can switch over the primary database to the standby role, and then terminate the former primary.

You cannot terminate a VM cluster that includes Data Guard enabled databases. You must first terminate the standby databases that are part of the Data Guard group.

Using the Console to Manage an Oracle Data Guard group

Learn how to enable a Data Guard group between databases, change the role of a database in a Data Guard group using either a switchover or a failover operation, and reinstate a failed database.

When you enable Data Guard, a separate Data Guard group is created between the primary and the standby databases.

Using the Console to Enable Data Guard on an Exadata Cloud Infrastructure System

Learn to set up Data Guard group between databases.

Note

  • When you enable Data Guard, replication of data happens only over the client network.
  • When you configure a Data Guard group, the primary and standby databases must be on the same major release version while the standby database can be on a higher minor version.

As part of the latest release we are introducing an enhanced user experience and new APIs to improve performance and provide additional Data Guard capabilities including support for multiple standby databases via cloud automation.

  • With the new API, your new Data Guard configuration will be created as a Data Guard group resource.
  • If you have an existing Data Guard setup, you can continue to use current capabilities with no impact. However, if you wish to create multiple standby databases, you will need to migrate to the new API model, which can be done at any time.
  • If you currently have automation that manages Data Guard operations using the existing Data Guard Association API, you will need to update your applications to use the new API to take advantage of these new capabilities

    Oracle currently supports both the existing Data Guard Association API and the new Data Guard group API and the associated user interfaces.

  1. Open the navigation menu. Under Oracle Database, click Oracle Exadata Database Service on Dedicated Infrastructure.
  2. Choose your Compartment that contains the Exadata Cloud Infrastructure instance with the database for which you want to enable Oracle Data Guard..
  3. Navigate to the cloud VM cluster or DB system that contains a database you want to assume the primary role:
    • Cloud VM clusters ( new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
    • DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.
  4. On the VM cluster or DB system details page, in the Databases section, click the name of the database you want to make primary.
  5. On the Database Details page, under Resources, click Data Guard Associations.
  6. Click Add standby.
  7. On the Add standby page, configure your Data Guard group.
    • In the Select peer DB system section, provide the following information for the standby database to obtain a list of available Exadata systems in which to locate the standby database:
      • Region: Select a region where you want to locate the standby database. The region where the primary database is located is selected, by default. You can choose to locate the standby database in a different region. The hint text associated with this field tells you in which region the primary database is located.
      • Availability domain: Select an availability domain for the standby database. The hint text associated with this field tells you in which availability domain the primary database is located.
      • Shape: Select the shape of the standby Exadata system.
      • Data Guard peer resource type: Select DB System or VM Cluster.
      • Select a DB system or cloud VM cluster from the drop-down list.
    • Choose the Data Guard experience:
      • Use the new Data Guard group Resource With this option, your new Data Guard configuration will be created as a Data Guard group resource. This option with new APIs supports adding multiple standby databases and provides other enhancements. If you currently have automation that manages Data Guard operations using the existing Data Guard Association API, you can update your applications to use the new API to take advantage of these new capabilities.
      • Use the existing Data Guard Association Resource Choose this option if your automation for managing Data Guard operations relies on the existing Data Guard Association API. However, you will not be able to add multiple standby databases and will not get the enhancements provided by the new API.
    • Data Guard group details:
      • Data Guard Type: Select Active Data Guard or Data Guard. Active Data Guard provides additional features including: Real-Time Query and DML Offload, Automatic Block Repair, Standby Block Change Tracking, Far Sync, Global Data Services, and Application Continuity. Note that Active Data Guard requires an Oracle Active Data Guard license. For more information on Active Data Guard, see Active Data Guard. For a complete overview of both Data Guard types, see Introduction to Oracle Data Guard
      • Protection mode: The protection mode can be Maximum Performance or Maximum Availability. See Oracle Data Guard Protection Modes for information on these options.
      • Transport type: The redo transport type used for this Data Guard group. See Redo Transport Servicesfor information on these options.

        Protection Mode and Transport Type: Rules for Standby Database Creation

        • Creating the first standby: You cannot modify the Protection Mode or Transport Type for the first standby database during its creation. It is possible to modify it later.
          • The default settings are:
            • Protection Mode: Max Performance
            • Transport Type: Async
        • Creating the second to Nth standby: You cannot modify the Protection Mode or Transport Type for any subsequent standby databases.
          • The Protection Mode is inherited from the first standby.
          • The default Transport Type is set to Async.
    • In the Choose Database Home section, choose one of the following:
      • Select an existing Database Home: If you use this option, select a home from the Database Home display name drop-down list.
      • Create a new Database Home: If you choose this option, enter a name for the new Database Home in the Database Home display name field. Click Change Database Image to select a database software image for the new Database Home. In the Select a Database Software Image panel, do the following:
        1. Select the compartment containing the database software image you want to use to create the new Database Home.
        2. Select the region containing the database software image you want to use to create the new Database Home. Region filter defaults to the currently connected region and lists all the software images created in that region. When you choose a different region, the software image list is refreshed to display the software images created in the selected region.
        3. Select the Oracle Database software version that the new Database Home will use, then choose an image from the list of available images for your selected software version.
        4. Click Select.
        Note

        • Oracle recommends applying the same list of patches to the Database Homes of the primary and standby databases.
        • If you are using the new Data Guard group resource, you must first create the database home before adding the standby database.
    • In the Configure standby database: section, provide standby database details.
      Note

      You cannot modify the db_unique_name and SID prefix after creating the database.
      • Database unique name: Optionally, specify a value for the DB_UNIQUE_NAME database parameter. This value must be unique across the primary and standby cloud VM clusters. The unique name must meet the requirements:
        • Maximum of 30 characters
        • Contain only alphanumeric or underscore (_) characters
        • Begin with an alphabetic character
        • Unique across the VM cluster. Recommended to be unique across the tenancy.
        If not specified, the system automatically generates a unique name value, as follows:
        <db_name>_<3_chars_unique_string>_<region-name>
      • Database password: Enter the database administrator password of the primary database. Use this same database administrator password for the standby database.

        Note

        The administrator password and the TDE wallet password must be identical. If the passwords are not identical, then follow the instructions in Changing the Database Passwords to ensure that they are.
      • TDE wallet password: Enter the TDE wallet password.
  8. Click Show advanced Options to specify advanced options for the standby database:
    • Management:

      Oracle SID prefix: The Oracle Database instance number is automatically added to the SID prefix to create the INSTANCE_NAME database parameter. The INSTANCE_NAME parameter is also known as the SID. If not provided, then the SID prefix defaults to the first 12 characters of the db_unique_name.
      Note

      Entering an SID prefix is only available for Oracle 12.1 databases and above.

      The SID prefix must meet the requirements:

      • Maximum of 12 characters
      • Contain only alphanumeric characters
      • Begin with an alphabetic character
      • Unique in the VM cluster and across primary and standby databases
  9. Click Add standby. When you create the association, the details for a database and its peer display their respective roles as Primary or Standby.

A work request is issued to configure the Data Guard association. The progress of the request and the stages of provisioning can be viewed on the Work Requests page of the respective Standby database.

When the association is created, the details for a database and its peer display their respective roles as Primary or Standby.

To view Data Guard group details of databases in a Cloud VM Cluster

To view the role of each database in a Data Guard group in an Cloud VM Cluster, follow this procedure.

  1. Open the navigation menu. Under Oracle Database, click Oracle Exadata Database Service on Dedicated Infrastructure.
  2. Choose your Compartment.
  3. Navigate to the cloud VM cluster that contains the databases you wish to view their roles in Data Guard associations.
  4. In the Databases section under Resources, the role of each database in this VM Cluster is indicated in the Data Guard role column.

To enable automatic backups on a standby database

Learn to enable automatic backups on a standby database.

  1. Open the navigation menu. Under Oracle Database, click Oracle Exadata Database Service on Dedicated Infrastructure.
  2. Choose your Compartment that contains the Exadata Cloud Infrastructure instance with the database for which you want to enable automatic database.
  3. Navigate to the cloud VM cluster or DB system that contains the primary database.
    • Cloud VM clusters ( new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.

    • DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.

  4. On the VM cluster or DB system details page, in the Databases section, click the name of the primary database.
  5. On the Database Details page, under Resources, click Data Guard group.
  6. Click the name of the standby database for which you want to enable automatic backups.

    The system displays a banner if automatic backups are not enabled for this database.

  7. Click Enable automatic backups on the banner.
  8. On the resulting Configure Automatic Backups window, enter the following details:
    • Enable automatic backup: Check the check box to enable or disable automatic incremental backups for this database.
      Note

      • If your database is in a security zone compartment, you must enable automatic backups.
      • If you are enabling automatic backups, you can select to configure Recovery Service or Object Storage as the Backup destination. However, if the backup was already configured on the primary database, then the standby must use the same backup destination.
    • If Recovery Service is selected as the Backup destination, you can configure the following options:
      • Protection policy: You can select from one of the preset protection policies or a custom policy. The system automatically deletes your backups at the end of your chosen protection policy recovery window.
      • Real-time data protection: Real-time protection is the continuous transfer of redo changes from a protected database to Recovery Service. This reduces data loss and provides a recovery point objective (RPO) near 0. This is an extra cost option.
      • Deletion options after database termination: You can use the following options to retain managed database backups after the database is terminated. These options can also help restore the database from backups in case of accidental or malicious damage to the database.
        • Retain backups according to the retention period: When a database is terminated, the automatic database backups associated with the terminated database and all of its resources will be removed at the end of the specified retention period.
        • Retain backups for 72 hours, then delete: When a database is terminated, the automatic database backups associated with the terminated database and all of its resources will be retained for 72 hours and then deleted. The backups are retained for 72 hours to safeguard against accidental deletion by the user.
      • Scheduled day for initial backup: Select a day of the week for the initial backup to begin.
      • Scheduled time for initial backup (UTC): Select a time for the initial backup to begin. The initial backup could start at any time or within the chosen two-hour scheduling window.
      • Scheduled time for daily backup (UTC): Select a time for the daily backup to begin. The daily backup could start at any time or within the chosen two-hour scheduling window.
      • Take the first backup immediately: A full backup is an operating system backup of all data files and the control file that constitute an Oracle Database. A full backup must also include the parameter files associated with the database. You can take a database backup when the database is shut down or while the database is open. You must not typically take a backup after an instance failure or other unusual circumstances. If you select to defer the initial backup, your database may not be recoverable in the event of a database failure.
    • If Object Storage is selected as the Backup destination, you can configure the following options:
      • Backup retention period: If you select to enable automatic backups, you can select a policy with one of the preset retention periods. The system automatically deletes your incremental backups at the end of your chosen retention period. You can change the backup retention period after provisioning.
      • Deletion options after database termination: You can use the following options to retain managed database backups after the database is terminated. These options can also help restore the database from backups in case of accidental or malicious damage to the database.
        • Retain backups according to the retention period: When a database is terminated, the automatic database backups associated with the terminated database and all of its resources will be removed at the end of the specified retention period.
        • Retain backups for 72 hours, then delete: When a database is terminated, the automatic database backups associated with the terminated database and all of its resources will be retained for 72 hours and then deleted. The backups are retained for 72 hours to safeguard against accidental deletion by the user.
      • Scheduled day for full backup: Select a day of the week for the initial and future full backups to begin.
      • Scheduled time for full backup (UTC): Select a time for the full backup to begin. The full backup could start at any time or within the chosen two-hour scheduling window.
      • Scheduled time for incremental backup (UTC): Select a time for the incremental backup to begin. The incremental backup could start at any time or within the chosen two-hour scheduling window.
      • Take the first backup immediately: A full backup is an operating system backup of all data files and the control file that constitute an Oracle Database. A full backup must also include the parameter files associated with the database. You can take a database backup when the database is shut down or while the database is open. You must not typically take a backup after an instance failure or other unusual circumstances. If you select to defer the initial backup, your database may not be recoverable in the event of a database failure.
  9. Click Save Changes.

To perform a database switchover

You can initiate a switchover operation on a standby database that is a member of the Data Guard group.

  1. Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure
  2. Choose the Compartment that contains the Exadata Cloud Infrastructure instance with the database for which you want to enable Oracle Data Guard.
  3. Navigate to the cloud VM cluster or DB system that contains the Data Guard association:

    Cloud VM clusters (new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.

    DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.

  4. Under Resources, click Data Guard group.
  5. Select the standby database in the Data Guard group on which you want to perform a switchover. Click the Actions icon (three dots), and then click Switchover.
  6. In the Switchover database dialog box, enter the database admin password, and then click Switchover.

    This database should now assume the role of the standby, and the standby should assume the role of the primary in the Data Guard group.

To edit the Oracle Data Guard group details

  1. Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure
  2. Choose the Compartment that contains the Exadata Cloud Service instance with the database for which you want to enable Oracle Data Guard.
  3. Navigate to the cloud VM cluster or DB system that contains the Data Guard association:

    Cloud VM clusters ( new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.

    DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.

  4. Under Resources, click Data Guard group.

    A list of databases that are members of the Data Guard group is displayed with the Data Guard type you have chosen for each Data Guard group member.

  5. To edit Data Guard group details, click the Actions icon (three dots), and then click Edit.
  6. In the Edit Data Guard group panel, configure the Data Guard group:
    • Data Guard Type: Select Active Data Guard or Data Guard. Active Data Guard provides additional features including: Real-Time Query and DML Offload, Automatic Block Repair, Standby Block Change Tracking, Global Data Services, and Application Continuity. Note that Active Data Guard requires an Oracle Active Data Guard license. For more information on Active Data Guard, see Active Data Guard. For a complete overview of both Data Guard types, see Introduction to Oracle Data Guard
    • Protection mode: The protection mode can be Maximum Performance or Maximum Availability. See Oracle Data Guard Protection Modes for information on these options.
    • Transport type: The redo transport type used for this Oracle Data Guard group.

    • Database admin password: Enter the ADMIN password for the database.
  7. Click Save.

To perform a database failover

You can initiate a failover operation on a standby database that is a member of the Data Guard group.

  1. Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure
  2. Choose the Compartment that contains the Exadata Cloud Infrastructure instance with the database for which you want to enable Oracle Data Guard.
  3. Navigate to the cloud VM cluster or DB system that contains the Data Guard association:

    Cloud VM clusters ( new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.

    DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.

  4. Under Resources, click Data Guard group.
  5. Select the standby database in the Data Guard group on which you want to perform a failover. Click the Actions icon (three dots), and then click Failover.
  6. In the Failover database dialog box, enter the database admin password, and then click Failover.
    Note

    You can initiate a failover even if the primary database is in a healthy state; however, exercise caution when performing a failover.

    This database should now assume the role of the primary, and the old primary's role should display as Disabled Standby.

To reinstate a database

After you fail over a primary database to its standby, the standby assumes the primary role and the old primary is identified as a disabled standby. After you correct the cause of failure, you can reinstate the failed database as a functioning standby for the current primary.

  1. Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure
  2. Choose the Compartment that contains the Exadata Cloud Infrastructure instance with the database for which you want to enable Oracle Data Guard.
  3. Navigate to the cloud VM cluster or DB system that contains the Data Guard association:

    Cloud VM clusters (new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.

    DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.

  4. Under Resources, click Data Guard group.
  5. For the Data Guard group on which you want to reinstate this database, click the Actions icon (three dots), and then click Reinstate.
  6. In the Reinstate database dialog box, enter the database admin password, and then click Reinstate.

    This database should now be reinstated as the standby in the Data Guard group.

To terminate a Data Guard group on an Exadata Cloud Infrastructure instance

On an Exadata Cloud Infrastructure instance, you remove a Data Guard group by terminating all the standby database.

  1. Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure.
  2. Choose the Compartment that contains the Exadata Cloud Infrastructure instance with the database for which you want to enable Oracle Data Guard.
  3. Navigate to the cloud VM cluster or DB system that contains the standby database:

    Cloud VM clusters (new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.

    DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.

  4. For the standby database you want to terminate, click the Actions icon (three dots), and then click Terminate.
  5. In the Terminate database dialog box, enter the name of the database, and then click OK.

Using the API to manage Data Guard associations

Use these API operations to manage Data Guard associations on an Exadata Cloud Infrastructure instance:

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

For the complete list of APIs for the Database service, see Database Service API.

Using the API to manage Data Guard group

Use these API operations to manage a Data Guard group on an Exadata Cloud Infrastructure instance:

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Operation REST API Endpoint Comment

Create / Add Standby Database

CreateDatabase

  • The same API is being used for creating a first standby and add more standby databases.
  • It uses the existing create database API with source as "DATAGUARD"

Update Data Guard group Configuration

UpdateDataGuard

It takes either standby or primary database OCID to update the configuration.

Data Guard Action - Switchover

SwitchOverDataGuard

Switchover should be triggered on respective standby that to become primary.

Data Guard Action - Failover

FailoverDataGuard

Failover should be triggered on respective standby that to become primary.

Data Guard Action - Reinstate

ReinstateDataGuard

Reinstate should be triggered on respective standby to be reinstated.

Delete Standby

DeleteDatabase

  • Delete standby remains same as existing.- DeleteDatabase
  • Call goes on respective standby to be deleted.

Migrate Data Guard Association to multiple standby

MigrateDataGuardAssociationToMultiDataGuards

  • Migrate the existing data guard association to Data Guard group model.
  • New standby can be added only after migration is completed.

For the complete list of APIs for the Database service, see Database Service API.