I just found out that FreeBSD 13.2-RELEASE will be end-of-life support within 1 month time from now. It’s time to upgrade FreeBSD on one of nas boxes to 14.0-RELEASE. The following is to capture the steps used to perform the upgrade. It’s similar to my old post.
- SSH into the server, and run
tmuxorscreen. You really don’t want to lose SSH connection during the upgrade.
$ ssh kenno@nas2
$ tmux
- Check the current running version of FreeBSD:
root@nas2:~ # freebsd-version
13.2-RELEASE-p11
- Make sure the system is up-to-date with all the patches:
root@nas2:~ # freebsd-update fetch
root@nas2:~ # freebsd-update install
root@nas2:~ # pkg update
root@nas2:~ # pkg upgrade
- Upgrade FreeBSD from 13.2 to 14.0
root@nas2:~ # freebsd-update -r 14.0-RELEASE upgrade
src component not installed, skipped
Looking up update.FreeBSD.org mirrors... 3 mirrors found.
Fetching metadata signature for 13.2-RELEASE from update1.freebsd.org... done.
Fetching metadata index... done.
Inspecting system... done.
The following components of FreeBSD seem to be installed:
kernel/generic kernel/generic-dbg world/base world/lib32
The following components of FreeBSD do not seem to be installed:
world/base-dbg world/lib32-dbg
Does this look reasonable (y/n)? y
Fetching metadata signature for 14.0-RELEASE from update1.freebsd.org... done.
Fetching metadata index... done.
Fetching 1 metadata patches. done.
Applying metadata patches... done.
Fetching 1 metadata files... done.
Inspecting system...
- Wait for a long while… then when the update process detects changes in some important files, I’m asked to decide what to do by editing that file, pick the desired changes, and save them. For example:
The following changes, which occurred between FreeBSD 13.2-RELEASE and [0/143]
FreeBSD 14.0-RELEASE have been merged into /etc/ssh/sshd_config:
--- current version
+++ new version
@@ -87,11 +87,11 @@
#UsePAM yes
#AllowAgentForwarding yes
#AllowTcpForwarding yes
#GatewayPorts no
-#X11Forwarding yes
+#X11Forwarding no
#X11DisplayOffset 10
#X11UseLocalhost yes
#PermitTTY yes
#PrintMotd yes
#PrintLastLog yes
@@ -104,11 +104,11 @@
#PidFile /var/run/sshd.pid
#MaxStartups 10:30:100
#PermitTunnel no
#ChrootDirectory none
#UseBlacklist no
-#VersionAddendum FreeBSD-20230719
+#VersionAddendum FreeBSD-20231004
# no default banner path
#Banner none
# override default of no subsystems
Does this look reasonable (y/n)? y
The following changes, which occurred between FreeBSD 13.2-RELEASE and
FreeBSD 14.0-RELEASE have been merged into /etc/sysctl.conf:
--- current version
+++ new version
@@ -1,6 +1,5 @@
-# $FreeBSD$
#
# This file is read when going to multi-user and its contents piped thru
# ``sysctl'' to adjust kernel values. ``man 5 sysctl.conf'' for details.
#
Does this look reasonable (y/n)? y
To install the downloaded upgrades, run "/usr/sbin/freebsd-update install".
- Perform the update by running the above suggested command.
root@nas2:~ # /usr/sbin/freebsd-update install
src component not installed, skipped
Creating snapshot of existing boot environment... done.
Installing updates...
Kernel updates have been installed. Please reboot and run
"/usr/sbin/freebsd-update install" again to finish installing updates.
- I guess we know what to do next…
root@nas2:~ # reboot
Connection to nas2 closed by remote host.
Connection to nas2 closed.
- Reconnect to the server with SSH. There is no need to run ’tmux’ session this time.
root@nas2:~ # /usr/sbin/freebsd-update install
src component not installed, skipped
Creating snapshot of existing boot environment... done.
Installing updates...rm: ///usr/include/c++/v1/__string: is a directory
Restarting sshd after upgrade
Performing sanity check on sshd configuration.
Stopping sshd.
Waiting for PIDS: 863.
Performing sanity check on sshd configuration.
Starting sshd.
Scanning /usr/share/certs/untrusted for certificates...
Scanning /usr/share/certs/trusted for certificates...
Completing this upgrade requires removing old shared object files.
Please rebuild all installed 3rd party software (e.g., programs
installed from the ports tree) and then run "/usr/sbin/freebsd-update install"
again to finish installing updates.
- How to rebuild all installed 3rd party software? I’m guessing I need to run
pkg update && pkg upgrade.
root@nas2:~ # pkg update
pkg: Warning: Major OS version upgrade detected. Running "pkg bootstrap -f" recommended
Updating FreeBSD repository catalogue...
pkg: Repository FreeBSD has a wrong packagesite, need to re-create database
Fetching meta.conf: 100% 178 B 0.2kB/s 00:01
Fetching data.pkg: 100% 7 MiB 3.6MB/s 00:02
Processing entries: 100%
FreeBSD repository update completed. 34072 packages processed.
All repositories are up to date.
- Love the suggestion about running
pkg bootstrap -f.
root@nas2:~ # pkg bootstrap -f
The package management tool is not yet installed on your system.
Do you want to fetch and install it now? [y/N]: y
Bootstrapping pkg from pkg+http://pkg.FreeBSD.org/FreeBSD:14:amd64/quarterly, please wait...
Verifying signature with trusted certificate pkg.freebsd.org.2013102301... done
Installing pkg-1.21.3...
package pkg is already installed, forced install
Extracting pkg-1.21.3: 100%
- This time, I should be able to continue updating the 3rd party software.
root@nas2:~ # pkg update
Updating FreeBSD repository catalogue...
FreeBSD repository is up to date.
All repositories are up to date.
root@nas2:~ # pkg upgrade
Updating FreeBSD repository catalogue...
FreeBSD repository is up to date.
All repositories are up to date.
Updating database digests format: 100%
Checking for upgrades (44 candidates): 100%
Processing candidates (44 candidates): 100%
The following 43 package(s) will be affected (of 0 checked):
Installed packages to be REINSTALLED:
binutils-2.40_5,1 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
bsdinfo-0.22_2 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
btop-1.3.2 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
dmidecode-3.5 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
...<SNIP>...
tmux-3.3a_2 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
tree-sitter-0.22.2 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
unibilium-2.1.1_1 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
zstd-1.5.6 (ABI changed: 'freebsd:13:x86:64' -> 'freebsd:14:x86:64')
Number of packages to be reinstalled: 43
395 MiB to be downloaded.
Proceed with this action? [y/N]: y
That’s it!
root@nas2:~ # freebsd-version
14.0-RELEASE-p6
Reference: