[pve-devel] applied: [PATCH docs] add vmgenid documentation

Thomas Lamprecht t.lamprecht at proxmox.com
Fri Sep 21 16:28:20 CEST 2018


On 9/19/18 11:35 AM, Dominik Csapak wrote:
> explain how to use it, what it is and a link to further documentation
> 
> Signed-off-by: Dominik Csapak <d.csapak at proxmox.com>
> ---
>  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
>  ------------------------------------------
>  
> 

applied, with a few missing spaces, wording and such fixups.
Also moved the link to a footnote, like we normally do.
Thanks!




More information about the pve-devel mailing list