qemu-colo.rst: Miscellaneous changes
Reviewed-by: Fabiano Rosas <farosas@suse.de> Reviewed-by: Zhang Chen <zhangckid@gmail.com> Signed-off-by: Lukas Straub <lukasstraub2@web.de> Link: https://lore.kernel.org/qemu-devel/20260302-colo_unit_test_multifd-v11-15-d653fb3b1d80@web.de Signed-off-by: Fabiano Rosas <farosas@suse.de>
Lukas Straub committed
Mar 2, 2026 at 12:45 UTC
1d8f2e48ff81cd90fcccf24e52cfbfe9cff09bb1
1 file changed
+15
-14
docs/system/qemu-colo.rst
+15
-14
@@ -3,10 +3,6 @@
3
Qemu COLO Fault Tolerance
4
=========================
5
6
-| Copyright (c) 2016 Intel Corporation
7
-| Copyright (c) 2016 HUAWEI TECHNOLOGIES CO., LTD.
8
-| Copyright (c) 2016 Fujitsu, Corp.
9
-
6
This document gives an overview of COLO's design and how to use it.
7
8
Background
@@ -81,8 +77,8 @@ Overview::
77
| Storage | |External Network| | External Network | | Storage |
78
+---------------+ +----------------+ +------------------+ +--------------+
79
84
-Components introduction
85
-^^^^^^^^^^^^^^^^^^^^^^^
80
+Components
81
+^^^^^^^^^^
82
You can see there are several components in COLO's diagram of architecture.
83
Their functions are described below.
84
@@ -156,14 +152,21 @@ in test procedure.
152
153
Test procedure
154
--------------
159
-Note: Here we are running both instances on the same host for testing,
155
+
156
+Setup
157
+^^^^^
158
+
159
+Here we are running both instances on the same host for testing,
160
change the IP Addresses if you want to run it on two hosts. Initially
161
``127.0.0.1`` is the Primary Host and ``127.0.0.2`` is the Secondary Host.
162
163
+COLO uses double the guest ram size on the secondary side. The Qemu version
164
+should be the same on both hosts.
165
+
166
Startup qemu
167
^^^^^^^^^^^^
168
**1. Primary**:
166
-Note: Initially, ``$imagefolder/primary.qcow2`` needs to be copied to all hosts.
169
+Initially, ``$imagefolder/primary.qcow2`` needs to be copied to all hosts.
170
You don't need to change any IP's here, because ``0.0.0.0`` listens on any
171
interface. The chardev's with ``127.0.0.1`` IP's loopback to the local qemu
172
instance::
@@ -191,7 +194,7 @@ instance::
194
195
196
**2. Secondary**:
194
-Note: Active and hidden images need to be created only once and the
197
+Active and hidden images need to be created only once and the
198
size should be the same as ``primary.qcow2``. Again, you don't need to change
199
any IP's here, except for the ``$primary_ip`` variable::
200
@@ -352,8 +355,6 @@ Wait until disk is synced, then::
355
{"execute": "migrate-set-capabilities", "arguments":{ "capabilities": [ {"capability": "x-colo", "state": true } ] } }
356
{"execute": "migrate", "arguments":{ "uri": "tcp:127.0.0.1:9998" } }
357
355
-TODO
356
-----
357
-1. Support shared storage.
358
-2. Develop the heartbeat part.
359
-3. Reduce checkpoint VM’s downtime while doing checkpoint.
358
+| Copyright (c) 2016 Intel Corporation
359
+| Copyright (c) 2016 HUAWEI TECHNOLOGIES CO., LTD.
360
+| Copyright (c) 2016 Fujitsu, Corp.