From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id D4C0B71427 for ; Wed, 11 May 2022 16:14:57 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id CB0191D7E4 for ; Wed, 11 May 2022 16:14:57 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id DA3361D7AC for ; Wed, 11 May 2022 16:14:55 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id DED4D433BD for ; Wed, 11 May 2022 16:06:52 +0200 (CEST) From: Stoiko Ivanov To: pbs-devel@lists.proxmox.com Date: Wed, 11 May 2022 14:06:34 +0000 Message-Id: <20220511140635.87279-5-s.ivanov@proxmox.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220511140635.87279-1-s.ivanov@proxmox.com> References: <20220511140635.87279-1-s.ivanov@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.200 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% 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 T_SCC_BODY_TEXT_LINE -0.01 - Subject: [pbs-devel] [PATCH proxmox-backup 4/5] docs: local-zfs: minor cleanup and adaptation X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 11 May 2022 14:14:57 -0000 fixes a few small glitches in the markup. rephrases a few PVEisms (PBS will not swap when starting a backup to an external storage) add zstd to available compression algorithms Signed-off-by: Stoiko Ivanov --- docs/local-zfs.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/local-zfs.rst b/docs/local-zfs.rst index 32af860f..4c4bd387 100644 --- a/docs/local-zfs.rst +++ b/docs/local-zfs.rst @@ -191,12 +191,12 @@ With `systemd-boot`: .. code-block:: console - # pve-efiboot-tool format - # pve-efiboot-tool init + # proxmox-boot-tool format + # proxmox-boot-tool init .. NOTE:: `ESP` stands for EFI System Partition, which is setup as partition #2 on - bootable disks setup by the {pve} installer since version 5.4. For details, see - xref:sysboot_systemd_boot_setup[Setting up a new partition for use as synced ESP]. + bootable disks setup by the `Proxmox Backup`_ installer. For details, see + :ref:`Setting up a new partition for use as synced ESP `. With `grub`: @@ -254,6 +254,7 @@ The above example limits the usage to 8 GiB ('8 * 2^30^'). configuration in `/etc/modprobe.d/zfs.conf`, with: .. code-block:: console + options zfs zfs_arc_min=8589934591 options zfs zfs_arc_max=8589934592 @@ -273,8 +274,7 @@ Swap on ZFS ^^^^^^^^^^^ Swap-space created on a zvol may cause some issues, such as blocking the -server or generating a high IO load, often seen when starting a Backup -to an external Storage. +server or generating a high IO load. We strongly recommend using enough memory, so that you normally do not run into low memory situations. Should you need or want to add swap, it is @@ -311,18 +311,20 @@ ZFS compression ^^^^^^^^^^^^^^^ To activate compression: + .. code-block:: console # zpool set compression=lz4 We recommend using the `lz4` algorithm, since it adds very little CPU overhead. -Other algorithms such as `lzjb` and `gzip-N` (where `N` is an integer from `1-9` +Other algorithms such as `lzjb`, `zstd` and `gzip-N` (where `N` is an integer from `1-9` representing the compression ratio, where 1 is fastest and 9 is best compression) are also available. Depending on the algorithm and how compressible the data is, having compression enabled can even increase I/O performance. You can disable compression at any time with: + .. code-block:: console # zfs set compression=off -- 2.30.2