You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by "weizhouapache (via GitHub)" <gi...@apache.org> on 2024/04/03 12:39:20 UTC
[PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
weizhouapache opened a new pull request, #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390
this is the document for [apache/cloudstack#8808](https://github.com/apache/cloudstack/pull/8808)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "andrijapanicsb (via GitHub)" <gi...@apache.org>.
andrijapanicsb commented on code in PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390#discussion_r1572312874
##########
source/adminguide/storage.rst:
##########
@@ -1011,6 +1011,60 @@ 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 should be QCOW2 on NFS/Local storage, and RAW on Ceph storage.
+ Encrypted volumes cannot be unmanaged or imported.
+
+.. 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),
Review Comment:
```suggestion
To unmanage volume(s):
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "andrijapanicsb (via GitHub)" <gi...@apache.org>.
andrijapanicsb commented on code in PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390#discussion_r1572314144
##########
source/adminguide/storage.rst:
##########
@@ -1011,6 +1011,60 @@ 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,
Review Comment:
```suggestion
To import a volume:
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "weizhouapache (via GitHub)" <gi...@apache.org>.
weizhouapache commented on PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390#issuecomment-2037441028
> @weizhouapache can we mention that only qcow2 format data volumes are supported for import and raw and other image formats are not supported.
>
> The format of qcow2 can be checked by executing the command
>
> qemu-img info <>
>
> -- Also, can we mention encrypted volumes are not supported
added to notes
thanks @kiranchavala
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "weizhouapache (via GitHub)" <gi...@apache.org>.
weizhouapache commented on code in PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390#discussion_r1572690092
##########
source/adminguide/storage.rst:
##########
@@ -1011,6 +1011,60 @@ 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 should be QCOW2 on NFS/Local storage, and RAW on Ceph storage.
+ Encrypted volumes cannot be unmanaged or imported.
Review Comment:
```suggestion
The following volumes cannot be unmanaged or imported: (1) volume is encrypted; (2) volume is locked; (3) volume has a backing file.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "weizhouapache (via GitHub)" <gi...@apache.org>.
weizhouapache commented on PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390#issuecomment-2036544003
> @weizhouapache can we mention that only qcow2 format data volumes are supported for import and raw and other image formats are not supported.
>
> The format of qcow2 can be checked by executing the command
>
> qemu-img info <>
>
> -- Also, can we mention encrypted volumes are not supported
thanks @kiranchavala
I will update
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "weizhouapache (via GitHub)" <gi...@apache.org>.
weizhouapache commented on PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390#issuecomment-2034520666
https://cloudstack-documentation--390.org.readthedocs.build/en/390/adminguide/storage.html#importing-and-unmanaging-volumes-from-storage-pools
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Add doc for importing and unmanaging volumes [cloudstack-documentation]
Posted by "DaanHoogland (via GitHub)" <gi...@apache.org>.
DaanHoogland merged PR #390:
URL: https://github.com/apache/cloudstack-documentation/pull/390
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@cloudstack.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org