OpenBSD 6.8 Upgrade Guide

%25define=note block bgcolor=lightblue color=black margin-right=5em margin-left=5em padding=1em overflow=auto %25

%25define=info block bgcolor=lightgrey color=black margin-right=5em margin-left=5em padding=1em overflow=auto %25

%25define=warn block bgcolor=yellow color=black margin-right=5em margin-left=5em padding=1em overflow=auto %25

%25define=alert block bgcolor=lightpink color=black margin-right=5em margin-left=5em padding=1em overflow=auto %25

This is an upgrade guide for OpenBSD 6.8 using bsd.rd. It assumes you have OpenBSD 6.7 or 6.8 installed and working networking. It can be used to repair OpenBSD 6.7 or 6.8.

%25info%25This guide was written for upgrading openbsd 6.7 to 6.8, but is mostly the same for upgrading all the version after. Upgrades must be done one version at a time, so upgrading 6.7 to 7.0 would require upgrading to 6.8, followed by upgrading to 6.9, then finally 7.0.

%25note%25*NOTE*: This guide is no substitute for reading the OpenBSD FAQ. In particular, you should read the 6.8 Upgrade Guide.

%25alert%25*ALSO SEE*: Sysupgrade is an easier, mostly unattended upgrade process. ?Openbsd.Sysupgrade68 ?Openbsd.Sysupgrade69 ?Openbsd.Sysupgrade70 ?Openbsd.Sysupgrade71

Check to see if you need to upgrade your OS. To find out your operating system version, type: uname -a. If it says OpenBSD fruit.ircnow.org 6.7 GENERIC#6 amd64, you can upgrade to 6.8 using this guide. If it says OpenBSD fruit.ircnow.org 6.8 GENERIC.MP#98 amd64, you can follow this guide to repair your OS. Otherwise, there is no need to upgrade.

Make sure to back up any files. Use dump and ?restore.

Make sure to notify all your users in advance that there will be downtime during the upgrade.

You will need a way to view the serial console. If you are using VMM, you can view it using the ?serial console. If you are using BuyVM, you should use VNC. Make sure to have the serial console open so you can interrupt the normal bootup process during the upgrade.

First, download bsd.rd and the SHA256 signature file from an OpenBSD mirror.

Verify the signature, replace /bsd.rd with the new bsd.rd, then reboot:\

$ ftp https://ftp.openbsd.org/pub/OpenBSD/6.8/amd64/bsd.rd
$ ftp https://ftp.openbsd.org/pub/OpenBSD/6.8/amd64/SHA256.sig
$ signify -C -p /etc/signify/openbsd-68-base.pub -x SHA256.sig bsd.rd
$ doas cp bsd.rd /bsd.rd
$ doas shutdown -r now

Attach:upgrade68-1.png\

NOTE: You must type something within 3 seconds or else bootup will continue automatically. If bootup does happen automatically, login and reboot by typing doas shutdown -r now.

At the serial console (either cu or VNC), before automatic bootup, type `boot /bsd.rd`.\

Attach:upgrade68-2.png

If you did everything correctly, you should see OpenBSD 6.8 (RAMDISK_CD) in the boot screen. If you see OpenBSD 6.7, you did not follow the above steps correctly.\

Attach:upgrade68-2b.png

Type u for (U)pgrade. Upgrading will allow you to install OpenBSD 6.8. You can use this to either upgrade from 6.7 or to repair an existing 6.8 system.\

Attach:upgrade68-3.png

Press enter for vt220.

To check which root disk, press ? for details. NOTE: Be careful to install to the correct disk.

There is no probably need to force check clean non-root filesystems, so just press enter.\

Attach:upgrade68-3b.png

You can get the base sets from cd (ISO), disk (such as USB flash drive), or http. For this tutorial, we will use http.

For this tutorial, we will not use a proxy. Press enter for none.

For the HTTP server, press ? to show a list of servers. Choose the one closest to your location.

Leave the server directory as pub/OpenBSD/6.8/amd64 and press enter.

Install all the sets. It is not possible to install missing sets using ?pkg add; you will be required to re-run the installer. So, we don't recommend skipping any sets. Missing sets may cause issues later.

If downloading sets over http, make sure that the SHA256.sig file is verified.\

Attach:upgrade68-4.png

Press enter for done.

Press enter to reboot.

NOTE: If you booted from ISO, flash drive, or some other external install media, you will need to make sure that the bootloader boots from the proper hard disk. If you're using BuyVM, see the BuyVM User Guide for how to switch the default boot order.

The system will automatically boot OpenBSD 6.8.\

Attach:upgrade68-5.png

You will see a list of patches that need to be installed and conf files that need to be updated.

At this point, you can now use ?ssh to log in.

Make sure to read and fix any error messages that you may see.\

Attach:upgrade68-6.png

To check if installation succeeded:\

$ uname -a
OpenBSD fruit.ircnow.org 6.8 GENERIC#179 amd64

If you see 6.7, installation did not succeed.

To check if you have the proper amount of RAM and number of cores, run ?top.\

Attach:upgrade68-7.png

If you do not see the correct number of cores, make sure to reinstall all the base sets by following this upgrade guide from the beginning.

You will want to patch the system:\

$ doas syspatch

Then, you'll want to run sysmerge to merge any configuration files:\

$ doas sysmerge

Then, make sure to upgrade your packages:\

$ doas pkg_add -u

You may optionally install any firmware by running ?fw update $:\$

$ doas fw_update -a

This is not advised, however, because some of the firmware may be proprietary.

You will want to reboot after installing patches:\

$ doas shutdown -r now