Create and manage cloud volumes

Volumes are virtual block storage devices that provide persistent storage for your instances. 

In this article we’ve provided you with step-by-step guides on how to create and manage volumes using the xneelo Cloud dashboard.

If you want to learn more about instances, key concepts and terminology, see the Volumes in xneelo Cloud help article.


  • Volumes page

    The Volumes page provides a list of your volumes, as well as information, tools and actions you can perform on these volumes.

    Steps

    1. 1
      Using the menu on the left, navigate to Storage > Volumes.
    2. 2
      A list of Helpful Articles is displayed at the top of the page.
    3. 3
      The Create Volume button allows you to create new volumes.
    4. 4
      The Delete Volume button allows you to delete existing volumes.
    5. 5
      The Volumes table shows a list of your current volumes and associated information in each column.
    • Name: Name of the volume.
    • Description: What this volume is used for.
    • Size: Provisioned size (in GiB).
    • Status: The volume is either Available (not-attached to an instance) or In-Use (attached to an instance).
    • Type: The storage tier, either premium or standard.
    • Attached To: Instance the volume is attached to.
    • Bootable: Whether the volume can be used to launch an instance.
    1. 6
      The Actions column provides a list of actions you can perform on each volume:
    • Edit Volume: Update information and configuration fields.
    • Extend Volume: Increase the size of the volume.
    • Launch As Instance: Create a new instance from a bootable volume.
    • Manage Attachments: Attach and detach a volume to an instance.
    • Create Snapshot: Create a snapshot of a volume.
    • Upload To Image: Create a private image from a volume.
    • Delete Volume: Permanently remove a volume and all data stored on it.

      Read through the sections below for step-by-step guides on each action.





    • Create a volume

      This will create a volume that can be attached to an instance.

      When creating a new volume you can choose to create an empty volume. You can also create a new volume from an existing source.

      Steps

      1. 1
        Using the menu on the left, navigate to Storage > Volumes.
      2. 2
        Click on the + Create Volume button. The Create Volume dialog will appear.
      3. 3
        In the Volume Name field provide a name for the new volume. Names are not unique identifiers; multiple volumes may have the same name.
      4. 4
        In the Description field specify what this volume will be used for.
      5. 5
        Select the Volume Source from the drop-down list.
      6. 6
        If you select No source, empty volume (default) as the source:
      • Select the Volume Type you want to use, either: Standard (default) or Premium
          1. 7
            If you select Snapshot as the source:
          • Select the snapshot you want to use.
          • The volume type will be set to the same as the source snapshot.
          1. 8
            If you select Image as the source:
          • Select the image you want to use.
          • Select the Volume Type you want to use, either: Standard (default) or Premium

          Note: If this a 0 byte image (created by an instance snapshot), there will be a linked volume that contains the data. You must select the same volume type as that volume, or an error will occur.

          1. 9
            If you select Volume as the source:
          • Select the volume you want to use.
          • The volume type will be set to the same as the source volume.
          1. 10
            In the Size (GiB) field, enter the size of the volume you want to create.
          1. 11
            Click on the Create Volume button to confirm the action.
          2. 12
            To view and access the new volume, navigate to Storage > Volumes.





        • View volume overview

          The overview displays information and metadata about your volume. This includes:

          • Volume information, (name, IDs, status)
          • Specs (Size, type, created date)
          • Attached instances
          • Volume source
          • Metadata

          Steps

          1. 1
            Using the menu on the left, navigate to Storage > Volumes.
          2. 2
            Find the volume that you want to view.
          3. 3
            Click on the Volume Name (blue, hyperlinked text).
          4. 4
            The Overview tab will load and display.
          5. 5
            Scroll down to view the different overview sections.





        • Edit a volume

          Steps

          1. 1
            Using the menu on the left, navigate to Storage > Volumes.
          2. 2
            Find the volume that you want to edit.
          3. 3
            In the Actions column, select Edit Volume.
          4. 4
            The Edit Volume dialog will appear.
          5. 5
            In the Volume Name field provide a new name for the volume.
          6. 6
            In the Description field specify what this volume will be used for.
          7. 7
            Update the Bootable selection box. This will toggle whether the volume can be used to launch an instance.
          8. 8
            Click the Submit button to confirm the action.





        • Extend a volume (increase size)


          Extending a volume increases the size of the volume to accommodate additional storage needs without having to create a new larger volume and migrate the data.

          Steps

          1. 1
            Using the menu on the left, navigate to Storage > Volumes.
          2. 2
            Find the volume that you want to edit.
          3. 3
            In the Actions column, select the down ▼ button. A drop-down menu will appear.
          4. 4
            Select the Extend Volume option. The Extend Volume dialog will appear.
          5. 5
            In the New Size (GiB) field, enter the new volume size.
          • The new value size must be larger than the current size.
          • This must be within the volume size limits.
          1. 6
            Click the Extend Volume button to confirm the action.

          After extending a volume you will need to ensure that the operating system is able to detect and use the additional storage space. Follow the steps on how to resize a volume partition.





        • Decrease volume size

          An existing volume cannot be directly decreased in size once created. Volumes are block storage devices; once created, the disk size is allocated and set on the platform.

          There are other ways to decrease volume size. A new smaller volume can be created, and the data can be migrated from the old to new volume. Follow the steps below.

          Steps

          1. 1
            Using the menu on the left, navigate to Storage > Volumes.
          2. 2
            Click on the + Create Volume button.
          3. 3
            Follow the steps to create a new volume, at the decreased size.
          4. 4
            You can then migrate the data from the original volume to the new volume, using your own tools or procedures. 
          5. 5
            Delete the original volume.





        • Attach a volume


          You can attach a volume to a running instance to provide persistent storage. 

          Up to 26 volumes can be attached to an instance. A volume can only be attached to a single instance at one time.

          Steps

          1. 1
            Using the menu on the left, navigate to Storage > Volumes.
          2. 2
            Find the volume that you want to attach.
          3. 3
            In the Actions column, select the down ▼ button. A drop-down menu will appear.
          4. 4
            Select the Manage Attachments option. The Manage Volume Attachments dialog will appear.
          5. 5
            In the Attach To Instance field, Select An Instance from your available instances.
          6. 6
            Click the Attach Volume button to confirm the action.
          7. 7
            On the Volumes page the volume will be updated.
          • The Attached To column will display the attached instance.
          • That Status column will display ‘In-use’.

          The newly attached volume will not be immediately available for use as a file system. The volume must first be formatted, partitioned and mounted. Follow the steps on how to mount a new volume to an instance.





        • Detach a volume

          You can detach a volume from one instance and reattach it to another instance, without losing the data stored on the volume.

          Note: When detaching a volume, ensure that there are no running applications actively using the volume as it can result in data loss or corruption.

          Steps

          1. 1
            Using the menu on the left, navigate to Storage > Volumes.
          2. 2
            Find the volume that you want to detach.
          3. 3
            In the Actions column, select the down ▼ button. A drop down menu will appear.
          4. 4
            Select the Manage Attachments option. The Manage Volume Attachments dialog will appear.
          5. 5
            Select the instance to detach from the list of attached instances.
          6. 6
            Click the Detach Volume button.
          7. 7
            A Confirm Detach Volume dialog will appear.
          8. 8
            Click the Detach Volume button to confirm the action.
          9. 9
            On the Volumes page the volume will be updated.
          • The Attached To column will be empty.
          • That Status column will display ‘Available’.

              The detached volume can now be attached to any other instance.





            • Create a snapshot of a volume

              This will create a volume snapshot, as a point-in-time copy of a volume. 

              You can use snapshots to roll a volume back to the state it was in at the time the snapshot was created. However, because snapshots are a point-in-time copy of the data you cannot mount them directly as a volume, but instead use the snapshot to provision a new volume.

              This is only recommended on unattached volumes. Creating a snapshot of an attached volume is a risky action; in some cases, this can result in a corrupted snapshot, if the volume changes during the upload process.

              Steps

              1. 1
                Using the menu on the left, navigate to Storage > Volumes.
              2. 2
                Find the volume that you want to take a snapshot of.
              3. 3
                In the Actions column, select the down ▼ button. A drop down menu will appear.
              4. 4
                Select the Create Snapshot option. The Create Volume Snapshot dialog will appear. If this is an attached volume, a warning message will be displayed.
              5. 5
                In the Snapshot Name field provide a name for the snapshot.
              6. 6
                In the Description field specify what this snapshot will be used for.
              7. 7
                Click on the Create Volume Snapshot button to confirm the action. If this is an attached volume the button text will display ‘Create Volume Snapshot (Force)’.
              8. 8
                Using the menu on the left, navigate to Storage > Snapshots.
              9. 9
                The new volume snapshot will be listed.





            • View volume snapshots

              This allows you to view the snapshots associated with a volume, and perform actions on those snapshots.

              Steps

              1. 1
                Using the menu on the left, navigate to Storage > Volumes.
              2. 2
                Find the volume that you want to view.
              3. 3
                Click on the Volume Name (blue, hyperlinked text).
              4. 4
                The Overview tab will load and display.
              5. 5
                Click on the Snapshots tab.
              6. 6
                The snapshots associated with the volume will be displayed.

              You can then perform actions on these snapshots.





            • Change volume type

              Volume types are the different storage tiers available, which offer varying levels of performance and price. See more about the volume types available.

              This allows you to change the selected type of an existing volume. Your volume will then be charged at the rate of the new type, see more on the pricing.

              When the volume type is changed the data will be migrated from one storage cluster to another. Depending on the size of the volume, this process can take several minutes to complete, or even hours for very large volumes.

              If the volume has snapshots associated with it, you cannot change the type. You will first need to delete the snapshots, and then retry the volume type change.

              Steps

              1. 1
                Using the menu on the left, navigate to Storage > Volumes.
              2. 2
                Find the volume that you want to edit.
              3. 3
                In the Actions column, select the down ▼ button. A drop-down menu will appear.
              4. 4
                Select the Change Volume Type option. The Change Volume Type dialog will appear.
              5. 5
                In the Type field select the type you want to change to.
              6. 6
                Click the Change Volume Type button to confirm the action.
              7. 7
                The Volume Type change will then be initiated. The time to complete will vary, depending on the size of the volume.





            • Upload a volume to an image

              This will create a new machine image from an existing volume.

              This is only recommended on unattached volumes. Creating an image from an attached volume is a risky action; in some cases, this can result in a corrupted image if the volume changes during the upload process.

              Steps

              1. 1
                Using the menu on the left, navigate to Storage > Volumes.
              2. 2
                Find the volume that you want to edit.
              3. 3
                In the Actions column, select the down ▼ button. A drop down menu will appear.
              4. 4
                Select the Upload to Image option. The Upload Volume to Image dialog will appear.
              5. 5
                In the Image Name field provide a name for the new volume.
              6. 6
                The Force checkbox will appear if the volume status is in ‘in-use’. Select the Force box to proceed.
              7. 7
                Click the Upload button to confirm the action.





            • Delete a volume

              When deleting a volume all data stored on the volume will be permanently lost. The deleted volume cannot be recovered, as it is removed entirely from the platform.

              You will not be able to delete a volume that has an associated snapshot.

              Only available (unattached) volumes can be deleted.

              Steps

              1. 1
                Using the menu on the left, navigate to Storage > Volumes.
              2. 2
                Find the volume that you want to delete.
              3. 3
                In the Actions column, select the down ▼ button. A drop-down menu will appear.
              4. 4
                Select the Delete Volume option. The Confirm Delete Volume dialog will appear.
              5. 5
                Click the Delete Volume button to confirm the action.