Volumes Test

From CAC Documentation wiki
Revision as of 19:07, 28 February 2021 by Rcw258 (talk | contribs) (→‎Extend an Existing Volume: link)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

A Volume is a collection of data but typically has the functionality of a formatted hard drive and can host a file system. It can be the root partition (the partition containing the operating system) of a virtual machine (VM) that can be booted, or could act like an extra disk that can be mounted by a VM. Volumes are charged for according to their size and for how long they are stored.

Create and Attach a Volume

Volume creation is useful for attaching a data volume or a volume with users' home directories to an instance, as it is often good to separate the concerns of an operating system and user data. This makes it relatively easy to switch operating systems and maintain the same data, and to archive the more important parts of the project (the data) if needed.


  1. Go to the "Volumes" tab in the OpenStack Web Interface
  2. Click the "Create Volume" button
  3. Enter a name and size
  4. Click "Create Volume"


  1. Go to the "Volumes" tab in the OpenStack Web Interface
  2. On the Actions dropdown menu for the volume you want to attach, select "Manage Attachments"
  3. Select the instance you wish to attach to and click "Attach Volume"
    • Note that the device name specified is usually not important and not always adhered to

Once You Have Attached The Volume


Snapshots of volumes (and of instances, in which case the volume is implicitly the root volume of the instance) create a state save of the existing volume, so you can easily get back to a certain state in the future. This is most useful for OS volumes to create safe checkpoints of working operating system configuration states. It may be less useful for larger data volumes; a more efficient solution might be to use ZFS snapshots on Linux instances.

Snapshots can be created from the Actions dropdown menu. Note that if you are creating a snapshot of a root volume for an instance, it should not be running. You should first stop the instance, and then take the snapshot.

Snapshots of volumes can be shared with users on a different project (or even with yourself, if you are a member of multiple projects). Simply follow the procedure for sharing found on the OpenStack forum. If the snapshot is of an instance, it may be easier to perform the necessary steps from the command line, as found on CAC's Images page.

Add Storage Capacity

You can add more storage capacity to your instance by:

Extend an Existing Volume

You can increase the size of an existing volume (but not making it smaller) when the volume is in the detached state.

In the special case of extending root volumes, follow the instructions on this page.

  1. Detach the volume if it is attached to an instance.
    • From inside the instance, unmount the file system to make sure all cached changes are flushed back to disk: umount /mount_point, where /mount_point is the absolute path on which the file system is mounted.
    • Under Project->Volumes->Volumes on the Red Cloud web console, select the volume you want to detach.
    • (Optional but recommended)Click on the "Edit Volume" button in the upper right corner to rename the volume so it is easier to be identified in the subsequent steps.
    • Under the pull down menu in the upper right corner, select "Manage Attachments."
      Screen Shot 2020-11-17 at 9.29.02 AM.png
    • Click on the "Detach Volume" button on the next screen and confirm.
  2. When the volume is in the detached state and back on the Volumes screen, select the volume again. Under the pull down menu in the upper right corner, select "Extend Volume."
    Select Extend Volume.png
  3. On the next screen specify the new size for the volume and click on the "Extend Volume" button.
  4. Re-attach the volume to your instance.
  5. From inside the instance, extend the file system on the extended volume:
    • If the file system is ext3 or ext4,
      • Run the resize2fs device_name command, where device_name is the device name of the newly extended volume, e.g. /dev/vdb.
      • Re-mount the file system.
    • If the file system is xfs,
      • First re-mount the file system.
      • Run the xfs_growfs /mount_point command, where /mount_point is the absolute path name on which the file system is mounted.
  6. Use the df -h command to verify the new size of the file system.