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
-
Click on
Create Volume
in the upper right corner of theVolumes
screen. -
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.
-
Click on the pull down menu next to the volume to be deleted and select
Delete Volume
.
Attach a Volume to an Instance
-
Click on the pull down menu next to the volume to be attached and select
Manage Attachment
. -
Select the instance you want to attach to and click on
Attach Volume
. -
Follow either the Linux steps or the Windows steps to complete the attachment.
Detach a Volume from an Instance
-
Unmount the file system to ensure all cached changes are flushed back to the disk.
- For Linux instances, do
umount /mount_point
, where/mount_point
is the absolute path the file system is mounted on. Usedf
ormount -l
to discover the mount point for your attached volumes. - For Windows instances, start the Disk Management Tool, right click on the drive that is to be detached, and select "Offline".
- For Linux instances, do
-
Click on the pull down menu next to the volume to be detached and select
Manage Attachment
. -
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.
-
Follow the steps to detach the volume from the instance.
-
Click on the pull down menu next to the volume to be extended and select
Extend Volumes
. -
Choose a new size for the volume. Note that the new size cannot be smaller than the original size.
-
From inside the instance, extend the file system on the extended volume:
- In Linux, if the file system is
ext3
orext4
, Runresize2fs device_name
, where device_name is the device name of the newly extended volume, e.g./dev/vdb
. Then, re-mount the file system. - 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.
- In Windows, if the file system is NTFS or ReFS, Use the Disk Management tool, as described in Microsoft's documentation.
- In Linux, if the file system is
- From inside the instance, confirm the new, larger size of the file system:
- In Linux, use the df -h command.
- In Windows, assuming the disk was assigned a drive letter (such as D:), check the Properties of that drive in File Explorer.
List Snapshots
-
Snapshots in Red Cloud are managed under the
Projects
andVolume
tabs. Clicking into Snapshots will list you all the snapshots available to this project.
Take a Volume Snapshot
-
Click on the pull down menu next to the volume to be snapshotted and select
Create Snapshot
. -
Name the snapshot and enter a helpful description, and click on
Create Volume Snapshot
.
Delete a Snapshot
-
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)
-
Click on the pull down menu next to the volume to be transferred and select
Create Transfer
. -
Enter a descriptive name for the transfer, and click
Create Volume Transfer
. -
Save
Transfer ID
andAuthorization Key
, either by manually copying them to a secure location or click onDownload transfer credientials
. These information will not be available after closing the tab. -
Your volume will be in the
Awaiting Transfer
state:
Accept a Transfer Request (From the Destination Project)
-
Click on
Accept Transfer
. -
Enter
Transfer ID
andAuthorization Key
from the previous steps. Click onAccept Volume Transfer
to finalize the volume transfer. The volume should now be removed from the source project and appear in the destination project.