[FAQ Index] | [6.1 -> 6.2] [6.3 -> 6.4]
Upgrades are only supported from one release to the release immediately following it. Read through and understand this process before attempting it. For critical or physically remote machines, test it on an identical, local system first.Start by performing the pre-upgrade steps. Next, boot from the install kernel, bsd.rd: use bootable install media, or place the 6.3 version of
bsd.rd
in the root of your filesystem and instruct the boot
loader to boot this kernel.
Once this kernel is booted, choose the (U)pgrade
option and follow the
prompts.
Apply the configuration changes and
finish up by upgrading the packages: pkg_add -u
.
Alternatively, you can use the manual upgrade process.
You may wish to check the errata page or upgrade to the stable branch to get any post-release fixes.
bsd.rd
.
Download the ramdisk kernel and the cryptographically signed checksum file
for your architecture.
bsd.rd
[alpha]
[amd64]
[arm64]
[armv7]
[i386]
[landisk]
[loongson]
[luna88k]
[macppc]
[octeon]
[sparc64]
SHA256.sig
[alpha]
[amd64]
[arm64]
[armv7]
[i386]
[landisk]
[loongson]
[luna88k]
[macppc]
[octeon]
[sparc64]
Verify them using signify(1):
$ signify -C -p /etc/signify/openbsd-63-base.pub -x SHA256.sig bsd.rd Signature Verified bsd.rd: OK
/usr/share
.
Remove all outdated manuals.
Moreover, the relinking of libraries and kernels at boot time now
happens in /usr/share/relink
.
The old relinking directory is no longer used and can be removed.
# rm -r /usr/share/man # rm -r /usr/share/compile
If you need the old style stateless address calculated from the layer
2 address (i.e. ethernet mac address) put -soii
into the
/etc/hostname.if
file.
See also
ifconfig(8).
ifconfig <if> deletetunnel
option deprecated.
The ifconfig(8)
deletetunnel
option was replaced with -tunnel
.
Adjust your
hostname.if(5)
configuration and scripts accordingly.
xorg.conf
file.
/etc/hostname.bridge0
.
This also requires users to modify their
vm.conf(5)
files to add an interface line to the switch definition, for example:
switch "uplink" { interface bridge0 }
libpthread-stubs
is no longer needed in xenocara.
After upgrading base and packages, users may want to remove the old
installed library, either via the sysclean package or by running the
following commands:
# cd /usr/X11R6/lib # rm libpthread-stubs.a \ libpthread-stubs.so.2.0 \ pkgconfig/pthread-stubs.pc
Refer to
the upgrade guide
for information on how to migrate your configuration.
If you want to keep running a 0.8 buildmaster to keep access to your old build
logs/history, it's advised to install the 0.8 branch from pip
and run
it outside of packages.
mutt -> neomutt
.
pkg_add
will result in newsboat being
installed.
Upon running newsboat
for the first time it will prompt
if it should import an existing newsbeuter configuration.
pg_upgrade
as described in the
postgresql-server pkg-readme
or do a dump/restore.
Sometimes, you need to do an upgrade of a machine for which the normal upgrade process is not possible. The most common case is a machine in a remote location and there is no easy access to the system console.
softdep
mount option in /etc/fstab
and rebooting before undertaking a manual upgrade.
Having at least 500MB free on /usr
would be recommended.
sd0
is your boot disk:
installboot sd0
If using the multiprocessor kernel:
If using the single processor kernel:cd /usr/rel # where you put the release files ln -f /bsd /obsd && cp bsd.mp /nbsd && mv /nbsd /bsd cp bsd.rd / cp bsd /bsd.sp
cd /usr/rel # where you put the release files ln -f /bsd /obsd && cp bsd /nbsd && mv /nbsd /bsd cp bsd.rd bsd.mp / # may give a harmless warning
sha256 -h /var/db/kernel.SHA256 /bsd
base63.tgz
last, because the new base system, in particular
tar(1),
gzip(1) and
reboot(8),
will not work with the old kernel.
Either untar the needed filesets manually
or, if you use ksh(1), you can docp /sbin/reboot /sbin/oreboot tar -C / -xzphf xshare63.tgz tar -C / -xzphf xserv63.tgz tar -C / -xzphf xfont63.tgz tar -C / -xzphf xbase63.tgz tar -C / -xzphf man63.tgz tar -C / -xzphf game63.tgz tar -C / -xzphf comp63.tgz tar -C / -xzphf base63.tgz # Install last! /sbin/oreboot
Note that tar(1) can expand only one archive per invocation, so a simple glob won't work.cp /sbin/reboot /sbin/oreboot for _f in [!b]*63.tgz base63.tgz; do tar -C / -xzphf "$_f" || break; done /sbin/oreboot
/dev
.
Run
MAKEDEV(8):
cd /dev ./MAKEDEV all
sd0
is your boot disk:
installboot sd0
sysmerge
fw_update
dmesg -s
)
and correct any failures as necessary.
All the steps following configuration changes
above also apply to manual upgrades.
Finally, remove /sbin/oreboot
and update packages:
pkg_add -u
.
Reboot once more to make sure you run on your own kernel generated by KARL.
[FAQ Index] | [6.1 -> 6.2] [6.3 -> 6.4]