diff --git a/docs/Getting Started/Arch Linux/Root on ZFS/6-recovery.rst b/docs/Getting Started/Arch Linux/Root on ZFS/6-recovery.rst index 84fbb1b..8d184ac 100644 --- a/docs/Getting Started/Arch Linux/Root on ZFS/6-recovery.rst +++ b/docs/Getting Started/Arch Linux/Root on ZFS/6-recovery.rst @@ -28,7 +28,7 @@ This section is also applicable if you are in Boot computer from the rescue media. Both legacy and EFI mode are supported. - Or `download generated GRUB rescue image `__. + Or `download generated GRUB rescue image `__. #. List available disks with ``ls`` command:: diff --git a/docs/Getting Started/Fedora/Root on ZFS/6-recovery.rst b/docs/Getting Started/Fedora/Root on ZFS/6-recovery.rst index fa17155..1dad98b 100644 --- a/docs/Getting Started/Fedora/Root on ZFS/6-recovery.rst +++ b/docs/Getting Started/Fedora/Root on ZFS/6-recovery.rst @@ -28,7 +28,7 @@ This section is also applicable if you are in Boot computer from the rescue media. Both legacy and EFI mode are supported. - Or `download generated GRUB rescue image `__. + Or `download generated GRUB rescue image `__. #. List available disks with ``ls`` command:: diff --git a/docs/Getting Started/NixOS/Root on ZFS/1-preparation.rst b/docs/Getting Started/NixOS/Root on ZFS/1-preparation.rst index 515464e..f8dbfc1 100644 --- a/docs/Getting Started/NixOS/Root on ZFS/1-preparation.rst +++ b/docs/Getting Started/NixOS/Root on ZFS/1-preparation.rst @@ -7,7 +7,7 @@ Preparation :local: #. Download `Minimal ISO image - `__ and boot from it. + `__ and boot from it. #. Connect to network. See `NixOS manual `__. diff --git a/docs/Getting Started/NixOS/Root on ZFS/2-system-configuration.rst b/docs/Getting Started/NixOS/Root on ZFS/2-system-configuration.rst index c647a04..844f8c2 100644 --- a/docs/Getting Started/NixOS/Root on ZFS/2-system-configuration.rst +++ b/docs/Getting Started/NixOS/Root on ZFS/2-system-configuration.rst @@ -310,10 +310,12 @@ System Configuration tee -a /mnt/etc/nixos/${INST_CONFIG_FILE} <`__ section if no optional configuration is needed. +Mail notification for ZFS status +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For headless applications such as NAS, it is useful to set up mail notification +for hardware changes and monitor for scrub results. + +#. Set up an alias for root account:: + + tee -a /state/etc/aliases <`__. - Complete the installation by executing:: - - nixos-enter --root /mnt -- nixos-rebuild boot - System installation ~~~~~~~~~~~~~~~~~~~ @@ -78,6 +67,16 @@ System installation nixos-install -v --show-trace --no-root-passwd --root /mnt +#. If boot pool encryption is used and installation fails with:: + + #mktemp: failed to create directory via template + #‘/mnt/tmp.coRUoqzl1P/initrd-secrets.XXXXXXXXXX’: No such file or directory + #failed to create initrd secrets: No such file or directory + + This is `a bug `__. + Complete the installation by executing:: + + nixos-enter --root /mnt -- nixos-rebuild boot Finish installation ~~~~~~~~~~~~~~~~~~~~ @@ -100,6 +99,44 @@ Finish installation reboot +Upgrade NixOS +~~~~~~~~~~~~~ + +Routine updates within the same major version +============================================= + +Updates within the same major version, such as from [21.11].001 to +[21.11].100, can be done with one of the following commands:: + + # take immediate effect + nixos-rebuild --upgrade switch + + # update upon reboot + nixos-rebuild --upgrade boot + +Upgrade to a newer major version +================================ + +Upgrading to a newer major version involves switching software +distribution channel. + +#. To view existing channels, run as root:: + + nix-channel --list + #nixos https://nixos.org/channels/nixos-21.11 + + #this is the major version released around November 2021 + +#. To view available channels:: + + w3m https://hydra.nixos.org/project/nixos + +#. To switch to a newer channel (22.05):: + + nix-channel --add nixos https://nixos.org/channels/nixos-22.05 + +#. Then follow the procedures for updating witin minor versions. + Immutable root file system ~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/Getting Started/NixOS/Root on ZFS/6-recovery.rst b/docs/Getting Started/NixOS/Root on ZFS/6-recovery.rst index dc172b2..03fa1e9 100644 --- a/docs/Getting Started/NixOS/Root on ZFS/6-recovery.rst +++ b/docs/Getting Started/NixOS/Root on ZFS/6-recovery.rst @@ -28,7 +28,7 @@ This section is also applicable if you are in Boot computer from the rescue media. Both legacy and EFI mode are supported. - Or `download generated GRUB rescue image `__. + Or `download generated GRUB rescue image `__. #. List available disks with ``ls`` command:: diff --git a/docs/Getting Started/RHEL-based distro/RHEL 8-based distro Root on ZFS/6-recovery.rst b/docs/Getting Started/RHEL-based distro/RHEL 8-based distro Root on ZFS/6-recovery.rst index fa17155..1dad98b 100644 --- a/docs/Getting Started/RHEL-based distro/RHEL 8-based distro Root on ZFS/6-recovery.rst +++ b/docs/Getting Started/RHEL-based distro/RHEL 8-based distro Root on ZFS/6-recovery.rst @@ -28,7 +28,7 @@ This section is also applicable if you are in Boot computer from the rescue media. Both legacy and EFI mode are supported. - Or `download generated GRUB rescue image `__. + Or `download generated GRUB rescue image `__. #. List available disks with ``ls`` command::