tyler/proxmox-backup
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: local-zfs: minor cleanup and adaptation

Browse Source 
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>
This commit is contained in:
Stoiko Ivanov 2022-05-11 14:06:34 +00:00 committed by Thomas Lamprecht
parent 09d903034f
commit 0ae5f76277
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
docs/local-zfs.rst
View File

@ -191,12 +191,12 @@ With `systemd-boot`:
.. code-block:: console .. code-block:: console
# pve-efiboot-tool format <new disk's ESP> # proxmox-boot-tool format <new ESP>
# pve-efiboot-tool init <new disk's ESP> # proxmox-boot-tool init <new ESP>
.. NOTE:: `ESP` stands for EFI System Partition, which is setup as partition #2 on .. 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 bootable disks setup by the `Proxmox Backup`_ installer. For details, see
xref:sysboot_systemd_boot_setup[Setting up a new partition for use as synced ESP]. :ref:`Setting up a new partition for use as synced ESP <systembooting-proxmox-boot-setup>`.
With `grub`: 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: configuration in `/etc/modprobe.d/zfs.conf`, with:
.. code-block:: console .. code-block:: console
options zfs zfs_arc_min=8589934591 options zfs zfs_arc_min=8589934591
options zfs zfs_arc_max=8589934592 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 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 server or generating a high IO load.
to an external Storage.
We strongly recommend using enough memory, so that you normally do not 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 run into low memory situations. Should you need or want to add swap, it is
@ -311,18 +311,20 @@ ZFS compression
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^
To activate compression: To activate compression:
.. code-block:: console .. code-block:: console
# zpool set compression=lz4 <pool> # zpool set compression=lz4 <pool>
We recommend using the `lz4` algorithm, since it adds very little CPU overhead. 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 representing the compression ratio, where 1 is fastest and 9 is best
compression) are also available. Depending on the algorithm and how compression) are also available. Depending on the algorithm and how
compressible the data is, having compression enabled can even increase I/O compressible the data is, having compression enabled can even increase I/O
performance. performance.
You can disable compression at any time with: You can disable compression at any time with:
.. code-block:: console .. code-block:: console
# zfs set compression=off <dataset> # zfs set compression=off <dataset>