chore(nas): dump upgrade commands

.vscode/settings.json

@@ -58,6 +58,9 @@
 
     "cSpell.language": "en,en-GB",
     "cSpell.words": [
+        "aclinherit",
+        "aclmode",
+        "acltype",
         "adduser",
         "airgap",
         "airgapped",
@@ -85,6 +88,7 @@
         "cereda",
         "certmanager",
         "cfengine",
+        "chage",
         "chattr",
         "chezmoi",
         "chpass",
@@ -100,12 +104,14 @@
         "containerd",
         "cowsay",
         "cpufreq",
+        "cpufrequtils",
         "cpulimit",
         "cpupower",
         "cryptsetup",
         "csma",
         "daemonless",
         "datagram",
+        "deluser",
         "devel",
         "dhclient",
         "diffpdf",
@@ -132,8 +138,10 @@
         "gettext",
         "gitops",
         "gopass",
+        "gpasswd",
         "gpgconf",
         "gpgtools",
+        "groupmask",
         "growpart",
         "hadolint",
         "hdparm",
@@ -185,6 +193,7 @@
         "odhcpd",
         "oidc",
         "ondemand",
+        "openmediavault",
         "openpgp",
         "opkg",
         "pacman",
@@ -240,11 +249,13 @@
         "tmpfs",
         "tolerations",
         "tput",
+        "truenas",
         "trufflehog",
         "turris",
         "twrp",
         "uncordon",
         "userdata",
+        "userdel",
         "userland",
         "usermod",
         "userspace",

knowledge base/diy nas/README.md

@@ -2,8 +2,6 @@
 
 'cause I got tired of hacking my way around the limitations of the default OS commercial NAS came equipped with.
 
-## Table of contents <!-- omit in toc -->
-
 1. [Revisions](#revisions)
 
 ## Revisions
@@ -11,7 +9,8 @@
 [V1]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Knowledge base -->

knowledge base/diy nas/v1.md

@@ -73,20 +73,18 @@ The ZFS pool and datasets used as shared folders shall have the following proper
 
 ## Sources
 
-All the references in the [further readings] section, plus the following:
-
 - [The Perfect Home Server 2023]
 - [What's the best PSU for your low idle home server?]
 - [TrueNAS core]
 - [Proxmox]
+- [How to run TrueNAS on Proxmox?]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- In-article sections -->
-[further readings]: #further-readings
-
 <!-- Knowledge base -->
 [openmediavault]: ../openmediavault.md
 [proxmox]: ../proxmox.md

knowledge base/openmediavault.md

@@ -2,8 +2,6 @@
 
 NAS solution based on [Debian Linux][debian].
 
-## Table of contents <!-- omit in toc -->
-
 1. [TL;DR](#tldr)
 1. [First access](#first-access)
 1. [Make other users administrators](#make-other-users-administrators)
@@ -12,10 +10,10 @@ NAS solution based on [Debian Linux][debian].
 1. [Power management](#power-management)
    1. [CPU governor](#cpu-governor)
    1. [Disk power options](#disk-power-options)
-1. [OMV-Extras](#omv-extras)
+1. [OMV Extras](#omv-extras)
 1. [ZFS](#zfs)
 1. [Further readings](#further-readings)
-1. [Sources](#sources)
+   1. [Sources](#sources)
 
 ## TL;DR
 
@@ -41,6 +39,14 @@ wget -O - 'https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/mast
 mv -v \
   '/etc/apt/sources.list.d/openmediavault-kernel-backports.list' \
   '/etc/apt/sources.list.d/openmediavault-kernel-backports.list.disabled'
+
+# Upgrade packages.
+sudo omv-upgrade
+
+# Move to the next release.
+# Includes upgrading the OS to the next version.
+# E.g.: Debian 11 -> 12 + OMV 6 -> 7
+tmux new-session -As 'omv-release-upgrade' "sudo omv-release-upgrade"
 ```
 
 ## First access
@@ -95,7 +101,8 @@ Enable the option under _Network_ > _Interfaces_, in **every** NIC's settings yo
 ### CPU governor
 
 Enabling the _Monitoring_ option under _System_ > _Power Management_ configures `cpufrequtils`.<br/>
-For x86 architectures, this also sets the default governor to `conservative`. If the architecture is different, the governor is set to `ondemand`.
+For x86 architectures, this also sets the default governor to `conservative`. If the architecture is different, the
+governor is set to `ondemand`.
 
 ### Disk power options
 
@@ -106,7 +113,7 @@ Editing a disk under _Storage_ > _Disks_ will allow to set these options for it:
 - Advanced power management.
 - Automatic acoustic management.<br/>
   Not all drives support this.
-- Spindown time.
+- Spin down time.
 - Write cache.
 
 All the above options are configured using [`hdparm`][hdparm].
@@ -130,10 +137,11 @@ To experiment with intermediate values:
   hdparm -I "/dev/sdX"
   ```
 
-When setting a spindown time, make sure the APM value is set lower than `128`. It will not work otherwise.<br/>
+When setting a spin down time, make sure the APM value is set lower than `128`. It will not work otherwise.<br/>
-The web framework does not narrow the APM options if the spindown time is set, nor it disables the spindown option when a value higher than 128 is selected for APM.
+The web framework does not narrow the APM options if the spin down time is set, nor it disables the spin down option
+when a value higher than 128 is selected for APM.
 
-## OMV-Extras
+## OMV Extras
 
 From the CLI, as the `root` user:
 
@@ -147,11 +155,12 @@ From the CLI, as the `root` user:
 
 ## ZFS
 
-1. [Install OMV-Extras].
+1. [Install OMV-Extras][omv extras].
 1. Pick one:
 
    - Disable the kernel's backports APT sources and stick to the mainline one.<br/>
-     Linux backport kernels are released quickly enough to leave the userland incomplete at times. This often happens with ZFS, resulting in broken package issues.
+     Linux backport kernels are released quickly enough to leave the userland incomplete at times. This often happens
+     with ZFS, resulting in broken package issues.
 
      ```sh
      mv -v \
@@ -160,9 +169,11 @@ From the CLI, as the `root` user:
      ```
 
    - Install the `openmediavault-kernel` plugin and use it to install the Proxmox kernel.<br/>
-     Debian does not build ZFS kernel modules into any of their kernels by default due to licensing conflicts. This may result in an extensive build process during installation, which is prone to errors.
+     Debian does not build ZFS kernel modules into any of their kernels by default due to licensing conflicts. This may
+     result in an extensive build process during installation, which is prone to errors.
 
-     The Proxmox-Debian kernel has the ZFS kernel modules preinstalled by default. As kernel upgrades become available and are performed, the userland for the Proxmox kernel will always have the required packages to support ZFS.
+     The Proxmox-Debian kernel has the ZFS kernel modules preinstalled by default. As kernel upgrades become available
+     and are performed, the userland for the Proxmox kernel will always have the required packages to support ZFS.
 
 1. Install the `openmediavault-zfs` plugin.
 1. Create pools and such.<br/>
@@ -181,27 +192,20 @@ Just enable property in the pool or dataset.
 - [Disks maintenance]
 - [ZFS]
 
-## Sources
+### Sources
-
-All the references in the [further readings] section, plus the following:
 
 - [How to lock or disable an user account]
 - [ZFS plugin for OMV6]
+- [Software & Update Management]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
-<!-- Upstream -->
-[documentation]: https://docs.openmediavault.org/en/latest/
-[omv-extras]: https://wiki.omv-extras.org/
-[website]: https://www.openmediavault.org/
-[zfs plugin for omv6]: https://wiki.omv-extras.org/doku.php?id=docs_in_draft:zfs
-
 <!-- In-article sections -->
-[further readings]: #further-readings
 [make other users administrators]: #make-other-users-administrators
-[omv-extras]: #omv-extras
+[omv extras]: #omv-extras
 
 <!-- Knowledge base -->
 [debian]: debian.md
@@ -209,6 +213,13 @@ All the references in the [further readings] section, plus the following:
 [proxmox]: proxmox.md
 [zfs]: zfs.md
 
+<!-- Upstream -->
+[documentation]: https://docs.openmediavault.org/en/latest/
+[omv-extras]: https://wiki.omv-extras.org/
+[software & update management]: https://docs.openmediavault.org/en/stable/various/apt.html
+[website]: https://www.openmediavault.org/
+[zfs plugin for omv6]: https://wiki.omv-extras.org/doku.php?id=docs_in_draft:zfs
+
 <!-- Others -->
 [hdparm]: https://linux.die.net/man/8/hdparm
 [how to lock or disable an user account]: https://www.thegeekdiary.com/unix-linux-how-to-lock-or-disable-an-user-account/