You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by "abh1sar (via GitHub)" <gi...@apache.org> on 2024/04/24 17:49:53 UTC
[PR] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
abh1sar opened a new pull request, #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396
Documentation PR for https://github.com/apache/cloudstack/pull/8947
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2076326010
@shwstppr a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on code in PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#discussion_r1579411396
##########
source/adminguide/storage.rst:
##########
@@ -237,6 +238,66 @@ templates, and ISOs.
.. note::
If files or folders are not associated with a cloudstack resource, it doesn't mean that they are not used by cloudstack.
+
+Setting NFS Mount Options on the Storage Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NFS mount options can be added while creating an NFS storage pool for
+KVM hosts. When the storage pool is mounted on the KVM hypervisor host,
+these options will be used. Options currently tested and supported are
+`vers` and `nconnect`.
+
+Although it depends on the NFS server, but commonly supported `vers` values
+are `3` for NFSv3 and minor versions `4.0, 4.1 and 4.2` for NFSv4.
+`nconnect` values can range from 1 to 16.
+
+Administrator can give the NFS mount options while adding a Primary Storage
+from the Create Zone Wizard as well as the Add Primary Storage form.
+|nfs-mount-options-create-zone-wizard.png|
+|nfs-mount-options-add-primary-storage.png|
+
+NFS mount options can be changed on a pre-existing Storage Pool using the
+Edit Primary Storage form. Storage Pool needs to be unmounted and mounted
+again on the KVM host using the new options. Running VMs using volumes
+in the Storage Pool either need to be stopped or the volumes migrated.
+So the NFS Mount Options field below is only shown if the Storage Pool
Review Comment:
I think, this and below 2 lines may not be required after updated with above suggestions
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on code in PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#discussion_r1579409393
##########
source/adminguide/storage.rst:
##########
@@ -237,6 +238,66 @@ templates, and ISOs.
.. note::
If files or folders are not associated with a cloudstack resource, it doesn't mean that they are not used by cloudstack.
+
+Setting NFS Mount Options on the Storage Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NFS mount options can be added while creating an NFS storage pool for
+KVM hosts. When the storage pool is mounted on the KVM hypervisor host,
+these options will be used. Options currently tested and supported are
+`vers` and `nconnect`.
+
+Although it depends on the NFS server, but commonly supported `vers` values
+are `3` for NFSv3 and minor versions `4.0, 4.1 and 4.2` for NFSv4.
+`nconnect` values can range from 1 to 16.
+
+Administrator can give the NFS mount options while adding a Primary Storage
+from the Create Zone Wizard as well as the Add Primary Storage form.
+|nfs-mount-options-create-zone-wizard.png|
+|nfs-mount-options-add-primary-storage.png|
+
+NFS mount options can be changed on a pre-existing Storage Pool using the
+Edit Primary Storage form. Storage Pool needs to be unmounted and mounted
+again on the KVM host using the new options. Running VMs using volumes
+in the Storage Pool either need to be stopped or the volumes migrated.
Review Comment:
```suggestion
in the Storage Pool either need to be stopped or the volumes would be migrated to other available pools upon enabling maintenance.
```
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2076326698
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/396. (QA-JID 228)
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "abh1sar (via GitHub)" <gi...@apache.org>.
abh1sar commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2092929366
@blueorangutan builddoc
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "shwstppr (via GitHub)" <gi...@apache.org>.
shwstppr commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2076325435
@blueorangutan docbuild
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2095283558
@blueorangutan docbuild
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "abh1sar (via GitHub)" <gi...@apache.org>.
abh1sar commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2076323546
@sureshanaparti @rohityadavcloud @shwstppr @harikrishna-patnala please review
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on code in PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#discussion_r1588872064
##########
source/adminguide/storage.rst:
##########
@@ -237,6 +238,74 @@ templates, and ISOs.
.. note::
If files or folders are not associated with a cloudstack resource, it doesn't mean that they are not used by cloudstack.
+
+Setting NFS Mount Options on the Storage Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NFS mount options can be added while creating an NFS storage pool for
+KVM hosts. When the storage pool is mounted on the KVM hypervisor host,
+these options will be used. Options currently tested and supported are
+`vers` and `nconnect`.
+
+Although it depends on the NFS server, but commonly supported `vers` values
+are `3` for NFSv3 and minor versions `4.0, 4.1 and 4.2` for NFSv4.
+`nconnect` values can range from 1 to 16.
+
+Administrator can give the NFS mount options while adding a Primary Storage
+from the Create Zone Wizard as well as the Add Primary Storage form.
+|nfs-mount-options-create-zone-wizard.png|
+|nfs-mount-options-add-primary-storage.png|
+
+NFS mount options can be changed on a pre-existing Storage Pool in maintenance
+mode using the Edit Primary Storage form. Running VMs using volumes in the
+Storage Pool will either be stopped or the volumes would be migrated to other
+available pools upon enabling maintenance mode.
+Storage Pool will be unmounted and mounted again on the KVM hosts using the
+new options upon cancelling the maintenance mode.
+|nfs-mount-options-edit-primary-storage.png|
+
+Mount failing due to an incorrect Mount Option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Add Storage Pool will fail with the error ``An incorrect mount option was specified``.
+
+In the Update storage pool case, cancel maintenance will throw the above error.
+The Administrator has to repeat the process of enabling maintenance mode,
Review Comment:
not need to enable maintenance mode again, admin has to change the mount options to the correct one and then cancel the maintenance mode.
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "abh1sar (via GitHub)" <gi...@apache.org>.
abh1sar commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2089720242
@blueorangutan docbuild
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on code in PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#discussion_r1579406891
##########
source/adminguide/storage.rst:
##########
@@ -237,6 +238,66 @@ templates, and ISOs.
.. note::
If files or folders are not associated with a cloudstack resource, it doesn't mean that they are not used by cloudstack.
+
+Setting NFS Mount Options on the Storage Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NFS mount options can be added while creating an NFS storage pool for
+KVM hosts. When the storage pool is mounted on the KVM hypervisor host,
+these options will be used. Options currently tested and supported are
+`vers` and `nconnect`.
+
+Although it depends on the NFS server, but commonly supported `vers` values
+are `3` for NFSv3 and minor versions `4.0, 4.1 and 4.2` for NFSv4.
+`nconnect` values can range from 1 to 16.
+
+Administrator can give the NFS mount options while adding a Primary Storage
+from the Create Zone Wizard as well as the Add Primary Storage form.
+|nfs-mount-options-create-zone-wizard.png|
+|nfs-mount-options-add-primary-storage.png|
+
+NFS mount options can be changed on a pre-existing Storage Pool using the
Review Comment:
```suggestion
NFS mount options can be changed on a pre-existing Storage Pool in maintenance mode, using the
```
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2089721126
@abh1sar a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on code in PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#discussion_r1588872064
##########
source/adminguide/storage.rst:
##########
@@ -237,6 +238,74 @@ templates, and ISOs.
.. note::
If files or folders are not associated with a cloudstack resource, it doesn't mean that they are not used by cloudstack.
+
+Setting NFS Mount Options on the Storage Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NFS mount options can be added while creating an NFS storage pool for
+KVM hosts. When the storage pool is mounted on the KVM hypervisor host,
+these options will be used. Options currently tested and supported are
+`vers` and `nconnect`.
+
+Although it depends on the NFS server, but commonly supported `vers` values
+are `3` for NFSv3 and minor versions `4.0, 4.1 and 4.2` for NFSv4.
+`nconnect` values can range from 1 to 16.
+
+Administrator can give the NFS mount options while adding a Primary Storage
+from the Create Zone Wizard as well as the Add Primary Storage form.
+|nfs-mount-options-create-zone-wizard.png|
+|nfs-mount-options-add-primary-storage.png|
+
+NFS mount options can be changed on a pre-existing Storage Pool in maintenance
+mode using the Edit Primary Storage form. Running VMs using volumes in the
+Storage Pool will either be stopped or the volumes would be migrated to other
+available pools upon enabling maintenance mode.
+Storage Pool will be unmounted and mounted again on the KVM hosts using the
+new options upon cancelling the maintenance mode.
+|nfs-mount-options-edit-primary-storage.png|
+
+Mount failing due to an incorrect Mount Option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Add Storage Pool will fail with the error ``An incorrect mount option was specified``.
+
+In the Update storage pool case, cancel maintenance will throw the above error.
+The Administrator has to repeat the process of enabling maintenance mode,
Review Comment:
not need to enable maintenance mode again as pool would be in maintenance already, admin has to change the mount options to the correct one and then retry cancel the maintenance mode.
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2095286200
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/396. (QA-JID 233)
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2095285171
@sureshanaparti a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "sureshanaparti (via GitHub)" <gi...@apache.org>.
sureshanaparti commented on code in PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#discussion_r1579407561
##########
source/adminguide/storage.rst:
##########
@@ -237,6 +238,66 @@ templates, and ISOs.
.. note::
If files or folders are not associated with a cloudstack resource, it doesn't mean that they are not used by cloudstack.
+
+Setting NFS Mount Options on the Storage Pool
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NFS mount options can be added while creating an NFS storage pool for
+KVM hosts. When the storage pool is mounted on the KVM hypervisor host,
+these options will be used. Options currently tested and supported are
+`vers` and `nconnect`.
+
+Although it depends on the NFS server, but commonly supported `vers` values
+are `3` for NFSv3 and minor versions `4.0, 4.1 and 4.2` for NFSv4.
+`nconnect` values can range from 1 to 16.
+
+Administrator can give the NFS mount options while adding a Primary Storage
+from the Create Zone Wizard as well as the Add Primary Storage form.
+|nfs-mount-options-create-zone-wizard.png|
+|nfs-mount-options-add-primary-storage.png|
+
+NFS mount options can be changed on a pre-existing Storage Pool using the
+Edit Primary Storage form. Storage Pool needs to be unmounted and mounted
+again on the KVM host using the new options. Running VMs using volumes
Review Comment:
```suggestion
again on the KVM host using the new options upon cancelling the maintenance. Running VMs using volumes
```
--
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] Documentation for adding NFS mount options to storage pool [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #396:
URL: https://github.com/apache/cloudstack-documentation/pull/396#issuecomment-2089722181
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/396. (QA-JID 232)
--
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