From 319d5325c03c33a36c5afadf74513eda31c4b9fb Mon Sep 17 00:00:00 2001 From: Dominik Csapak Date: Wed, 19 Sep 2018 11:35:12 +0200 Subject: [PATCH] qm: add vmgenid documentation explain how to use it, what it is and a link to further documentation Signed-off-by: Dominik Csapak --- qm.adoc | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/qm.adoc b/qm.adoc index 1451f5d..da52391 100644 --- a/qm.adoc +++ b/qm.adoc @@ -788,6 +788,37 @@ NOTE: It is not possible to start templates, because this would modify the disk images. If you want to change the template, create a linked clone and modify that. +VM Generation ID +---------------- + +{pve} supports VM Generation ID for virtual machines. +This is used in the guest operating system to determine if any +event happened to the vm which might resulted in a time shift event. + +On creation, a vm generation id will be automatically generated and +set in the configuration. + +To disable it, either set the id to `0` or delete the property in the config +with: + + qm set ID -vmgenid 0 + qm set ID -delete vmgenid + +To create one (either on an older vm or one where you disabled it), either +set the uuid directly or use the special value `1` to let {pve} autogenerate +one: + + qm set ID -vmgenid 1 + qm set ID -vmgenid 00000000-0000-0000-0000-000000000000 + +The most common use case for the vm generation id is for Microsoft Windows +operating system to be able to detect snapshots,backups,clones,etc. in such +a way that services can react to it (e.g. Domain Controllers) + +For more information about vm generation id, see + +https://docs.microsoft.com/en-us/windows/desktop/hyperv_v2/virtual-machine-generation-identifier + Importing Virtual Machines and disk images ------------------------------------------ -- 2.39.2