From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9]) by lore.proxmox.com (Postfix) with ESMTPS id C7A421FF16B for ; Tue, 29 Jul 2025 17:51:17 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id B91D017996; Tue, 29 Jul 2025 17:52:39 +0200 (CEST) From: Friedrich Weber To: pve-devel@lists.proxmox.com Date: Tue, 29 Jul 2025 17:50:58 +0200 Message-ID: <20250729155227.157120-5-f.weber@proxmox.com> X-Mailer: git-send-email 2.47.2 In-Reply-To: <20250729155227.157120-1-f.weber@proxmox.com> References: <20250729155227.157120-1-f.weber@proxmox.com> MIME-Version: 1.0 X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1753804346291 X-SPAM-LEVEL: Spam detection results: 0 AWL 0.011 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH docs 1/1] pveproxy, pvedaemon: document MAX_WORKERS setting X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox VE development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pve-devel-bounces@lists.proxmox.com Sender: "pve-devel" For pveproxy, add it to the description of settings that can be adjusted in /etc/default/pveproxy. For pvedaemon, this is currently the only setting that can be adjusted in /etc/default/pvedaemon. Signed-off-by: Friedrich Weber --- pvedaemon.adoc | 17 +++++++++++++++++ pveproxy.adoc | 18 ++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/pvedaemon.adoc b/pvedaemon.adoc index 66c751a..d1923a4 100644 --- a/pvedaemon.adoc +++ b/pvedaemon.adoc @@ -30,6 +30,23 @@ NOTE: The daemon listens to a local address only, so you cannot access it from outside. The `pveproxy` daemon exposes the API to the outside world. +[[pvedaemon_max_workers]] +Number of Workers +----------------- + +`pvedaemon` delegates handling of incoming requests to worker processes. By +default, `pvedaemon` spawns 3 worker processes, which is sufficient for most +workloads. For automation-heavy workloads that issue a huge volume of API +requests and that experience slow request handling or timeouts, the number of +worker processes can be increased by setting `MAX_WORKERS` in +`/etc/default/pvedaemon`, for example: + + MAX_WORKERS=5 + +Note that a higher number of worker processes may result in higher CPU usage. +The number of worker processes must be greater than 0 and smaller than 128. + +The same setting exists for xref:pveproxy_max_workers[pveproxy]. ifdef::manvolnum[] include::pve-copyright.adoc[] diff --git a/pveproxy.adoc b/pveproxy.adoc index a311afd..6999b4e 100644 --- a/pveproxy.adoc +++ b/pveproxy.adoc @@ -227,6 +227,24 @@ IP addresses can be specified using any syntax understood by `Net::IP`. The name `all` is an alias for `0/0` and `::/0` (meaning all IPv4 and IPv6 addresses). +[[pveproxy_max_workers]] +Number of Workers +----------------- + +`pveproxy` delegates handling of incoming requests to worker processes. By +default, `pveproxy` spawns 3 worker processes, which is sufficient for most +workloads. For automation-heavy workloads that issue a huge volume of API +requests and that experience slow request handling or timeouts, the number of +worker processes can be increased by setting `MAX_WORKERS` in +`/etc/default/pveproxy`, for example: + + MAX_WORKERS=5 + +Note that a higher number of worker processes may result in higher CPU usage. +The number of worker processes must be greater than 0 and smaller than 128. + +The same setting exists for xref:pvedaemon_max_workers[pvedaemon]. + ifdef::manvolnum[] include::pve-copyright.adoc[] endif::manvolnum[] -- 2.47.2 _______________________________________________ pve-devel mailing list pve-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel