projects / mirror_zfs.git / blame
| Commit | Line | Data |
|---|---|---|
| 2a34db1b TF |
1 | DESCRIPTION |
| 2 | These script were written with the primary intention of being portable and | |
| 3 | usable on as many systems as possible. | |
| 4 | ||
| 5 | This is, in practice, usually not possible. But the intention is there. | |
| 6 | And it is a good one. | |
| 7 | ||
| 8 | They have been tested successfully on: | |
| 9 | ||
| 162cc80b | 10 | * Debian GNU/Linux Bookworm |
| 2a34db1b TF |
11 | * Gentoo |
| 12 | ||
| 13 | SUPPORT | |
| 14 | If you find that they don't work for your platform, please report this | |
| d0249a4b | 15 | at the OpenZFS issue tracker at https://github.com/openzfs/zfs/issues. |
| 2a34db1b TF |
16 | |
| 17 | Please include: | |
| 18 | ||
| 19 | * Distribution name | |
| 20 | * Distribution version | |
| 21 | * Where to find an install CD image | |
| 22 | * Architecture | |
| 23 | ||
| 24 | If you have code to share that fixes the problem, that is much better. | |
| 25 | But please remember to try your best keep portability in mind. If you | |
| 26 | suspect that what you're writing/modifying won't work on anything else | |
| 27 | than your distribution, please make sure to put that code in appropriate | |
| 28 | if/else/fi code. | |
| 29 | ||
| 30 | It currently MUST be bash (or fully compatible) for this to work. | |
| 31 | ||
| 32 | If you're making your own distribution and you want the scripts to | |
| 33 | work on that, the biggest problem you'll (probably) have is the part | |
| 5ecbb293 | 34 | at the beginning of the "zfs-functions" file which sets up the |
| 2a34db1b TF |
35 | logging output. |
| 36 | ||
| 37 | INSTALLING INIT SCRIPT LINKS | |
| 38 | To setup the init script links in /etc/rc?.d manually on a Debian GNU/Linux | |
| 39 | (or derived) system, run the following commands (the order is important!): | |
| 40 | ||
| f04b9762 BN |
41 | update-rc.d zfs-import start 07 S . stop 07 0 1 6 . |
| 42 | update-rc.d zfs-load-key start 02 2 3 4 5 . stop 06 0 1 6 . | |
| 5e7a2f46 | 43 | update-rc.d zfs-mount start 02 S . stop 06 0 1 6 . |
| f04b9762 BN |
44 | update-rc.d zfs-zed start 07 2 3 4 5 . stop 08 0 1 6 . |
| 45 | update-rc.d zfs-share start 27 2 3 4 5 . stop 05 0 1 6 . | |
| 2a34db1b TF |
46 | |
| 47 | To do the same on RedHat, Fedora and/or CentOS: | |
| 48 | ||
| 2a34db1b | 49 | chkconfig zfs-import |
| f04b9762 | 50 | chkconfig zfs-load-key |
| 2a34db1b | 51 | chkconfig zfs-mount |
| 3f1cc17c | 52 | chkconfig zfs-zed |
| 2a34db1b TF |
53 | chkconfig zfs-share |
| 54 | ||
| 55 | On Gentoo: | |
| 56 | ||
| 2a34db1b | 57 | rc-update add zfs-import boot |
| f04b9762 | 58 | rc-update add zfs-load-key boot |
| 2a34db1b | 59 | rc-update add zfs-mount boot |
| 3f1cc17c | 60 | rc-update add zfs-zed default |
| 2a34db1b TF |
61 | rc-update add zfs-share default |
| 62 | ||
| 3f1cc17c JL |
63 | The idea here is to make sure all of the ZFS filesystems, including possibly |
| 64 | separate datasets like /var, are mounted before anything else is started. | |
| 2a34db1b | 65 | |
| 3f1cc17c JL |
66 | Then, ZED, which depends on /var, can be started. It will consume and act |
| 67 | on events that occurred before it started. ZED may also play a role in | |
| 68 | sharing filesystems in the future, so it is important to start before the | |
| 69 | 'share' service. | |
| 2a34db1b | 70 | |
| 3f1cc17c | 71 | Finally, we share filesystems configured with the share\* property. |