From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) by lore.proxmox.com (Postfix) with ESMTPS id 54C8C1FF145 for ; Thu, 22 Jan 2026 12:21:36 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id A2BC21432D; Thu, 22 Jan 2026 12:21:54 +0100 (CET) From: Manuel Federanko To: pdm-devel@lists.proxmox.com Date: Thu, 22 Jan 2026 12:21:03 +0100 Message-ID: <20260122112106.118611-2-m.federanko@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260122112106.118611-1-m.federanko@proxmox.com> References: <20260122112106.118611-1-m.federanko@proxmox.com> MIME-Version: 1.0 X-SPAM-LEVEL: Spam detection results: 0 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 KAM_LAZY_DOMAIN_SECURITY 1 Sending domain does not have any anti-forgery methods RDNS_NONE 0.793 Delivered to internal network by a host with no rDNS SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_NONE 0.001 SPF: sender does not publish an SPF Record Subject: [pdm-devel] [PATCH datacenter-manager 1/3] docs: fix formatting of local-zfs documentation. X-BeenThere: pdm-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Datacenter Manager development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox Datacenter Manager development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pdm-devel-bounces@lists.proxmox.com Sender: "pdm-devel" Signed-off-by: Manuel Federanko --- docs/local-zfs.rst | 43 ++++++++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 19 deletions(-) diff --git a/docs/local-zfs.rst b/docs/local-zfs.rst index 37682f9..38abc4e 100644 --- a/docs/local-zfs.rst +++ b/docs/local-zfs.rst @@ -146,19 +146,21 @@ or `gdisk` The maximum size of a log device should be about half the size of physical memory, so this is usually quite small. The rest of the SSD can be used as cache. - .. code-block:: console +.. code-block:: console -# zpool add -f log cache + # zpool add -f log cache -Changing a failed device ^^^^^^^^^^^^^^^^^^^^^^^^ +Changing a failed device +^^^^^^^^^^^^^^^^^^^^^^^^ - .. code-block:: console +.. code-block:: console -# zpool replace -f + # zpool replace -f -Changing a failed bootable device ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Changing a failed bootable device +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Depending on how `Proxmox Datacenter Manager`_ was installed, it is either using `grub` or `systemd-boot` as a bootloader. @@ -167,21 +169,22 @@ In either case, the first steps of copying the partition table, reissuing GUIDs ZFS partition are the same. To make the system bootable from the new disk, different steps are needed which depend on the bootloader in use. - .. code-block:: console +.. code-block:: console -# sgdisk -R # sgdisk -G # zpool replace -f - + # sgdisk -R + # sgdisk -G + # zpool replace -f - .. NOTE:: Use the `zpool status -v` command to monitor how far the resilvering process of the new +.. NOTE:: Use the `zpool status -v` command to monitor how far the resilvering process of the new disk has progressed. With `systemd-boot`: - .. code-block:: console +.. code-block:: console -# proxmox-boot-tool format # proxmox-boot-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 +.. NOTE:: `ESP` stands for EFI System Partition, which is setup as partition #2 on bootable disks setup by the Proxmox Datacenter Manager installer. For details, see :ref:`Setting up a new partition for use as synced ESP `. @@ -189,12 +192,13 @@ With `grub`: Usually `grub.cfg` is located in `/boot/grub/grub.cfg` - .. code-block:: console +.. code-block:: console -# grub-install # grub-mkconfig -o /path/to/grub.cfg + # grub-install # grub-mkconfig -o /path/to/grub.cfg -Activate e-mail notification ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Activate e-mail notification +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ZFS comes with an event daemon, ``ZED``, which monitors events generated by the ZFS kernel module. The daemon can also send emails upon ZFS events, such as pool errors. Newer ZFS packages ship the @@ -205,15 +209,16 @@ You can configure the daemon via the file ``/etc/zfs/zed.d/zed.rc``, using your The required setting for email notification is ``ZED_EMAIL_ADDR``, which is set to ``root`` by default. - .. code-block:: console +.. code-block:: console -ZED_EMAIL_ADDR="root" + ZED_EMAIL_ADDR="root" Please note that Proxmox Datacenter Manager forwards mails to `root` to the email address configured for the root user. -Limit ZFS memory usage ^^^^^^^^^^^^^^^^^^^^^^ +Limit ZFS memory usage +^^^^^^^^^^^^^^^^^^^^^^ It is good to use at most 50 percent (which is the default) of the system memory for ZFS ARC, to prevent performance degradation of the host. Use your preferred editor to change the configuration -- 2.47.3 _______________________________________________ pdm-devel mailing list pdm-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pdm-devel