10.3 Converting a Tape Configuration to Cloud

Use these steps to configure the cloud resources, run the conversion, and verify that an existing tape configuration has been successfully converted to cloud.

  1. Create a cloud key.
    racli add cloud_key --key_name=<KEY_NAME>
    .
  2. Register the key fingerprint.
    racli alter cloud_key --key_name=<KEY_NAME> --fingerprint=<FINGERPRINT>
  3. Create a cloud user.
    racli add cloud_user --user_name=CLOUD_USER_NAME --key_name=CLOUD_KEY_NAME 
    --user_ocid=UOCID --tenancy_ocid=TOCID [--compartment_ocid=COCID]
  4. Run this command to create a new cloud storage location, such as an OCI Object Storage bucket.
    racli add cloud_location --cloud_user=CLOUD_USER_NAME 
    --host=HOST_URL --bucket=OCI_BUCKET_NAME
  5. Run the racli list cloud_location command to list the cloud location in Recovery Appliance. In this sample output, the cloud location name is OCI_LOC1.
    
    [root@ra01 ~]# racli list cloud_location --all
      Wed May  6 21:05:00 2026: Using log file /opt/oracle.RecoveryAppliance/log/racli.log
      Wed May  6 21:05:00 2026: Start: List Cloud Location
      Cloud Location OCI_LOC1
              Location Name: OCI_LOC1
                 Immutable: FALSE
                   Archive: NO
       Archive After Backup: YES
                    Bucket: my_bucket
                Guaranteed: YES
                      Host: [nnnnnn01.oracle.com]
               Location ID: 123
                  Streams: 8
                   User ID: OCI_USER
               SBT Library: OCI_LOC1
       Attribute Set Name: Default
             Backup Stream: 8
    
      Wed May  6 21:05:01 2026: End: List Cloud Location
    Run the racli convert tape to cloud command. Specify the source SBT library and the cloud location name.
    racli convert tape_to_cloud --tape_library=SBT_LIBRARY 
    --cloud_location=CLOUD_LOCATION
    In this example, ROBOT0 is an existing source SBT library and OCI_LOC1 is the cloud location.
    racli convert tape_to_cloud --tape_library=ROBOT0 --cloud_location=OCI_LOC1
  6. With SQL*Plus or SQL Developer, connect to the Recovery Appliance as a named user with RASYS privileges.
    $ sqlplus rasys/<password>
  7. Query the view RA_SBT_JOB to list the defined SBT templates.
    SELECT TEMPLATE_NAME FROM RA_SBT_JOB;
  8. Run the archive-to-cloud job to verify the copy to cloud operation.
    SQL> exec dbms_ra.queue_sbt_backup_task('<COPY_TO_CLOUD_TEMPLATE_NAME>');
    
    PL/SQL procedure successfully completed.
  9. Verify that cloud-based templates have been created and that backup jobs reference the new cloud templates.

    Note:

    If an existing tape template name contains the word TAPE, it is replaced with CLOUD in the converted template name. For example, the template TAPE_TPL_01 is converted and renamed to CLOUD_TPL_01. The original TAPE_TPL_01 template remains unchanged.

Note:

For detailed information about the RACLI commands, see the Recovery Appliance Command Line Interface Reference.