Configure the Oracle Database Cloud Backup Module for OCI

Configure an RMAN channel to integrate your on-premise database with Oracle Cloud Infrastructure Object Storage.

To configure an RMAN channel that corresponds to the Oracle Database Cloud Backup Module for OCI:

Start RMAN on your on-premise database and connect to the target database.

The following example connects to your target database by using operating system authentication:
```
% rman target /
```
The following example connects to your target database, with DBID prod, by using password file authentication. Enter the password for the bkup_admin user (with the SYSBACKUP privileges) when prompted.
```
% rman target "bkup_admin@prod as sysbackup"
```
Use the RMAN CONFIGURE command to configure a channel that corresponds to the Oracle Database Cloud Backup Module for OCI.

The RMAN channel configuration must use the path to the backup module’s library and configuration files created when you installed the Oracle Database Cloud Backup Module for OCI. Once channel configuration is complete, you are ready to use RMAN commands to work with Oracle Cloud Infrastructure Object Storage.

Example 1 Configuring RMAN to Back Up to Oracle Cloud Infrastructure

On Linux and UNIX systems, the following command configures an RMAN channel that uses the Oracle Database Cloud Backup Module for OCI SBT library for backup and restore operations to Oracle Cloud Infrastructure:

RMAN> CONFIGURE CHANNEL DEVICE TYPE sbt
      PARMS='SBT_LIBRARY=location-of-the-SBT-library-OCI-Backup-Module-for-OCI,
      SBT_PARMS=(OPC_PFILE=location-of-the-configuration file)';

For example:

RMAN> CONFIGURE CHANNEL DEVICE TYPE sbt
      PARMS='SBT_LIBRARY=/orclhome/lib/libopc.so,
      SBT_PARMS=(OPC_PFILE=/orclhome/dbs/opcora12.ora)';

On Windows systems, you’ll need to specify the ENV parameter. For example:

RMAN> CONFIGURE CHANNEL DEVICE TYPE sbt
      PARMS='SBT_LIBRARY=C:\tmp\oraopc.dll,
      ENV=(OPC_PFILE=C:\tmp\opcora12.ora)';

Note: If you have existing backups on Oracle Cloud Infrastructure, ensure that the backup piece names are not the same as the ones in Oracle Cloud Infrastructure Object Storage Classic. This is to avoid the risk of overwriting objects in the target bucket. It is recommended that you use the format ‘%d_%U’ when creating the backups to avoid such conflicts.