This is an automated email from the ASF dual-hosted git repository.
dahn pushed a commit to branch 4.19
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.19 by this push:
new 8a7f0c5 Add doc for importing and unmanaging volumes (#390)
8a7f0c5 is described below
commit 8a7f0c53168a10cc5a191afdf9488b8d7dae3d8c
Author: Wei Zhou <[email protected]>
AuthorDate: Tue Apr 23 16:10:36 2024 +0200
Add doc for importing and unmanaging volumes (#390)
Co-authored-by: Andrija Panic
<[email protected]>
---
source/_static/images/import-volume.png | Bin 0 -> 70185 bytes
.../images/list-unmanaged-managed-volumes.png | Bin 0 -> 186219 bytes
source/_static/images/unmanage-volume.png | Bin 0 -> 52903 bytes
source/adminguide/storage.rst | 80 +++++++++++++++++++++
4 files changed, 80 insertions(+)
diff --git a/source/_static/images/import-volume.png
b/source/_static/images/import-volume.png
new file mode 100644
index 0000000..7cb12ba
Binary files /dev/null and b/source/_static/images/import-volume.png differ
diff --git a/source/_static/images/list-unmanaged-managed-volumes.png
b/source/_static/images/list-unmanaged-managed-volumes.png
new file mode 100644
index 0000000..732d0bb
Binary files /dev/null and
b/source/_static/images/list-unmanaged-managed-volumes.png differ
diff --git a/source/_static/images/unmanage-volume.png
b/source/_static/images/unmanage-volume.png
new file mode 100644
index 0000000..7c00686
Binary files /dev/null and b/source/_static/images/unmanage-volume.png differ
diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst
index ffd7b25..f4d9698 100644
--- a/source/adminguide/storage.rst
+++ b/source/adminguide/storage.rst
@@ -1011,6 +1011,79 @@ Following is the example for checkVolume API usage and
the result in the volume
},
}
+
+Importing and Unmanaging Volumes from Storage Pools
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since Apache CloudStack 4.19.1.0, importing and unmanaging volumes from
primary storage pools are supported.
+
+.. note::
+ Currenty the supported storage types are: NFS, Ceph and Local storage for
KVM hypervisor.
+
+#. Log in to the CloudStack UI as an administrator.
+
+#. In the left navigation bar, click *Tools > Import DATA Volumes* section.
+
+#. Select the scope of the storage pool (Zone, Cluster, Host).
+
+#. Select the zone/pod/cluster/host of the storage pool.
+
+#. Select the storage pool.
+
+#. The unmanaged volumes on the storage pool are listed on the left panel.
+
+#. The managed volumes on the storage pool are listed on the right panel.
+
+|list-unmanaged-managed-volumes.png|
+
+To import a volume:
+
+#. select a unmanaged volume from the left panel, click "Import Volume" icon.
+
+#. In the Import Volume pop-up, select the Account Type,
Domain/Account/Project and a disk offering.
+
+#. Click OK.
+
+|import-volume.png|
+
+.. note::
+ - The volume to be imported must be placed in the root directory of the
storage pool.
+
+ - The format of the volume must be QCOW2 on NFS/Local storage, and RAW on
Ceph storage.
+
+ - The volume must not be encrypted.
+
+ - The volume must not be locked.
+
+ - The volume must not have a backing file.
+
+
+.. note::
+ By default, the volume is imported for the caller if Domain/Account/Project
are not set. By default, the imported volumes use the default disk offering
"Default Custom Offering for Volume Import"
+ (on Shared storages) or "Default Custom Offering for Volume Import - Local"
(on Local storages).
+
+To unmanage volume(s):
+
+#. select the volumes to be unmanaged from the right panel
+
+#. click "Unmanage Volume" or "Unmanage Volumes" icon
+
+#. click OK in the confirmation dialog.
+
+|unmanage-volume.png|
+
+.. note::
+ - The volume to be unmanaged must not be attached to any VM as ROOT disk or
DATA disk.
+
+ - The volume to be umnanaged must be at Ready state.
+
+ - The volume must not be encrypted.
+
+ - The volume must not be locked by another process.
+
+ - The volume must not have a backing file.
+
+
Working with Volume Snapshots
-----------------------------
@@ -1342,3 +1415,10 @@ Deleting objects from a bucket
:alt: Upload button
.. |adding-local-pool-via-ui.png| image::
/_static/images/adding-local-pool-via-ui.png
:alt: Adding Local Storage Pool via UI
+.. |list-unmanaged-managed-volumes.png| image::
/_static/images/list-unmanaged-managed-volumes.png
+ :alt: List of Unmanaged and Managed Volumes
+.. |import-volume.png| image:: /_static/images/import-volume.png
+ :alt: Import Volume
+.. |unmanage-volume.png| image:: /_static/images/unmanage-volume.png
+ :alt: Unmanage Volume
+
