Oracle Cloud Infrastructure Documentation

Importing Backups

Create an OCI Cache cluster from snapshots stored in Object Storage. Use this feature to restore from backups, clone environments, or support disaster recovery.

When importing backups, consider the following:
  • Non-Sharded cluster import: Select or import a single backup file from Object Storage.
  • Sharded cluster import: Select a number of backup files that matches the number of shards in the new cluster.
  • Memory size requirement: Ensure the node memory size is greater than the size of each backup file. For example, you cannot import a 4 GB backup file into a node with 2 GB of memory.
  • Cluster mode compatibility: You cannot import non-sharded backup files into sharded clusters, or sharded backup files into non-sharded clusters.
  • Version compatibility for import: Import workflows support forward version compatibility. You can import RDB files generated by an older Redis or Valkey version into a newer Redis or Valkey version in OCI Cache, as long as the RDB format is compatible. Reverse compatibility isn't supported. You can't import RDB files generated by a newer Redis or Valkey version into an older version in OCI Cache.

Import workflows use complete RDB snapshot objects. Non-sharded imports use one RDB object, and sharded imports use one object per shard.

  • To import a backup using the Console:

    1. On the Clusters list page, select Create cluster. If you need help finding the list page, see Listing OCI Cache Clusters.
    2. For Creation type, select Create OCI Cache cluster from backup.
    3. Select Import snapshot from object storage.
    4. From the dropdown lists, select the source Bucket compartment and the bucket.
    5. Browse and select the snapshot files (dump.rdb) to import. For sharded clusters, select the required set of files.
    6. Select Next to continue to the Configure cluster settings, nodes, networking page.
      Based on the selected files, OCI Cache automatically detects and suggests a Cluster Mode (for example, standalone, replicated, or sharded).

  • This task can't be performed using the CLI.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • This task can't be performed using the API.