Creating an Instance Backup

On Compute Cloud@Customer, you can use the Compute Cloud@Customer Console and API to back up an instance.

The instance can be running or stopped. The boot volume and any block volumes must be attached.

Caution

During the backup process, don't perform any volume attach or detach operations on the instance.

The duration of the backup varies based on the amount of data on the instance boot and block volumes. A small instance that only has a 50 GB boot volume takes only a few minutes to complete. If the instance volumes are as large as 32 TB, the backup can take up to 6 hours to complete.

Prerequisites

  • You must have an Object Storage bucket in the tenancy where the instance is located. See Creating a Bucket.
  • Quiesce instance activities such as running applications so that the backup is created at a known state.
    1. In the Compute Cloud@Customer Console navigation menu, click Compute, then click Instances.

    2. At the top of the page, select the compartment that contains the instance.
    3. Click the name of the instance you plan to back up.

      The instance details page is displayed.

    4. Click Controls (upper right corner) and select Export.

    5. In the dialog box, select these items:

      • If needed, change the compartment to the compartment where the bucket with the backup is located by clicking (Change).

      • Select the bucket.

    6. Click Create Export.

    7. To see the progress, under Resources, click Work Requests.

    8. To see the status of an instance backup, under Resources, click Instance Exports.
  • This task can't be performed using the CLI.

  • The export API creates an instance backup to an Object Storage bucket in the specified compartment.

    API Endpoint

    https://<mgmt_node_VIP>:30003/20160918/instances/<instance_OCID>/actions/export

    where:

    • <mgmt_node_VIP> is the management node VIP host name or IP address.

    • <instance_OCID> is the instance ID.

    Pass these key-value pairs:

    {
    	"bucketName": "<bucket_name>",
    	"destinationType": "objectStorageTuple",
    	"namespaceName": "<namespace_name>",
    	"compartmentId": "<bucket_compartment_OCID>"
    }

    For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.