1dnl $OpenBSD: upgrade,v 1.8 2010/06/05 19:35:57 miod Exp $ 2Warning! Upgrades to OpenBSD OSREV are currently only supported from the 3immediately previous release. The upgrade process will also work with older 4releases, but might not execute some migration tasks that would be necessary 5for a proper upgrade. The best solution, whenever possible, is to backup 6your data and reinstall from scratch. 7 8To upgrade OpenBSD OSREV from a previous version, start with the general 9instructions in the section "Installing OpenBSD". 10 11 Warning! If you intend to upgrade an OpenBSD 4.4 system, or an even older 12 version, by booting bsd.rd from the existing OpenBSD system disk, it will 13 be necessary to update your boot blocks first. 14 To do this, replace your existing boot blocks with the xxboot file 15 provided in the OpenBSD/MACHINE OSrev distribution: 16 # cat xxboot > /usr/mdec/xxboot 17 # /sbin/disklabel -B /dev/rsd0c 18 (assuming your system disk is sd0). Do NOT use `cp' to copy the boot 19 blocks, as there are several hard links to /usr/mdec/xxboot which need 20 to be preserved for this operation to succeed. 21 22Boot from the LIF image ``lif{:--:}OSrev.fs'', or a RAMDISK kernel ``bsd.rd''. 23When prompted, select the (U)pgrade option rather than the (I)nstall 24option at the prompt in the install process. 25 26The upgrade script will ask you for the existing root partition, and 27will use the existing filesystems defined in /etc/fstab to install the 28new system in. It will also use your existing network parameters. 29 30From then, the upgrade procedure is very close to the installation 31procedure described earlier in this document. Note that the upgrade 32procedure will not let you pick the ``etc{:--:}OSrev.tgz'' set, so as to 33preserve your files in `/etc' which you are likely to have customized 34since a previous installation. 35 36However, it is strongly advised that you unpack the etc{:--:}OSrev.tgz set in 37a temporary directory and merge changes by hand, since some components of 38your system may not function correctly until your files in `/etc' are 39updated. 40