[pve-devel] [PATCH qemu-server/manager/docs v2 0/3] live-migration with VNC clipboard

[pve-devel] [PATCH qemu-server/manager/docs v2 0/3] live-migration with VNC clipboard

[Markus Frank]

The live-migration feature now works with QEMU 10.1:
5d56bff11e ("ui/vdagent: add migration support")


qemu-server:

v2:
* add machine version check to ensure QEMU version is at least 10.1.

Markus Frank (1):
  vga: allow live-migration with clipboard

 src/PVE/API2/Qemu.pm   | 4 +++-
 src/PVE/QemuMigrate.pm | 6 +++++-
 src/PVE/QemuServer.pm  | 4 ++--
 3 files changed, 10 insertions(+), 4 deletions(-)



pve-manager:

v2:
* update text of hint instead of removing it entirely

Markus Frank (1):
  ui: display: update 'live-migration with VNC-clipboard not working'
    note

 www/manager6/qemu/DisplayEdit.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)



docs:

v2:
* update live-migration limitation text instead of removing it entirely

Markus Frank (1):
  vnc-clipboard: change 'live-migration not working' note

 qm.adoc | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

-- 
2.47.3



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] [PATCH qemu-server v2 1/3] vga: allow live-migration with clipboard

[Markus Frank]

The live-migration feature now works with QEMU 10.1:
5d56bff11e ("ui/vdagent: add migration support")

Signed-off-by: Markus Frank <m.frank@proxmox.com>
---
v2:
* add machine version check to ensure QEMU version is at least 10.1.

 src/PVE/API2/Qemu.pm   | 4 +++-
 src/PVE/QemuMigrate.pm | 6 +++++-
 src/PVE/QemuServer.pm  | 4 ++--
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/PVE/API2/Qemu.pm b/src/PVE/API2/Qemu.pm
index 190878de..3ab0afcf 100644
--- a/src/PVE/API2/Qemu.pm
+++ b/src/PVE/API2/Qemu.pm
@@ -5300,7 +5300,9 @@ __PACKAGE__->register_method({
 
         my $vga = PVE::QemuServer::parse_vga($vmconf->{vga});
         if ($res->{running} && $vga->{'clipboard'} && $vga->{'clipboard'} eq 'vnc') {
-            push $local_resources->@*, "clipboard=vnc";
+            my $machine_version = PVE::QemuServer::Machine::get_current_qemu_machine($vmid);
+            push $local_resources->@*, "clipboard=vnc"
+                if !PVE::QemuServer::Machine::is_machine_version_at_least($machine_version, 10, 1);
         }
 
         $res->{allowed_nodes} = [];
diff --git a/src/PVE/QemuMigrate.pm b/src/PVE/QemuMigrate.pm
index b3ddc34e..829288ff 100644
--- a/src/PVE/QemuMigrate.pm
+++ b/src/PVE/QemuMigrate.pm
@@ -301,7 +301,11 @@ sub prepare {
 
     my $vga = PVE::QemuServer::parse_vga($conf->{vga});
     if ($running && $vga->{'clipboard'} && $vga->{'clipboard'} eq 'vnc') {
-        die "VMs with 'clipboard' set to 'vnc' are not live migratable!\n";
+        my $machine_version = PVE::QemuServer::Machine::get_current_qemu_machine($vmid);
+        if (!PVE::QemuServer::Machine::is_machine_version_at_least($machine_version, 10, 1)) {
+            die "VMs with 'clipboard' set to 'vnc' are not live migratable with"
+                . " QEMU/machine versions older than 10.1!\n";
+        }
     }
 
     my $vollist = PVE::QemuServer::get_vm_volumes($conf);
diff --git a/src/PVE/QemuServer.pm b/src/PVE/QemuServer.pm
index 69991843..ecf64fea 100644
--- a/src/PVE/QemuServer.pm
+++ b/src/PVE/QemuServer.pm
@@ -177,8 +177,8 @@ my $vga_fmt = {
     },
     clipboard => {
         description =>
-            'Enable a specific clipboard. If not set, depending on the display type the'
-            . ' SPICE one will be added. Migration with VNC clipboard is not yet supported!',
+            'Enable a specific clipboard. If not set, depending on the display type the SPICE one'
+            . ' will be added. Live migration is not possible with QEMU version < 10.1.',
         type => 'string',
         enum => ['vnc'],
         optional => 1,
-- 
2.47.3



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] [PATCH pve-manager v2 2/3] ui: display: update 'live-migration with VNC-clipboard not working' note

[Markus Frank]

The live-migration feature now works with QEMU 10.1:
5d56bff11e ("ui/vdagent: add migration support")

Signed-off-by: Markus Frank <m.frank@proxmox.com>
---
* update text of hint instead of removing it entirely

 www/manager6/qemu/DisplayEdit.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/www/manager6/qemu/DisplayEdit.js b/www/manager6/qemu/DisplayEdit.js
index a2c28ba7..06404dd8 100644
--- a/www/manager6/qemu/DisplayEdit.js
+++ b/www/manager6/qemu/DisplayEdit.js
@@ -111,7 +111,9 @@ Ext.define('PVE.qemu.DisplayInputPanel', {
             xtype: 'displayfield',
             name: 'vncMigration',
             userCls: 'pmx-hint',
-            value: gettext('You cannot live-migrate while using the VNC clipboard.'),
+            value: gettext(
+                'You cannot live-migrate while using the VNC clipboard with QEMU versions older than 10.1.',
+            ),
             bind: {
                 hidden: '{hideVNCHint}',
             },
-- 
2.47.3



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] [PATCH docs v2 3/3] vnc-clipboard: change 'live-migration not working' note

[Markus Frank]

The live-migration feature now works with QEMU 10.1:
5d56bff11e ("ui/vdagent: add migration support")

Signed-off-by: Markus Frank <m.frank@proxmox.com>
---
v2:
* update live-migration limitation note instead of removing it entirely

 qm.adoc | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/qm.adoc b/qm.adoc
index eb6ab4d..6a46d23 100644
--- a/qm.adoc
+++ b/qm.adoc
@@ -1030,13 +1030,10 @@ SPICE, virtio or virgl, you'll need to choose which clipboard to use.
 This is because the default *SPICE* clipboard will be replaced by the
 *VNC* clipboard, if `clipboard` is set to `vnc`.
 
-// TODO: Change NOTE below when live-migration patch is packaged in pve-qemu:
-// https://lists.gnu.org/archive/html/qemu-devel/2025-05/msg05656.html
 NOTE: In order to enable the VNC clipboard, QEMU is configured to use the
-qemu-vdagent device.
-https://lists.gnu.org/archive/html/qemu-devel/2021-08/msg05393.html[Currently,
-the qemu-vdagent device does not support live migration.] This means that a VM
-with an enabled VNC clipboard cannot be live-migrated at the moment.
+qemu-vdagent device. Live migration support for this device was added with
+QEMU Version 10.1. VMs running on a QEMU or machine version below 10.1
+with an enabled VNC clipboard cannot be live-migrated.
 
 [[qm_usb_passthrough]]
 USB Passthrough
-- 
2.47.3



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

Re: [pve-devel] [PATCH qemu-server v2 1/3] vga: allow live-migration with clipboard

[Dominik Csapak]

2 high level notes (but not blocker):

* would it maybe make sense to pull the 'get_current_qemu_machine' out
   so other parts of the api/code can reuse that?
   i guess we'll maybe have more of such checks in the future, and having
   the version already available at e.g. the top level of the api call
   could make sense. This can ofc also be done when we actually need it

* afaics the checks in QemuMigrate and the api are identical, would
   it make sense to factor them out, so they don't accidentally
   diverge? (Are there maybe even more places where we check this?)

Aside from these (minor) changes consider this:

Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>

On 1/8/26 11:11 AM, Markus Frank wrote:
> The live-migration feature now works with QEMU 10.1:
> 5d56bff11e ("ui/vdagent: add migration support")
> 
> Signed-off-by: Markus Frank <m.frank@proxmox.com>
> ---
> v2:
> * add machine version check to ensure QEMU version is at least 10.1.
> 
>   src/PVE/API2/Qemu.pm   | 4 +++-
>   src/PVE/QemuMigrate.pm | 6 +++++-
>   src/PVE/QemuServer.pm  | 4 ++--
>   3 files changed, 10 insertions(+), 4 deletions(-)
> 
> diff --git a/src/PVE/API2/Qemu.pm b/src/PVE/API2/Qemu.pm
> index 190878de..3ab0afcf 100644
> --- a/src/PVE/API2/Qemu.pm
> +++ b/src/PVE/API2/Qemu.pm
> @@ -5300,7 +5300,9 @@ __PACKAGE__->register_method({
>   
>           my $vga = PVE::QemuServer::parse_vga($vmconf->{vga});
>           if ($res->{running} && $vga->{'clipboard'} && $vga->{'clipboard'} eq 'vnc') {
> -            push $local_resources->@*, "clipboard=vnc";
> +            my $machine_version = PVE::QemuServer::Machine::get_current_qemu_machine($vmid);
> +            push $local_resources->@*, "clipboard=vnc"
> +                if !PVE::QemuServer::Machine::is_machine_version_at_least($machine_version, 10, 1);
>           }
>   
>           $res->{allowed_nodes} = [];
> diff --git a/src/PVE/QemuMigrate.pm b/src/PVE/QemuMigrate.pm
> index b3ddc34e..829288ff 100644
> --- a/src/PVE/QemuMigrate.pm
> +++ b/src/PVE/QemuMigrate.pm
> @@ -301,7 +301,11 @@ sub prepare {
>   
>       my $vga = PVE::QemuServer::parse_vga($conf->{vga});
>       if ($running && $vga->{'clipboard'} && $vga->{'clipboard'} eq 'vnc') {
> -        die "VMs with 'clipboard' set to 'vnc' are not live migratable!\n";
> +        my $machine_version = PVE::QemuServer::Machine::get_current_qemu_machine($vmid);
> +        if (!PVE::QemuServer::Machine::is_machine_version_at_least($machine_version, 10, 1)) {
> +            die "VMs with 'clipboard' set to 'vnc' are not live migratable with"
> +                . " QEMU/machine versions older than 10.1!\n";
> +        }
>       }
>   
>       my $vollist = PVE::QemuServer::get_vm_volumes($conf);
> diff --git a/src/PVE/QemuServer.pm b/src/PVE/QemuServer.pm
> index 69991843..ecf64fea 100644
> --- a/src/PVE/QemuServer.pm
> +++ b/src/PVE/QemuServer.pm
> @@ -177,8 +177,8 @@ my $vga_fmt = {
>       },
>       clipboard => {
>           description =>
> -            'Enable a specific clipboard. If not set, depending on the display type the'
> -            . ' SPICE one will be added. Migration with VNC clipboard is not yet supported!',
> +            'Enable a specific clipboard. If not set, depending on the display type the SPICE one'
> +            . ' will be added. Live migration is not possible with QEMU version < 10.1.',
>           type => 'string',
>           enum => ['vnc'],
>           optional => 1,



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

Re: [pve-devel] [PATCH pve-manager v2 2/3] ui: display: update 'live-migration with VNC-clipboard not working' note

[Dominik Csapak]

Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>

On 1/8/26 11:11 AM, Markus Frank wrote:
> The live-migration feature now works with QEMU 10.1:
> 5d56bff11e ("ui/vdagent: add migration support")
> 
> Signed-off-by: Markus Frank <m.frank@proxmox.com>
> ---
> * update text of hint instead of removing it entirely
> 
>   www/manager6/qemu/DisplayEdit.js | 4 +++-
>   1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/www/manager6/qemu/DisplayEdit.js b/www/manager6/qemu/DisplayEdit.js
> index a2c28ba7..06404dd8 100644
> --- a/www/manager6/qemu/DisplayEdit.js
> +++ b/www/manager6/qemu/DisplayEdit.js
> @@ -111,7 +111,9 @@ Ext.define('PVE.qemu.DisplayInputPanel', {
>               xtype: 'displayfield',
>               name: 'vncMigration',
>               userCls: 'pmx-hint',
> -            value: gettext('You cannot live-migrate while using the VNC clipboard.'),
> +            value: gettext(
> +                'You cannot live-migrate while using the VNC clipboard with QEMU versions older than 10.1.',
> +            ),
>               bind: {
>                   hidden: '{hideVNCHint}',
>               },



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

Re: [pve-devel] [PATCH docs v2 3/3] vnc-clipboard: change 'live-migration not working' note

[Dominik Csapak]

Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>

On 1/8/26 11:11 AM, Markus Frank wrote:
> The live-migration feature now works with QEMU 10.1:
> 5d56bff11e ("ui/vdagent: add migration support")
> 
> Signed-off-by: Markus Frank <m.frank@proxmox.com>
> ---
> v2:
> * update live-migration limitation note instead of removing it entirely
> 
>   qm.adoc | 9 +++------
>   1 file changed, 3 insertions(+), 6 deletions(-)
> 
> diff --git a/qm.adoc b/qm.adoc
> index eb6ab4d..6a46d23 100644
> --- a/qm.adoc
> +++ b/qm.adoc
> @@ -1030,13 +1030,10 @@ SPICE, virtio or virgl, you'll need to choose which clipboard to use.
>   This is because the default *SPICE* clipboard will be replaced by the
>   *VNC* clipboard, if `clipboard` is set to `vnc`.
>   
> -// TODO: Change NOTE below when live-migration patch is packaged in pve-qemu:
> -// https://lists.gnu.org/archive/html/qemu-devel/2025-05/msg05656.html
>   NOTE: In order to enable the VNC clipboard, QEMU is configured to use the
> -qemu-vdagent device.
> -https://lists.gnu.org/archive/html/qemu-devel/2021-08/msg05393.html[Currently,
> -the qemu-vdagent device does not support live migration.] This means that a VM
> -with an enabled VNC clipboard cannot be live-migrated at the moment.
> +qemu-vdagent device. Live migration support for this device was added with
> +QEMU Version 10.1. VMs running on a QEMU or machine version below 10.1
> +with an enabled VNC clipboard cannot be live-migrated.
>   
>   [[qm_usb_passthrough]]
>   USB Passthrough



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] applied: [PATCH qemu-server v2 1/3] vga: allow live-migration with clipboard

[Fiona Ebner]

On Thu, 08 Jan 2026 11:10:09 +0100, Markus Frank wrote:
> The live-migration feature now works with QEMU 10.1:
> 5d56bff11e ("ui/vdagent: add migration support")

Applied, thanks! Since the schema description is about the clipboard
in general, I made it more explicit by mentioning that the restriction
applies only to the VNC clipboard and also mentioned that it's about
the machine version to avoid any potential confusion.

[1/3] vga: allow live-migration with clipboard
      commit: a68b9e3c0f946bee1c47961a9c25b7c3f7fd965f


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

Re: [pve-devel] [PATCH qemu-server v2 1/3] vga: allow live-migration with clipboard

[Fiona Ebner]

Am 08.01.26 um 4:20 PM schrieb Dominik Csapak:
> 2 high level notes (but not blocker):
> 
> * would it maybe make sense to pull the 'get_current_qemu_machine' out
>   so other parts of the api/code can reuse that?
>   i guess we'll maybe have more of such checks in the future, and having
>   the version already available at e.g. the top level of the api call
>   could make sense. This can ofc also be done when we actually need it

Can easily be done when another user shows up.

> * afaics the checks in QemuMigrate and the api are identical, would
>   it make sense to factor them out, so they don't accidentally
>   diverge? (Are there maybe even more places where we check this?)

I didn't see any other places and the check is very unlikely to change
in the future and two times two lines is really not much, so I applied
it as-is with your R-B, thanks!

> Aside from these (minor) changes consider this:
> 
> Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] applied: [PATCH pve-manager v2 2/3] ui: display: update 'live-migration with VNC-clipboard not working' note

[Fiona Ebner]

On Thu, 08 Jan 2026 11:10:10 +0100, Markus Frank wrote:
> The live-migration feature now works with QEMU 10.1:
> 5d56bff11e ("ui/vdagent: add migration support")

Applied, thanks! I changed it to say 'machine version' rather than
'QEMU version' so that users know what to look out for.

[2/3] ui: display: update 'live-migration with VNC-clipboard not working' note
      commit: e2728351b5b1960bb5ce3a13af25c9c91003bdc5


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] applied: [PATCH docs v2 3/3] vnc-clipboard: change 'live-migration not working' note

[Fiona Ebner]

On Thu, 08 Jan 2026 11:10:11 +0100, Markus Frank wrote:
> The live-migration feature now works with QEMU 10.1:
> 5d56bff11e ("ui/vdagent: add migration support")

Applied, thanks!

[3/3] vnc-clipboard: change 'live-migration not working' note
      commit: d99b53853bef59a2cc63eb3369417dbf098dc3e8


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel