From: Erik Fastermann <e.fastermann@proxmox.com>
To: pve-devel@lists.proxmox.com
Cc: Erik Fastermann <e.fastermann@proxmox.com>
Subject: [PATCH pve-manager v2 2/3] partially fix #1989: ui: qemu: disk: add qcow2 cache size config
Date: Mon, 20 Jul 2026 11:46:37 +0200 [thread overview]
Message-ID: <20260720094638.113056-3-e.fastermann@proxmox.com> (raw)
In-Reply-To: <20260720094638.113056-1-e.fastermann@proxmox.com>
Add the option to control the size of the qcow2 cache in the vm disk
create and edit dialogs. This can provide significant performance gains
in some vm configurations.
For a detailed explanation see the QEMU docs [0]. Currently only the
cache-size is configurable in the frontend, either directly or based on
the size of the disk.
[0] https://gitlab.com/qemu-project/qemu/-/blob/master/docs/qcow2-cache.txt
Signed-off-by: Erik Fastermann <e.fastermann@proxmox.com>
---
changes since v1:
* simplified qcow2CacheSizeBasedOnDisk usage by binding the value
(sadly the workaround for isQcow2 is still required)
* added tooltips for the qcow2 cache options
www/manager6/Parser.js | 2 +-
www/manager6/qemu/HDEdit.js | 73 +++++++++++++++++++++++++++++++++++++
2 files changed, 74 insertions(+), 1 deletion(-)
diff --git a/www/manager6/Parser.js b/www/manager6/Parser.js
index 36df8e9d..f8d2bdad 100644
--- a/www/manager6/Parser.js
+++ b/www/manager6/Parser.js
@@ -207,7 +207,7 @@ Ext.define('PVE.Parser', {
if (!p || p.match(/^\s*$/)) {
return undefined; // continue
}
- let match = p.match(/^([a-z_]+)=(\S+)$/);
+ let match = p.match(/^([0-9a-z-]+)=(\S+)$/);
if (!match) {
if (!p.match(/[=]/)) {
res.file = p;
diff --git a/www/manager6/qemu/HDEdit.js b/www/manager6/qemu/HDEdit.js
index 1bb2bfda..fafa0f55 100644
--- a/www/manager6/qemu/HDEdit.js
+++ b/www/manager6/qemu/HDEdit.js
@@ -18,6 +18,8 @@ Ext.define('PVE.qemu.HDInputPanel', {
isSCSI: false,
isVirtIO: false,
isSCSISingle: false,
+ isQcow2: false,
+ qcow2CacheSizeBasedOnDisk: false,
},
},
@@ -54,6 +56,15 @@ Ext.define('PVE.qemu.HDInputPanel', {
vm.set('isSCSISingle', value === 'virtio-scsi-single');
},
},
+ 'field[name=diskformat]': {
+ change: 'onDiskFormatChange',
+ // afterrender is needed for setting the initial value
+ afterrender: 'onDiskFormatChange',
+ },
+ },
+
+ onDiskFormatChange: function (field) {
+ this.getViewModel().set('isQcow2', field.getValue() === 'qcow2');
},
init: function (view) {
@@ -88,6 +99,20 @@ Ext.define('PVE.qemu.HDInputPanel', {
me.drive.format = values.diskformat;
}
+ if (me.drive?.format === 'qcow2' || me.drive?.file?.endsWith('.qcow2')) {
+ if (values.qcow2CacheSize) {
+ me.drive['qcow2-cache-size'] = values.qcow2CacheSize;
+ } else {
+ delete me.drive['qcow2-cache-size'];
+ }
+ }
+
+ PVE.Utils.propertyStringSet(
+ me.drive,
+ values.qcow2CacheSizeBasedOnDisk,
+ 'qcow2-cache-size-based-on-disk',
+ );
+
PVE.Utils.propertyStringSet(me.drive, !values.backup, 'backup', '0');
PVE.Utils.propertyStringSet(me.drive, values.noreplicate, 'replicate', 'no');
PVE.Utils.propertyStringSet(me.drive, values.discard, 'discard', 'on');
@@ -156,6 +181,8 @@ Ext.define('PVE.qemu.HDInputPanel', {
values.iothread = PVE.Parser.parseBoolean(drive.iothread);
values.readOnly = PVE.Parser.parseBoolean(drive.ro);
values.aio = drive.aio || '__default__';
+ values.qcow2CacheSizeBasedOnDisk = drive['qcow2-cache-size-based-on-disk'];
+ values.qcow2CacheSize = drive['qcow2-cache-size'];
values.mbps_rd = drive.mbps_rd;
values.mbps_wr = drive.mbps_wr;
@@ -167,6 +194,11 @@ Ext.define('PVE.qemu.HDInputPanel', {
values.iops_wr_max = drive.iops_wr_max;
me.setValues(values);
+
+ me.getViewModel().set(
+ 'isQcow2',
+ values.diskformat === 'qcow2' || values.hdimage?.endsWith('.qcow2'),
+ );
},
setNodename: function (nodename) {
@@ -355,6 +387,47 @@ Ext.define('PVE.qemu.HDInputPanel', {
disabled: '{!isVirtIO && !isSCSI}',
},
},
+ {
+ xtype: 'numberfield',
+ name: 'qcow2CacheSize',
+ minValue: 1,
+ fieldLabel: gettext('qcow2 cache') + ' (MiB)',
+ emptyText: gettext('Default cache size'),
+ autoEl: {
+ tag: 'div',
+ 'data-qtip': gettext(
+ 'Total size of the qcow2 cache in MiB. A larger cache can' +
+ ' improve I/O performance on large images. Leave empty to' +
+ ' use the QEMU default (32 MiB L2 cache and 256 KiB' +
+ ' refcount cache with the default disk settings).',
+ ),
+ },
+ bind: {
+ disabled: '{!isQcow2 || qcow2CacheSizeBasedOnDisk}',
+ },
+ listeners: {
+ disable: (field) => field.setValue(null),
+ },
+ },
+ {
+ xtype: 'proxmoxcheckbox',
+ name: 'qcow2CacheSizeBasedOnDisk',
+ defaultValue: 0,
+ fieldLabel: gettext('qcow2 cache based on disk'),
+ clearOnDisable: true,
+ autoEl: {
+ tag: 'div',
+ 'data-qtip': gettext(
+ 'Automatically size the qcow2 cache to cover the whole disk.' +
+ ' Uses roughly 160 KiB of memory per GiB of disk with' +
+ ' the default disk settings.',
+ ),
+ },
+ bind: {
+ value: '{qcow2CacheSizeBasedOnDisk}',
+ disabled: '{!isQcow2}',
+ },
+ },
);
advancedColumn2.push(
--
2.47.3
next prev parent reply other threads:[~2026-07-20 9:47 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-20 9:46 [PATCH docs/manager/qemu-server v2 0/3] partially fix #1989: add QEMU qcow2 cache options Erik Fastermann
2026-07-20 9:46 ` [PATCH qemu-server v2 1/3] partially fix #1989: disk: add " Erik Fastermann
2026-07-20 9:46 ` Erik Fastermann [this message]
2026-07-20 9:46 ` [PATCH pve-docs v2 3/3] partially fix #1989: qm: document qcow2 cache size config Erik Fastermann
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260720094638.113056-3-e.fastermann@proxmox.com \
--to=e.fastermann@proxmox.com \
--cc=pve-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.