Horizon Web Console: Volumes

Note

Red Cloud 2 is currently in beta testing and not available to all users. If you are not a Red Cloud 2 beta tester, use the production Red Cloud instead. This Red Cloud 2 documentation is still under development.

Beta testers: Report all problems to CAC Help. Please specify Red Cloud 2 when reporting problems. Thank you!

Volumes in Red Cloud are managed under the Projects and Volume tabs. This screen lists all volumes accessible by this project.

Create a Volume

  1. Click on Create Volume in the upper right corner of the Volumes screen.

  2. In the Create Volume window,

    • Volume Name: Name the volume.
    • Description: Enter a helpful description for the volume.
    • Volume Source: Select No source, empty volume for an empty volume.
      • Use image as a source: Select an image to use as the source if you plan to use the volume as the root volume.
    • Type: Select rbd.
    • Size (GiB): Choose a size for your volume. You can always extend the size later. But keep in mind that you cannot shrink the size of a volume.
    • Availability Zone: Select redcloud2.
    • Group: Select No Group.

    Click on the Create Volume button to finalize.

Delete a Volume

Note

The volume must be detached and has no snapshots before it can be deleted.

  1. Click on the pull down menu next to the volume to be deleted and select Delete Volume.

Attach a Volume to an Instance

  1. Click on the pull down menu next to the volume to be attached and select Manage Attachment.

  2. Select the instance you want to attach to and click on Attach Volume.

  3. Follow either the Linux steps or the Windows steps to complete the attachment.

Detach a Volume from an Instance

  1. Unmount the file system to ensure all cached changes are flushed back to the disk.

    1. For Linux instances, do umount /mount_point, where /mount_point is the absolute path the file system is mounted on. Use df or mount -l to discover the mount point for your attached volumes.
    2. For Windows instances, start the Disk Management Tool, right click on the drive that is to be detached, and select "Offline".
  2. Click on the pull down menu next to the volume to be detached and select Manage Attachment.

  3. Click on Detach Volume to detach it from the instance.

Extend a Volume

Note

Only non-root volumes can be extended. For root volumes, see Red Cloud Resizing Volumes.

  1. Follow the steps to detach the volume from the instance.

  2. Click on the pull down menu next to the volume to be extended and select Extend Volumes.

  3. Choose a new size for the volume. Note that the new size cannot be smaller than the original size.

  4. From inside the instance, extend the file system on the extended volume:

    1. In Linux, if the file system is ext3 or ext4, Run resize2fs device_name, where device_name is the device name of the newly extended volume, e.g. /dev/vdb. Then, re-mount the file system.
    2. In Linux, 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.
    3. In Windows, if the file system is NTFS or ReFS, Use the Disk Management tool, as described in Microsoft's documentation.
  5. From inside the instance, confirm the new, larger size of the file system:
    1. In Linux, use the df -h command.
    2. In Windows, assuming the disk was assigned a drive letter (such as D:), check the Properties of that drive in File Explorer.

List Snapshots

  1. Snapshots in Red Cloud are managed under the Projects and Volume tabs. Clicking into Snapshots will list you all the snapshots available to this project.

Take a Volume Snapshot

  1. Click on the pull down menu next to the volume to be snapshotted and select Create Snapshot.

  2. Name the snapshot and enter a helpful description, and click on Create Volume Snapshot.

Delete a Snapshot

  1. Click on the pull down menu next to the snapshot to be deleted and select Delete Volume Snapshot.

Transfer a Volume to a Different Project

Create a Transfer Request (From the Source Project)

  1. Click on the pull down menu next to the volume to be transferred and select Create Transfer.

  2. Enter a descriptive name for the transfer, and click Create Volume Transfer.

  3. Save Transfer ID and Authorization Key, either by manually copying them to a secure location or click on Download transfer credientials. These information will not be available after closing the tab.

  4. Your volume will be in the Awaiting Transfer state:

Accept a Transfer Request (From the Destination Project)

  1. Click on Accept Transfer.

  2. Enter Transfer ID and Authorization Key from the previous steps. Click on Accept Volume Transfer to finalize the volume transfer. The volume should now be removed from the source project and appear in the destination project.