diff --git a/content/cloud/volumes/images/Screenshot_20220317_113921.png b/content/cloud/volumes/images/Screenshot_20220317_113921.png new file mode 100644 index 0000000000000000000000000000000000000000..86a497ee8d19e0972db50c2de9eabd869e2aecc9 Binary files /dev/null and b/content/cloud/volumes/images/Screenshot_20220317_113921.png differ diff --git a/content/cloud/volumes/images/attachment1.png b/content/cloud/volumes/images/attachment1.png new file mode 100644 index 0000000000000000000000000000000000000000..30b34be78331612125d61ddfb4a2bef10086a355 Binary files /dev/null and b/content/cloud/volumes/images/attachment1.png differ diff --git a/content/cloud/volumes/images/attachment2.png b/content/cloud/volumes/images/attachment2.png new file mode 100644 index 0000000000000000000000000000000000000000..abbd7f01777f2e71c69a1a2258c337d552bd59c8 Binary files /dev/null and b/content/cloud/volumes/images/attachment2.png differ diff --git a/content/cloud/volumes/images/backup1.png b/content/cloud/volumes/images/backup1.png new file mode 100644 index 0000000000000000000000000000000000000000..024b4e647c343e03d809d1f305d6e6fff6e0182d Binary files /dev/null and b/content/cloud/volumes/images/backup1.png differ diff --git a/content/cloud/volumes/images/backup2.png b/content/cloud/volumes/images/backup2.png new file mode 100644 index 0000000000000000000000000000000000000000..21ca603224d6182251627a0223dc1bdec2b43fbe Binary files /dev/null and b/content/cloud/volumes/images/backup2.png differ diff --git a/content/cloud/volumes/images/backup3.png b/content/cloud/volumes/images/backup3.png new file mode 100644 index 0000000000000000000000000000000000000000..86a497ee8d19e0972db50c2de9eabd869e2aecc9 Binary files /dev/null and b/content/cloud/volumes/images/backup3.png differ diff --git a/content/cloud/volumes/images/extend1.png b/content/cloud/volumes/images/extend1.png new file mode 100644 index 0000000000000000000000000000000000000000..a2d156179de3bbc1f7cffde2b81eb95b9655d672 Binary files /dev/null and b/content/cloud/volumes/images/extend1.png differ diff --git a/content/cloud/volumes/images/extend2.png b/content/cloud/volumes/images/extend2.png new file mode 100644 index 0000000000000000000000000000000000000000..ce847e9cf4d42daa17ca42208d15d32c4bf164f1 Binary files /dev/null and b/content/cloud/volumes/images/extend2.png differ diff --git a/content/cloud/volumes/images/instance-shutoff.png b/content/cloud/volumes/images/instance-shutoff.png new file mode 100644 index 0000000000000000000000000000000000000000..4e77df6631c6e2208e3f94484b9ec9e950f5d941 Binary files /dev/null and b/content/cloud/volumes/images/instance-shutoff.png differ diff --git a/content/cloud/volumes/images/launch1.png b/content/cloud/volumes/images/launch1.png new file mode 100644 index 0000000000000000000000000000000000000000..633169233b16a69a65e7fa0241f2b09a2724bc89 Binary files /dev/null and b/content/cloud/volumes/images/launch1.png differ diff --git a/content/cloud/volumes/images/volume1.png b/content/cloud/volumes/images/volume1.png new file mode 100644 index 0000000000000000000000000000000000000000..473d716184cfcb44f48c06a9deb956ac16589b71 Binary files /dev/null and b/content/cloud/volumes/images/volume1.png differ diff --git a/content/cloud/volumes/index.md b/content/cloud/volumes/index.md new file mode 100644 index 0000000000000000000000000000000000000000..ee09769591299d44fb91e03325586c98568b6a6a --- /dev/null +++ b/content/cloud/volumes/index.md @@ -0,0 +1,120 @@ +--- +title: "Manage Volumes" +date: 2022-03-17T14:37:00+02:00 +draft: false +weight: 100 +disableToc: false +--- + +When storing a large amount of data in a virtual machine instance, it is advisable to use a separate volume and not the +root file system containing the operating system. It adds flexibility and often prevents data loss. Volumes can be +attached and detached from instances at any time, their creation and deletion are managed separately from instances. + +## Creating volume + +__1.__ In **Project > Volumes > Volumes**, select **Create Volume**. + + + +__2.__ Provide name, description, and size in GBs. If not instructed otherwise, leave all other fields unchanged and click on **Create Volume**. + +__3.__ __(optional)__ In **Project > Compute > Instances**, select **Attach Volume** from the **Actions** menu for the + given instance. + +__4.__ __(optional)__ Select **Volume ID** from the drop-down list and click **Attach Volume**. + +For details, refer to [the official documentation](https://docs.openstack.org/horizon/train/user/manage-volumes.html). + +## Backups + +It is possible to create volume snapshots or backups. In this guide we will focus on volume backups. When creating a backup it is recommended to turn off the instance if possible to prevent data errors. + +### Creating volume backup + +__1.__ __(optional)__ In **Project > Compute > Instances** Turn off the affected instance. + + + +__2.__ In **Project > Volumes > Volumes** open the **Actions** menu of selected volume an select **Create Backup**. + + + +__3.__ Specify Backup Name and optional information and press **Create Volume Backup** + + + +__3.__ Wait for the Backup to be created, it will be then stored in **Project > Volumes > Backups**. + +### Restoring volume backup + +__1.__ __(optional)__ In **Project > Compute > Instances** Turn off the affected instance. + + + +__2.__ In **Project > Volumes > Backups** open the **Actions** menu of selected backup an select **Restore Backup**. + + + +__3.__ Wait for the Backup to be restored. + +## Volume resize + +We can distinghuish two types of volumes, namely + +- Attachable volumes: additional volumes that don't contain the system image and the VM can startup without their presence. +- System volumes: The boot image must be always present. + +### Resizing attachable volume + +When working with volumes, we highly recommend to always make a [volume backup](#creating-volume-backup) before any operations with the volume. + +__1.__ Turn off the instance in **Project > Compute > Instances**. + + + +__2.__ Detach the volume from the instance in **Project > Volumes > Volumes**. On selected volume open the **Actions** menu and select **Manage Attachments** + + + +__3.__ Select **Detach Volume** and confirm. + + + +__1.__ Open the **Actions** menu again an select **Extend Volume**. + + + +__4.__ Specify new size of the volume and press **Extend Volume**. + + + +__5.__ Attach the volume back to the instance via **Manage Attachments**. + + + +__6.__ Verify correct mounting of the volume in the instance. + + +### Resizing system volume + +Resizing the system volume is not possible. It is however possible to create a backup of the system volume, make necessary changes and deploy new VM with the modified volume. + +__1.__ Turn off the instance in **Project > Compute > Instances**. + + + +__1.__ First [create a volume backup](#creating-volume-backup). + +__2.__ Next [restore volume backup](#restoring-volume-backup), this will create a copy volume that can be attached to new instance. + +__3.__ In **Project > Volumes > Volumes** find created backup volume, its name should begin with restore_backup and in the **Actions** menu select **Extend Volume**. + + + +__4.__ Specify new volume size and press **Extend Volume**. + + + +__5.__ In **Actions** menu select **Launch as Instance** and deploy a new instance with this volume, or if you need to make additional changes to the volume, you can attach it to another instance via **Manage Attachments**. + +