create-standby-database

Description

Creates a new standby database for the given source database id.

Usage

oci db database create-standby-database [OPTIONS]

Required Parameters

--database-admin-password [text]

The administrator password of the primary database in this Data Guard association.

  • The password MUST be the same as the primary admin password.

--source-database-id [text]

The OCID of the source (primary) database for the Data Guard group.

Optional Parameters

--db-unique-name [text]

Specifies the DB_UNIQUE_NAME of the standby database to be created.

--is-active-data-guard-enabled [boolean]

True if active Data Guard is enabled.

--protection-mode [text]

The protection mode to set up between the primary and standby databases. For more information, see Oracle Data Guard Protection Modes in the Oracle Data Guard documentation.

IMPORTANT - The protection mode is required for first standby to be created.

Accepted values are:

MAXIMUM_AVAILABILITY, MAXIMUM_PERFORMANCE
--sid-prefix [text]

Specifies a prefix for the Oracle SID of the standby database to be created.

--source-tde-wallet-password [text]

The existing TDE wallet password of the source (primary) database.

--transport-type [text]

The redo transport type to use for the standby database to be created. Valid values depend on the specified protectionMode:

  • MAXIMUM_AVAILABILITY - SYNC * MAXIMUM_PERFORMANCE - ASYNC

For more information, see Redo Transport Services in the Oracle Data Guard documentation.

Accepted values are:

ASYNC, SYNC

Example using required parameter

Copy the following CLI commands into a file named example.sh. Run the command by typing “bash example.sh” and replacing the example parameters with your own.

Please note this sample will only work in the POSIX-compliant bash-like shell. You need to set up the OCI configuration and appropriate security policies before trying the examples.

    export database_admin_password=<substitute-value-of-database_admin_password> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/db/database/create-standby-database.html#cmdoption-database-admin-password
    export source_database_id=<substitute-value-of-source_database_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/db/database/create-standby-database.html#cmdoption-source-database-id

    oci db database create-standby-database --database-admin-password $database_admin_password --source-database-id $source_database_id