You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by "sudo87 (via GitHub)" <gi...@apache.org> on 2025/09/12 07:27:16 UTC
[PR] Documentation related to Persistent domainXML [cloudstack-documentation]
sudo87 opened a new pull request, #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562
This PR is to add documentation for https://github.com/apache/cloudstack/pull/11541.
Dev PR is bringing following changes:
1. KVM domain will be persistent when Instance gets unmanaged from CloudStack.
2. Support Unmanaging Stoppped Instance and persisting domainXML
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3292136908
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 429)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3291418708
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3345281869
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3302530138
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 436)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3284102668
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3284319985
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3291428818
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 427)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3291423527
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3302524593
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3284323806
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 426)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3334644393
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 442)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3345285112
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3345288273
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 444)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3292132777
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3292128328
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3284099045
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3284318175
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "shwstppr (via GitHub)" <gi...@apache.org>.
shwstppr commented on code in PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#discussion_r2343306493
##########
source/adminguide/virtual_machines/importing_unmanaging_vms.rst:
##########
@@ -362,6 +362,22 @@ Preserving unmanaged Instance NICs
The zone setting: unmanage.vm.preserve.nics can be used to preserve Instance NICs and its MAC addresses after unmanaging them. If set to true, the Instance NICs (and their MAC addresses) are preserved when unmanaging it. Otherwise, NICs are removed and MAC addresses can be reassigned.
+KVM Specific: Persistent Domain XML when unmanaging Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Review Comment:
```suggestion
Persistent KVM Domain XML for Unmanaged Instances
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
```
##########
source/adminguide/virtual_machines/importing_unmanaging_vms.rst:
##########
@@ -362,6 +362,22 @@ Preserving unmanaged Instance NICs
The zone setting: unmanage.vm.preserve.nics can be used to preserve Instance NICs and its MAC addresses after unmanaging them. If set to true, the Instance NICs (and their MAC addresses) are preserved when unmanaging it. Otherwise, NICs are removed and MAC addresses can be reassigned.
+KVM Specific: Persistent Domain XML when unmanaging Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since 4.22, domain XML will be made persistent when Instance is unmanaged from CloudStack. This will allow to manage the Instance outside of CloudStack using virsh or other libvirt tools. The domain XML will be stored in directory /etc/libvirt/qemu.
Review Comment:
```suggestion
Since 4.22, the domain XML of an Instance is made persistent when it is unmanaged from CloudStack. This allows the Instance to be managed directly outside of CloudStack using `virsh` or other libvirt tools. The domain XML will be stored in the directory `/etc/libvirt/qemu` on the relevant KVM host.
```
##########
source/adminguide/virtual_machines/importing_unmanaging_vms.rst:
##########
@@ -362,6 +362,22 @@ Preserving unmanaged Instance NICs
The zone setting: unmanage.vm.preserve.nics can be used to preserve Instance NICs and its MAC addresses after unmanaging them. If set to true, the Instance NICs (and their MAC addresses) are preserved when unmanaging it. Otherwise, NICs are removed and MAC addresses can be reassigned.
+KVM Specific: Persistent Domain XML when unmanaging Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since 4.22, domain XML will be made persistent when Instance is unmanaged from CloudStack. This will allow to manage the Instance outside of CloudStack using virsh or other libvirt tools. The domain XML will be stored in directory /etc/libvirt/qemu.
+
+Domain XML is taken from Instance but varies based on their state:
+
+- Running Instance
+ - Domain XML is contructed from the Instance and persisted on the Host where the Instance is running
+- Stopped Instance
+ - Domain XML is constructed from the Instance details available in CloudStack database
+ - Domain XML will pe persisted on the last host where the Instance was running before stopping it
Review Comment:
```suggestion
- The domain XML is reconstructed from the Instance details available in the CloudStack database.
- The reconstructed domain XML is persisted on the last host where the Instance was running before it was stopped.
```
##########
source/adminguide/virtual_machines/importing_unmanaging_vms.rst:
##########
@@ -362,6 +362,22 @@ Preserving unmanaged Instance NICs
The zone setting: unmanage.vm.preserve.nics can be used to preserve Instance NICs and its MAC addresses after unmanaging them. If set to true, the Instance NICs (and their MAC addresses) are preserved when unmanaging it. Otherwise, NICs are removed and MAC addresses can be reassigned.
+KVM Specific: Persistent Domain XML when unmanaging Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since 4.22, domain XML will be made persistent when Instance is unmanaged from CloudStack. This will allow to manage the Instance outside of CloudStack using virsh or other libvirt tools. The domain XML will be stored in directory /etc/libvirt/qemu.
+
+Domain XML is taken from Instance but varies based on their state:
+
+- Running Instance
+ - Domain XML is contructed from the Instance and persisted on the Host where the Instance is running
+- Stopped Instance
+ - Domain XML is constructed from the Instance details available in CloudStack database
+ - Domain XML will pe persisted on the last host where the Instance was running before stopping it
+
+.. note:: We recommend Unmanaging Instance in Running state to preserve the exact domain XML. There is potential to loose some information when unmanaging in Stopped state.
Review Comment:
```suggestion
.. note::
It is recommended to unmanage Instances while they are in the **Running** state to ensure the exact domain XML is preserved. When unmanaged in the Stopped state, some information may be lost due to reconstruction.
```
##########
source/adminguide/virtual_machines/importing_unmanaging_vms.rst:
##########
@@ -362,6 +362,22 @@ Preserving unmanaged Instance NICs
The zone setting: unmanage.vm.preserve.nics can be used to preserve Instance NICs and its MAC addresses after unmanaging them. If set to true, the Instance NICs (and their MAC addresses) are preserved when unmanaging it. Otherwise, NICs are removed and MAC addresses can be reassigned.
+KVM Specific: Persistent Domain XML when unmanaging Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since 4.22, domain XML will be made persistent when Instance is unmanaged from CloudStack. This will allow to manage the Instance outside of CloudStack using virsh or other libvirt tools. The domain XML will be stored in directory /etc/libvirt/qemu.
+
+Domain XML is taken from Instance but varies based on their state:
+
+- Running Instance
+ - Domain XML is contructed from the Instance and persisted on the Host where the Instance is running
Review Comment:
```suggestion
- The existing domain XML is retrieved from the Instance and persisted on the host where the Instance is running.
```
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3284107511
QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/562. (QA-JID 425)
--
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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3334639549
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "sudo87 (via GitHub)" <gi...@apache.org>.
sudo87 commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3334634538
@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 related to Persistent domainXML [cloudstack-documentation]
Posted by "blueorangutan (via GitHub)" <gi...@apache.org>.
blueorangutan commented on PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562#issuecomment-3302526639
@sudo87 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 related to Persistent domainXML [cloudstack-documentation]
Posted by "harikrishna-patnala (via GitHub)" <gi...@apache.org>.
harikrishna-patnala merged PR #562:
URL: https://github.com/apache/cloudstack-documentation/pull/562
--
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