proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-04-30 01:15:02 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Use consistent style for all shell commands

Browse Source 
Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>
This commit is contained in:
Fabian Ebner 2020-01-16 13:15:45 +01:00 committed by Thomas Lamprecht
parent e06707f2d1
commit eaefe61423
1 changed files with 61 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

84
local-zfs.adoc
View File

@ -178,41 +178,55 @@ To create a new pool, at least one disk is needed. The `ashift` should
have the same sector-size (2 power of `ashift`) or larger as the have the same sector-size (2 power of `ashift`) or larger as the
underlying disk. underlying disk.
zpool create -f -o ashift=12 <pool> <device> ----
# zpool create -f -o ashift=12 <pool> <device>
----
To activate compression (see section <<zfs_compression,Compression in ZFS>>): To activate compression (see section <<zfs_compression,Compression in ZFS>>):
zfs set compression=lz4 <pool> ----
# zfs set compression=lz4 <pool>
----
.Create a new pool with RAID-0 .Create a new pool with RAID-0
Minimum 1 Disk Minimum 1 Disk
zpool create -f -o ashift=12 <pool> <device1> <device2> ----
# zpool create -f -o ashift=12 <pool> <device1> <device2>
----
.Create a new pool with RAID-1 .Create a new pool with RAID-1
Minimum 2 Disks Minimum 2 Disks
zpool create -f -o ashift=12 <pool> mirror <device1> <device2> ----
# zpool create -f -o ashift=12 <pool> mirror <device1> <device2>
----
.Create a new pool with RAID-10 .Create a new pool with RAID-10
Minimum 4 Disks Minimum 4 Disks
zpool create -f -o ashift=12 <pool> mirror <device1> <device2> mirror <device3> <device4> ----
# zpool create -f -o ashift=12 <pool> mirror <device1> <device2> mirror <device3> <device4>
----
.Create a new pool with RAIDZ-1 .Create a new pool with RAIDZ-1
Minimum 3 Disks Minimum 3 Disks
zpool create -f -o ashift=12 <pool> raidz1 <device1> <device2> <device3> ----
# zpool create -f -o ashift=12 <pool> raidz1 <device1> <device2> <device3>
----
.Create a new pool with RAIDZ-2 .Create a new pool with RAIDZ-2
Minimum 4 Disks Minimum 4 Disks
zpool create -f -o ashift=12 <pool> raidz2 <device1> <device2> <device3> <device4> ----
# zpool create -f -o ashift=12 <pool> raidz2 <device1> <device2> <device3> <device4>
----
.Create a new pool with cache (L2ARC) .Create a new pool with cache (L2ARC)
@ -222,7 +236,9 @@ the performance (use SSD).
As `<device>` it is possible to use more devices, like it's shown in As `<device>` it is possible to use more devices, like it's shown in
"Create a new pool with RAID*". "Create a new pool with RAID*".
zpool create -f -o ashift=12 <pool> <device> cache <cache_device> ----
# zpool create -f -o ashift=12 <pool> <device> cache <cache_device>
----
.Create a new pool with log (ZIL) .Create a new pool with log (ZIL)
@ -232,7 +248,9 @@ the performance(SSD).
As `<device>` it is possible to use more devices, like it's shown in As `<device>` it is possible to use more devices, like it's shown in
"Create a new pool with RAID*". "Create a new pool with RAID*".
zpool create -f -o ashift=12 <pool> <device> log <log_device> ----
# zpool create -f -o ashift=12 <pool> <device> log <log_device>
----
.Add cache and log to an existing pool .Add cache and log to an existing pool
@ -245,19 +263,25 @@ 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 physical memory, so this is usually quite small. The rest of the SSD
can be used as cache. can be used as cache.
zpool add -f <pool> log <device-part1> cache <device-part2> ----
# zpool add -f <pool> log <device-part1> cache <device-part2>
----
.Changing a failed device .Changing a failed device
zpool replace -f <pool> <old device> <new device> ----
# zpool replace -f <pool> <old device> <new device>
----
.Changing a failed bootable device when using systemd-boot .Changing a failed bootable device when using systemd-boot
sgdisk <healthy bootable device> -R <new device> ----
sgdisk -G <new device> # sgdisk <healthy bootable device> -R <new device>
zpool replace -f <pool> <old zfs partition> <new zfs partition> # sgdisk -G <new device>
pve-efiboot-tool format <new disk's ESP> # zpool replace -f <pool> <old zfs partition> <new zfs partition>
pve-efiboot-tool init <new disk's ESP> # pve-efiboot-tool format <new disk's ESP>
# pve-efiboot-tool init <new disk's 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 {pve} installer since version 5.4. For details, see
@ -309,7 +333,9 @@ This example setting limits the usage to 8GB.
If your root file system is ZFS you must update your initramfs every If your root file system is ZFS you must update your initramfs every
time this value changes: time this value changes:
update-initramfs -u ----
# update-initramfs -u
----
==== ====
@ -328,7 +354,9 @@ You can leave some space free for this purpose in the advanced options of the
installer. Additionally, you can lower the installer. Additionally, you can lower the
``swappiness'' value. A good value for servers is 10: ``swappiness'' value. A good value for servers is 10:
sysctl -w vm.swappiness=10 ----
# sysctl -w vm.swappiness=10
----
To make the swappiness persistent, open `/etc/sysctl.conf` with To make the swappiness persistent, open `/etc/sysctl.conf` with
an editor of your choice and add the following line: an editor of your choice and add the following line:
@ -483,11 +511,15 @@ WARNING: Adding a `special` device to a pool cannot be undone!
.Create a pool with `special` device and RAID-1: .Create a pool with `special` device and RAID-1:
zpool create -f -o ashift=12 <pool> mirror <device1> <device2> special mirror <device3> <device4> ----
# zpool create -f -o ashift=12 <pool> mirror <device1> <device2> special mirror <device3> <device4>
----
.Add a `special` device to an existing pool with RAID-1: .Add a `special` device to an existing pool with RAID-1:
zpool add <pool> special mirror <device1> <device2> ----
# zpool add <pool> special mirror <device1> <device2>
----
ZFS datasets expose the `special_small_blocks=<size>` property. `size` can be ZFS datasets expose the `special_small_blocks=<size>` property. `size` can be
`0` to disable storing small file blocks on the `special` device or a power of `0` to disable storing small file blocks on the `special` device or a power of
@ -504,12 +536,18 @@ in the pool will opt in for small file blocks).
.Opt in for all file smaller than 4K-blocks pool-wide: .Opt in for all file smaller than 4K-blocks pool-wide:
zfs set special_small_blocks=4K <pool> ----
# zfs set special_small_blocks=4K <pool>
----
.Opt in for small file blocks for a single dataset: .Opt in for small file blocks for a single dataset:
zfs set special_small_blocks=4K <pool>/<filesystem> ----
# zfs set special_small_blocks=4K <pool>/<filesystem>
----
.Opt out from small file blocks for a single dataset: .Opt out from small file blocks for a single dataset:
zfs set special_small_blocks=0 <pool>/<filesystem> ----
# zfs set special_small_blocks=0 <pool>/<filesystem>
----