From nobody Thu May 2 16:29:16 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 151272617549265.14464833817169; Fri, 8 Dec 2017 01:42:55 -0800 (PST) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id CB2E6C04AC4F; Fri, 8 Dec 2017 09:42:49 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 29F9919658; Fri, 8 Dec 2017 09:42:49 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id C1B5F1806103; Fri, 8 Dec 2017 09:42:47 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id vB89gkaJ017607 for ; Fri, 8 Dec 2017 04:42:46 -0500 Received: by smtp.corp.redhat.com (Postfix) id 9301818ECD; Fri, 8 Dec 2017 09:42:46 +0000 (UTC) Received: from mamuti.net (ovpn-204-155.brq.redhat.com [10.40.204.155]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 39B8C17AB6 for ; Fri, 8 Dec 2017 09:42:44 +0000 (UTC) Received: by mamuti.net (Postfix, from userid 500) id BBCCE1011B8; Fri, 8 Dec 2017 10:42:42 +0100 (CET) From: Jiri Denemark To: libvir-list@redhat.com Date: Fri, 8 Dec 2017 10:42:30 +0100 Message-Id: <90f0d54dd05cc9bd0eb3940676c843393b370371.1512726150.git.jdenemar@redhat.com> Mail-Followup-To: libvir-list@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH] migration.html: Clarify configuration file handling docs X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.31]); Fri, 08 Dec 2017 09:42:50 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Migration never removes any configuration files on the destination host. Thus when the domain is already defined on the destination, it will stay persistent even after migration without --persist. https://bugzilla.redhat.com/show_bug.cgi?id=3D1514930 Signed-off-by: Jiri Denemark --- docs/migration.html.in | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/migration.html.in b/docs/migration.html.in index de7d4def75..7c345b65b7 100644 --- a/docs/migration.html.in +++ b/docs/migration.html.in @@ -206,14 +206,14 @@

Configuration file handling

=20

- There are two types of virtual machine known to libvirt. A trans= ient + There are two types of virtual machines known to libvirt. A tran= sient guest only exists while it is running, and has no configuration file= stored on disk. A persistent guest maintains a configuration file = on disk even when it is not running.

=20

- By default, a migration operation will not attempt to change any con= figuration + By default, a migration operation will not attempt to modify any con= figuration files that may be stored on either the source or destination host. I= t is the administrator, or management application's, responsibility to manage= distribution of configuration files (if desired). It is important to note that th= e /etc/libvirt @@ -230,14 +230,14 @@ host and removed on the original.

  • Centralized configuration files outside libvirt, in a database. = A data center - management application may not storage configuration files at all.= Instead it + management application may not store configuration files at all. I= nstead it may generate libvirt XML on the fly when a guest is booted. It wil= l typically use transient guests, and thus not have to consider configuration = files during migration.
  • Distributed configuration inside libvirt. The configuration file= for each guest is copied to every host where the guest is able to run. Upon= migration - the existing config merely needs to be updated with any changes + the existing config merely needs to be updated with any changes.
  • Ad-hoc configuration management inside libvirt. Each guest is ti= ed to a specific host and rarely migrated. When migration is required, the= config @@ -246,7 +246,7 @@ =20

    - As mentioned above, libvirt will not touch configuration files during + As mentioned above, libvirt will not modify configuration files duri= ng migration by default. The virsh command has two flags to influence this behaviour. The --undefine-source flag will cause the configuration file to be removed on the source host @@ -265,12 +265,12 @@ After migration - Guest type + Source type Source config Dest config --undefine-source --persist - Guest type + Dest type Source config Dest config @@ -325,9 +325,9 @@ Y N N - Transient - N + Persistent N + Y
    (unchanged dest config) Transient @@ -335,9 +335,9 @@ Y Y N - Transient - N + Persistent N + Y
    (unchanged dest config) Transient @@ -347,7 +347,7 @@ Y Persistent N - Y + Y
    (replaced with source) Transient @@ -357,7 +357,7 @@ Y Persistent N - Y + Y
    (replaced with source) =20 @@ -411,7 +411,7 @@ N Persistent Y - Y + Y
    (unchanged dest config) Persistent @@ -421,7 +421,7 @@ N Persistent N - Y + Y
    (unchanged dest config) Persistent @@ -431,7 +431,7 @@ Y Persistent Y - Y + Y
    (replaced with source) Persistent @@ -441,7 +441,7 @@ Y Persistent N - Y + Y
    (replaced with source) --=20 2.15.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list