From: Stoiko Ivanov <s.ivanov@proxmox.com>
To: pbs-devel@lists.proxmox.com
Subject: [pbs-devel] [PATCH proxmox-backup 4/5] docs: local-zfs: minor cleanup and adaptation
Date: Wed, 11 May 2022 14:06:34 +0000 [thread overview]
Message-ID: <20220511140635.87279-5-s.ivanov@proxmox.com> (raw)
In-Reply-To: <20220511140635.87279-1-s.ivanov@proxmox.com>
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 <s.ivanov@proxmox.com>
---
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 <new disk's ESP>
- # pve-efiboot-tool init <new disk's ESP>
+ # proxmox-boot-tool format <new ESP>
+ # proxmox-boot-tool init <new ESP>
.. 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 <systembooting-proxmox-boot-setup>`.
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 <pool>
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 <dataset>
--
2.30.2
next prev parent reply other threads:[~2022-05-11 14:14 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-05-11 14:06 [pbs-devel] [PATCH proxmox-backup 0/5] update and improve sysadmin documenation Stoiko Ivanov
2022-05-11 14:06 ` [pbs-devel] [PATCH proxmox-backup 1/5] docs: sysadmin: adapt kernel-specifics for PBS Stoiko Ivanov
2022-05-11 14:06 ` [pbs-devel] [PATCH proxmox-backup 2/5] docs: add system-booting from pve-docs Stoiko Ivanov
2022-05-11 14:06 ` [pbs-devel] [PATCH proxmox-backup 3/5] docs: system-booting: (re)add screenshots Stoiko Ivanov
2022-05-11 14:06 ` Stoiko Ivanov [this message]
2022-05-11 14:06 ` [pbs-devel] [PATCH proxmox-backup 5/5] docs: zfs: update documentation about ZED Stoiko Ivanov
2022-05-12 8:14 ` [pbs-devel] applied-series: [PATCH proxmox-backup 0/5] update and improve sysadmin documenation Thomas Lamprecht
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=20220511140635.87279-5-s.ivanov@proxmox.com \
--to=s.ivanov@proxmox.com \
--cc=pbs-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.