From 3b1817db8215a308869d78aafd373818f7683b0a Mon Sep 17 00:00:00 2001
From: John-Paul Bader <contact@smyck.org>
Date: Fri, 5 Aug 2022 11:44:18 +0200
Subject: [PATCH] Draft of FreeBSD Upgrade Procedure

---
 upgrade_guide.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 upgrade_guide.md

diff --git a/upgrade_guide.md b/upgrade_guide.md
new file mode 100644
index 0000000..fda605c
--- /dev/null
+++ b/upgrade_guide.md
@@ -0,0 +1,29 @@
+## References
+
+* https://docs.freebsd.org/en/books/handbook/cutting-edge/
+
+## Preparations
+
+https://www.freebsd.org/releases/13.1R/relnotes/
+
+
+## General Procedure
+
+* Check Release Notes for potentially breaking changes (which is rare)
+* ZFS Snapshot `zfs snapshot -r tank@2022-08-05_01`
+* Create Boot Environemnt `bectl create 13_1_RELEASE`
+* Mount Boot Environment `bectl mount 13_1_RELEASE`
+* Run FreeBSD Upgrade 
+  ```sh
+  freebsd-update \                     
+  -b /tmp/be_mount.JO5Y \
+  -d /tmp/be_mount.JO5Y/var/db/freebsd-update \
+  -r 13.1-RELEASE upgrade
+  ```
+* Run `freebsd-update install` with the same flags, two times in a row without rebooting
+* Disable ezjail in rc.conf
+* Temporarily activate boot environment `bectl activate -t 13_1_RELEASE`
+* When machine is back up, delete ezjail basejail and newjail `zfs destroy tank/ezjail/basejail` and `zfs destroy tank/ezjail/newjail`
+* Re-install ezjail basejail and newjail `ezjail-admin install -sp`
+* Mergemaster jails, starting with the most important ones `sudo mergemaster -U -D /usr/jails/lb-01.production.soba.gg`
+* Check ZFS `zpool status`