Oracle Cloud Infrastructure Documentation

Resizing a Volume

The Oracle Cloud Infrastructure Block Volume service lets you expand the size of block volumes and boot volumes. You have several options to increase the size of your volumes:

For more information about the Block Volume service, see the Block Volume FAQ.

You can only increase the size of the volume. You cannot decrease the size.

Note

If cross-region replication is enabled for the volume you want to resize, before you resize the volume, you must disable cross-region replication. Once the volume is resized, you can renable cross-region replication for the volume. For more information about this feature, see Replicating a Volume.
Note

Resizing IDE type boot volumes is not supported. This applies to both offline and online resizing. To workaround this limitation, you can do one of the following:

  • Terminate the VM instance, ensuring that you keep the boot volume when you terminate the instance. Resize the boot volume that you have kept, and then launch a new VM instance, using the resized boot volume as the image source.

  • Create a clone of the boot volume, resize the boot volume clone, and then launch a new VM instance using the resized boot volume clone as the image source.

Caution

Before you resize a boot or block volume, you should create a backup of the volume.
Note

After a volume has been resized, the first backup on the resized volume will be a full backup. See Volume Backup Types for more information about full versus incremental volume backups.

Required IAM Policy

To use Oracle Cloud Infrastructure, an administrator must be a member of a group granted security access in a policy  by a tenancy administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don't have permission or are unauthorized, verify with the tenancy administrator what type of access you have and which compartment  your access works in.

For administrators: The policy in Let users launch compute instances includes the ability to attach/detach existing block volumes. The policy in Let volume admins manage block volumes, backups, and volume groups lets the specified group do everything with block volumes and backups, but not launch instances.

If you're new to policies, see Managing Identity Domains and Common Policies. For reference material about writing policies for instances, cloud networks, or other Core Services API resources, see Details for the Core Services.

Online Resizing a Block or Boot Volume

With online resizing, you can expand the volume size without detaching the volume from an instance.

    1. Open the navigation menu  and select Storage. Under Block Storage, select Block Volumes or Boot Volumes.
    2. Select the volume you want to resize.
    3. Select Edit.
    4. Specify the new volume size in Volume size (in GB).
      Note

      You must specify a larger value than the block volume's current size.
    5. Select Save changes.
    6. (Optional) If you resized a volume attached to a Linux-based instance, a dialog opens that lists the commands you need to run after the volume is provisioned. Run these commands to ensure that the operating system correctly identifies the increased volume size.
      1. Select Copy to copy the commands.
      2. Select Close to close the dialogue.
    7. See Next Steps for information on rescanning the disk and extending the partition.
  • Block Volumes

    Use the oci bv volume update command and specify the --volume-id and --size-in-gbs parameters to resize a block volume:

    oci bv volume update --volume-id <volume_OCID> --size-in-gbs <new_size>... [OPTIONS]
    Boot Volumes

    Use the oci bv boot-volume updatecommand and specify the --volume-id and --size-in-gbs parameters to resize a block volume:

    oci bv boot-volume update --volume-id <volume_OCID> --size-in-gbs <new_size>... [OPTIONS]

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

  • Block Volumes

    Run the UpdateVolume operation and specify the volumeId attribute in the request body and the sizeInGBs attribute in the UpdateVolumeDetails resource to resize a block volume.

    Boot Volumes

    Run the UpdateBootVolume operation and specify the volumeId attribute in the request body and the sizeInGBs attribute in the UpdateBootVolumeDetails resource to resize a boot volume.

Offline Resizing a Block or Boot Volume

You can use offline resizing to detach the volume from an instance before you expand the volume size. Once the volume is resized and reattached, you must extend the partition, but you do not need to rescan the disk.

Considerations When Resizing an Offline Volume

Whenever you detach and reattach volumes, there are complexities and risks for both Linux-based and Windows-based instances. This applies to both paravirtualized and iSCSI attachment types. You should keep the following in mind when resizing volumes:

  • When you reattach a volume to an instance after resizing, if you are not using consistent device paths, or the instance does not support consistent device paths, device order and path may change. If you are using a tool such as Logical Volume Manager (LVM), you may need to fix the device mappings. For more information about consistent device paths, see Connecting to Volumes With Consistent Device Paths.

  • When you detach and then reattach an iSCSI-attached volume to an instance, the volume's IP address will increment.

  • Before you resize a volume, you should create a full backup of the volume.

    1. Detach the volume.
    2. Open the navigation menu  and select Storage. Under Block Storage, select Block Volumes or Boot Volumes.
    3. Select the volume you want to resize.
    4. Select Edit.
    5. Specify the new volume size in Volume size (in GB).
      Note

      You must specify a larger value than the block volume's current size.
    6. Select Save changes.
    7. (Optional) If you resized a volume attached to a Linux-based instance, a dialog opens that lists the commands you need to run after the volume is provisioned. Run these commands to ensure that the operating system correctly identifies the increased volume size.
      1. Select Copy to copy the commands.
      2. Select Close to close the dialogue.
    8. See Next Steps for information on rescanning the disk and extending the partition.
  • Block Volumes
    1. Detach the volume.

    2. Use the oci bv volume update command and specify the --volume-id and --size-in-gbs parameters to resize a block volume:

      oci bv volume update --volume-id <volume_OCID> --size-in-gbs <new_size>... [OPTIONS]
    Boot Volumes
    1. Detach the volume.

    2. Use the oci bv boot-volume updatecommand and specify the --volume-id and --size-in-gbs parameters to resize a block volume:

      oci bv boot-volume update --volume-id <volume_OCID> --size-in-gbs <new_size>... [OPTIONS]

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

  • Block Volumes

    1. Run the DetachVolume operation and specify the volumeAttachmentId attribute to detach a block volume from an instance.

    2. Run the UpdateVolume operation and specify the volumeId attribute in the request body and the sizeInGBs attribute in the UpdateVolumeDetails resource to resize the block volume.

    Boot Volumes

    1. Run the DetachVolume operation and specify the volumeAttachmentId attribute to detach a block volume from an instance.

    2. Run the UpdateBootVolume operation and specify the volumeId attribute in the request body and the sizeInGBs attribute in the UpdateBootVolumeDetails resource to resize the boot volume.