Oracle Cloud Infrastructure Documentation

Creating and Maintaining Disaster Recovery Configurations

A DR configuration is the parent object to which you add Private Cloud Appliance cloud resources that you want to protect against system outages. You start by creating an empty DR configuration with an associated ZFS project on the ZFS Storage Appliance.

If your system contains optional high-performance disk shelves, two ZFS projects are created for each DR configuration: one in the standard pool and one in the high-performance pool. When you add instances to the DR configuration that have disks running on standard as well as high-performance storage, those storage resources are automatically added to the ZFS project in the appropriate pool.

Creating a DR Configuration

Using the Service CLI

  1. Gather the information that you need to run the command:

    • a unique name for the DR configuration

    • a unique name for the associated ZFS storage project

  2. Create an empty DR configuration with the create DrConfig command.

    Syntax (entered on a single line):

    create DrConfig 
configName=<DR_configuration_name>
zfsProjectName=<ZFS_storage_project_name>

    Example:

    PCA-ADMIN> create DrConfig configName=mydrconf1 zfsProjectName=mydrconf1-project
JobId: 16047c38-1a7e-48ac-9588-297b915d49fc
Data: DrConfig id: d3cd87de-afd4-4718-a3e6-1105b56b42d8. Successfully started job to create config mydrconf1

  3. Use the job ID to check the status of the operation you started.

    PCA-ADMIN> show Job id=16047c38-1a7e-48ac-9588-297b915d49fc
Data:
  Id = 16047c38-1a7e-48ac-9588-297b915d49fc
  Type = Job
  Associated Work Request Id = 20d20925-39d1-4f9a-beef-5e9d3ca465d5
  Done = true
  Name = CREATE_TYPE
  Progress Message = DrConfig id: d3cd87de-afd4-4718-a3e6-1105b56b42d8. Successfully created DR config mydrconf1: d3cd87de-afd4-4718-a3e6-1105b56b42d8
  Run State = Succeeded
  Transcript = Created job CREATE_TYPE
  Username = admin
  WorkItemIds 1 = id:e82eeec2-7881-45c5-ae84-6a3894ef66c6  type:WorkItem  name:

  4. When the DR configuration is created, the storage project for data replication is set up on the ZFS Storage Appliances. Note the DR configuration ID. You need it for all subsequent commands to modify the configuration.

  5. To display a list of existing DR configurations, use the drGetConfigs command.

    PCA-ADMIN> drGetConfigs
Data:
  id                                     Config Name
  --                                     -----------
  d3cd87de-afd4-4718-a3e6-1105b56b42d8   mydrconf1
  e8291afa-a413-4932-880a-abb8ac22c85d   mydrconf2
  7ad05d9f-731c-41b8-b477-35da4b999071   mydrconf3

  6. To display the status and details of a DR configuration, use the show DrConfig command.

    PCA-ADMIN> show DrConfig id=d3cd87de-afd4-4718-a3e6-1105b56b42d8
Data:
  Id = d3cd87de-afd4-4718-a3e6-1105b56b42d8
  Type = DrConfig
  Config State = Enabled
  Config Name = mydrconf1
  Config Id = d3cd87de-afd4-4718-a3e6-1105b56b42d8
  Zfs Project Name = mydrconf1-project
  Message = Successfully retrieved config data
  Message = Successfully retrieved config data
  Replica State = OK
  Replica Lag In Seconds = 3
Using the Service Web UI

  1. Under Disaster Recovery Service, open the DR Configurations page. In the top-right corner, click Create Configuration.

  2. In the Create Configuration window, enter the following information:

    • a unique name for the DR configuration

    • a unique name for the associated ZFS storage project

  3. Click Submit. A new, empty DR configuration appears in the table.

    Next, you add site mappings and instances to the DR configuration.

About the DR Configuration State

The normal working state of a DR configuration is "Enabled". However, as part of the process of DR plan execution, the state of the DR configurations changes. In general, an administrator is not expected to manually change the state, but it might be useful, and it is possible to temporarily disable a DR configuration.

The following configuration states occur:

  • Enabled: The DR configuration is in active working state. The mappings and instances can be modified, and DR plans can be modified and executed.

  • Disabled: The DR configuration is locked. The mappings and instances cannot be modified, and DR plans cannot be created, edited, or executed.

  • Frozen: The DR configuration is locked, like in the disabled state. It is no longer usable because it was migrated to the standby appliance.

Refreshing a DR Configuration

To ensure that the replication information stored in a DR configuration is updated with all the latest changes in your environment, you must refresh the DR configuration after making changes to the protected resources. Refreshing the DR configuration is important for the continuation of service after a DR plan is executed, because it keeps the relevant metadata up-to-date with the current status of the resources under DR protection.

Using the Service CLI

  1. Look up the ID of the DR configuration you want to refresh (drGetConfigs).

  2. Refresh the data stored in the selected DR configuration with the drRefreshConfig command.

    PCA-ADMIN> drRefreshConfig drConfigId=b51a51ac-043e-4b6d-ab29-20f86d905e81
Data:
  Message = Successfully started job to refresh DR config b51a51ac-043e-4b6d-ab29-20f86d905e81
  Job Id = ed3a509e-4ae9-4314-9ec5-fb12ff78615a

  3. Use the job ID to check the status of the operation you started.

    PCA-ADMIN> drGetJob jobId=ed3a509e-4ae9-4314-9ec5-fb12ff78615a
Data:
  Type = refresh_config
  Job Id = ed3a509e-4ae9-4314-9ec5-fb12ff78615a
  Status = finished
  Result = success
  Message = job successfully retrieved
  Response = Successfully refreshed DR config [mydrconf1]
Using the Service Web UI

  1. Under Disaster Recovery Service, open the DR Configurations page.

  2. In the table, click the DR configuration to open its detail page.

  3. In the top-right corner, select Controls, then click Refresh Configuration.

  4. A DR job is started. When it completes successfully, the DR configuration has been refreshed.

    To track progress, under Disaster Recovery Service, select Jobs. The Jobs table reports the status of each job. Click a record in the table to display the job details.

Deleting a DR Configuration

When you no longer need a DR configuration, you can remove it with a single command. However, you must stop all compute instances that are part of the DR configuration before you can delete it. Deleting a DR configuration also removes all site mappings and cleans up the associated storage projects on the local ZFS Storage Appliance.

If required, the storage projects replicated on the standby ZFS Storage Appliance can be cleaned up manually. If the native DR service is disabled/deleted on both systems, all related storage project on both systems are cleaned up automatically as part of the process.

Using the Service CLI

  1. Stop all the compute instances that are part of the DR configuration you want to delete.

  2. Look up the ID of the DR configuration you want to delete (drGetConfigs).

  3. Delete the selected DR configuration with the drDeleteConfig command.

    PCA-ADMIN> delete DrConfig id=d3cd87de-afd4-4718-a3e6-1105b56b42d8
JobId: a687aafa-7c5c-4a68-99da-62e9384140be
Data: Successfully started job to delete config d3cd87de-afd4-4718-a3e6-1105b56b42d8

  4. Use the job ID to check the status of the operation you started.

    PCA-ADMIN> show Job id=a687aafa-7c5c-4a68-99da-62e9384140be
Data:
  Id = a687aafa-7c5c-4a68-99da-62e9384140be
  Type = Job
  Associated Work Request Id = e5f77289-b263-4a5c-9163-7ce4629cc550
  Done = true
  Name = DELETE_TYPE
  Progress Message = Successfully deleted DR config [mydrconf1]
  Run State = Succeeded
  Transcript = Created job DELETE_TYPE
  Username = admin
  WorkItemIds 1 = id:622a4f37-9222-4ea4-af2c-351cf28e739b  type:WorkItem  name:
Using the Service Web UI

  1. Under Disaster Recovery Service, open the DR Configurations page. All configurations are displayed in the table.

  2. In the Actions column, open the quick menu (3 dots) and click Delete.

    Alternatively, click the DR configuration to display its detail page. In the top-right corner, select Controls, then click Delete.

  3. When prompted, click Confirm. A DR job is started. When it completes successfully, the DR configuration is removed from the table.

    To track progress, under Disaster Recovery Service, select Jobs. The Jobs table reports the status of each job. Click a record in the table to display the job details.