|
 |
c1c534 |
From d52ae79470eb8725b63a6470e393149b48f508da Mon Sep 17 00:00:00 2001
|
|
|
c1c534 |
Message-Id: <d52ae79470eb8725b63a6470e393149b48f508da@dist-git>
|
|
|
c1c534 |
From: Jiri Denemark <jdenemar@redhat.com>
|
|
|
c1c534 |
Date: Fri, 8 Dec 2017 10:31:38 +0100
|
|
|
c1c534 |
Subject: [PATCH] migration.html: Clarify configuration file handling docs
|
|
|
c1c534 |
|
|
|
c1c534 |
Migration never removes any configuration files on the destination host.
|
|
|
c1c534 |
Thus when the domain is already defined on the destination, it will stay
|
|
|
c1c534 |
persistent even after migration without --persist.
|
|
|
c1c534 |
|
|
|
c1c534 |
https://bugzilla.redhat.com/show_bug.cgi?id=1514930
|
|
|
c1c534 |
|
|
|
c1c534 |
Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
|
|
|
c1c534 |
(cherry picked from commit 2c01e4febcd161226ce707892d8e53f4e66f708f)
|
|
|
c1c534 |
Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
|
|
|
c1c534 |
---
|
|
|
c1c534 |
docs/migration.html.in | 34 +++++++++++++++++-----------------
|
|
|
c1c534 |
1 file changed, 17 insertions(+), 17 deletions(-)
|
|
|
c1c534 |
|
|
|
c1c534 |
diff --git a/docs/migration.html.in b/docs/migration.html.in
|
|
|
c1c534 |
index de7d4def75..7c345b65b7 100644
|
|
|
c1c534 |
--- a/docs/migration.html.in
|
|
|
c1c534 |
+++ b/docs/migration.html.in
|
|
|
c1c534 |
@@ -206,14 +206,14 @@
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
- There are two types of virtual machine known to libvirt. A transient
|
|
|
c1c534 |
+ There are two types of virtual machines known to libvirt. A transient
|
|
|
c1c534 |
guest only exists while it is running, and has no configuration file stored
|
|
|
c1c534 |
on disk. A persistent guest maintains a configuration file on disk
|
|
|
c1c534 |
even when it is not running.
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
- By default, a migration operation will not attempt to change any configuration
|
|
|
c1c534 |
+ By default, a migration operation will not attempt to modify any configuration
|
|
|
c1c534 |
files that may be stored on either the source or destination host. It is the
|
|
|
c1c534 |
administrator, or management application's, responsibility to manage distribution
|
|
|
c1c534 |
of configuration files (if desired). It is important to note that the /etc/libvirt
|
|
|
c1c534 |
@@ -230,14 +230,14 @@
|
|
|
c1c534 |
host and removed on the original.
|
|
|
c1c534 |
|
|
|
c1c534 |
Centralized configuration files outside libvirt, in a database. A data center
|
|
|
c1c534 |
- management application may not storage configuration files at all. Instead it
|
|
|
c1c534 |
+ management application may not store configuration files at all. Instead it
|
|
|
c1c534 |
may generate libvirt XML on the fly when a guest is booted. It will typically
|
|
|
c1c534 |
use transient guests, and thus not have to consider configuration files during
|
|
|
c1c534 |
migration.
|
|
|
c1c534 |
|
|
|
c1c534 |
Distributed configuration inside libvirt. The configuration file for each
|
|
|
c1c534 |
guest is copied to every host where the guest is able to run. Upon migration
|
|
|
c1c534 |
- the existing config merely needs to be updated with any changes
|
|
|
c1c534 |
+ the existing config merely needs to be updated with any changes.
|
|
|
c1c534 |
|
|
|
c1c534 |
Ad-hoc configuration management inside libvirt. Each guest is tied to a
|
|
|
c1c534 |
specific host and rarely migrated. When migration is required, the config
|
|
|
c1c534 |
@@ -246,7 +246,7 @@
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
- As mentioned above, libvirt will not touch configuration files during
|
|
|
c1c534 |
+ As mentioned above, libvirt will not modify configuration files during
|
|
|
c1c534 |
migration by default. The virsh command has two flags to
|
|
|
c1c534 |
influence this behaviour. The --undefine-source flag
|
|
|
c1c534 |
will cause the configuration file to be removed on the source host
|
|
|
c1c534 |
@@ -265,12 +265,12 @@
|
|
|
c1c534 |
After migration
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
- Guest type
|
|
|
c1c534 |
+ Source type
|
|
|
c1c534 |
Source config
|
|
|
c1c534 |
Dest config
|
|
|
c1c534 |
--undefine-source
|
|
|
c1c534 |
--persist
|
|
|
c1c534 |
- Guest type
|
|
|
c1c534 |
+ Dest type
|
|
|
c1c534 |
Source config
|
|
|
c1c534 |
Dest config
|
|
|
c1c534 |
|
|
|
c1c534 |
@@ -325,9 +325,9 @@
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
N
|
|
|
c1c534 |
N
|
|
|
c1c534 |
- Transient
|
|
|
c1c534 |
- N
|
|
|
c1c534 |
+ Persistent
|
|
|
c1c534 |
N
|
|
|
c1c534 |
+ Y
(unchanged dest config)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
Transient
|
|
|
c1c534 |
@@ -335,9 +335,9 @@
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
N
|
|
|
c1c534 |
- Transient
|
|
|
c1c534 |
- N
|
|
|
c1c534 |
+ Persistent
|
|
|
c1c534 |
N
|
|
|
c1c534 |
+ Y
(unchanged dest config)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
Transient
|
|
|
c1c534 |
@@ -347,7 +347,7 @@
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
N
|
|
|
c1c534 |
- Y
|
|
|
c1c534 |
+ Y
(replaced with source)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
Transient
|
|
|
c1c534 |
@@ -357,7 +357,7 @@
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
N
|
|
|
c1c534 |
- Y
|
|
|
c1c534 |
+ Y
(replaced with source)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
@@ -411,7 +411,7 @@
|
|
|
c1c534 |
N
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
- Y
|
|
|
c1c534 |
+ Y
(unchanged dest config)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
@@ -421,7 +421,7 @@
|
|
|
c1c534 |
N
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
N
|
|
|
c1c534 |
- Y
|
|
|
c1c534 |
+ Y
(unchanged dest config)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
@@ -431,7 +431,7 @@
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
- Y
|
|
|
c1c534 |
+ Y
(replaced with source)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
@@ -441,7 +441,7 @@
|
|
|
c1c534 |
Y
|
|
|
c1c534 |
Persistent
|
|
|
c1c534 |
N
|
|
|
c1c534 |
- Y
|
|
|
c1c534 |
+ Y
(replaced with source)
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
|
|
|
c1c534 |
--
|
|
|
c1c534 |
2.15.1
|
|
|
c1c534 |
|