libvirt/docs/manpages
Daniel Henrique Barboza 3a58613b0c manpages/virsh.rst: clarify numatune memory migration on Linux
On Linux, changing the nodeset on 'numatune' does not imply that
the guest memory will be migrated on the spot to the new nodeset.
The memory migration is tied on guest usage of the memory pages,
and an idle guest will take longer to have its memory migrated
to the new nodeset.

This is a behavior explained in detail in the Linux kernel
documentation in Documentation/admin-guide/cgroup-v1/cpusets.rst.
The user doesn't need this level of detail though - just needs
his/her expectations under check. Running 'numastat' and hoping
for instant memory migration from the previous nodeset to the new
one is not viable.

There's also parts of the memory that are locked by QEMU in the
same place, e.g. when VFIO devices are present. Let's also
mention it as another factor that impacts the results the
user might expect from NUMA memory migration with numatune.

https://bugzilla.redhat.com/show_bug.cgi?id=1640869

Signed-off-by: Daniel Henrique Barboza <danielhb413@gmail.com>
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
2020-06-16 14:06:37 +02:00
..
index.rst docs: Fix link to virt-qemu-run(1) 2020-01-27 17:57:02 +01:00
libvirtd.rst docs: stop using syntax highlighting for man page code blocks 2019-12-12 11:16:47 +00:00
virsh.rst manpages/virsh.rst: clarify numatune memory migration on Linux 2020-06-16 14:06:37 +02:00
virt-admin.rst tools: mention server-update-tls supports virtproxyd 2020-05-13 16:28:14 +01:00
virt-host-validate.rst docs: convert virt-host-validate man page from pod to rst 2019-12-11 14:28:41 +00:00
virt-login-shell.rst docs: stop using syntax highlighting for man page code blocks 2019-12-12 11:16:47 +00:00
virt-pki-validate.rst docs: convert virt-pki-validate man page from pod to rst 2019-12-11 14:28:41 +00:00
virt-qemu-run.rst docs: add warning about virt-qemu-run being experimental 2020-01-29 14:30:57 +00:00
virt-sanlock-cleanup.rst man: fix section of virt-sanlock-cleanup 2020-01-17 15:34:10 +01:00
virt-xml-validate.rst docs: convert virt-xml-validate man page from pod to rst 2019-12-11 14:28:41 +00:00
virtlockd.rst docs: stop using syntax highlighting for man page code blocks 2019-12-12 11:16:47 +00:00
virtlogd.rst docs: stop using syntax highlighting for man page code blocks 2019-12-12 11:16:47 +00:00