-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.Debian
85 lines (60 loc) · 3.22 KB
/
README.Debian
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
zfs-linux for Debian
====================
1. Feature flags are enabled by default.
----------------------------------------
This means that ZoL will now create pools in a way that is
incompatible with Solaris. If you need Solaris compatibility,
then create pools like this:
# zpool create -o version=28 tank ...
ZoL remains compatible with all other ZFS implementations derived
from Illumos.
-- Aron Xu <aron@debian.org> Sat, 3 Aug 2013 03:23:11 +0800
2. Use zfs-initramfs with caution.
----------------------------------
Debian Installer does not support root installation because zfs udeb
modules are not built in-tree with the linux kernel, and zfs-initramfs
is included here for people interested to setup ZFS as rootfs manually.
Since faulty operation on filesystem can lead to major loss of data,
please use zfs-initramfs with caution.
-- Aron Xu <aron@debian.org> Sat, 3 Aug 2013 03:23:11 +0800
3. Per-zpool config for the periodic-{scrub,trim} cron jobs is supported.
-------------------------------------------------------------------------
Starting with 2.0.3-3, the auto-scrub and auto-trim cron jobs will use the
"org.debian:periodic-{scrub,trim}" user properties on the pool's root dataset
to determine if they should do anything; accepted values are:
* "auto" ‒ same as unset, use default checks
* "enable" ‒ always scrub/trim automatically
* "disable" ‒ never scrub/trim automatically
[ Periodic Scrubbing ]
Scrubbing storage pool data is a routine maintenance operation that check all
data against known checksums, and fix early problems like bit riots. This
operation is scheduled with low priority in the background, and usually does
not have big impact on performance when the pool is not heavily utilized.
If you would like to scrub all pools periodically, no operation is required
as periodic scrub is already the default behavior. Or if you want to
make it explicit for a zpool named "tank":
# zfs set org.debian:periodic-scrub=auto tank
By default scrub jobs are scheduled on every second Sunday of month.
[ Periodic Trimming ]
Some SSD devices require proper scheduling of TRIM commands to maintain best
performance. Currently the auto-trim will only trim if the zpool consists of
/only/ NVMe drives, since some SATA 2 and SATA 3.0 SSDs will hang or crash
during large TRIMs (See #983086). If your zpools with SATA SSDs had no
problems trimming before, you will need to run the following command to
restore the previous behaviour (always trim a pool):
# zfs set org.debian:periodic-trim=enable sata-pool
TRIM jobs are scheduled on every first Sunday of month by default.
4. Setting name of home datatset other than default rpool/home
-------------------------------------------------------------------------
libpam-zfs assumes that the location of home directories follows the
advice in the root-on-zfs HOWTO which places them in rpool/home. To
change this, add the following option to the end of the line in each of:
/etc/pam.d/common-auth
/etc/pam.d/common-password
/etc/pam.d/common-session
for example, from common-auth:
from:
# auth optional pam_zfs_key.so
to:
# auth optional pam_zfs_key.so homes=homepool/home
-- Mo Zhou <lumin@debian.org> Fri, 2 Apr 2021 12:23:00 +0000