FreeBSD 5.3 to FreeBSD 5.4 binary upgrade

In February 2005 I put instructions online explaining how to perform a binary upgrade from FreeBSD 4.8 to FreeBSD 4.11. When it came time to upgrade my FreeBSD 5.3 system to instead run FreeBSD 5.4, I found that some slightly different steps were needed, so I decided to put together a 5.3-to-5.4 upgrade guide as well.

What follows are the steps I used to upgrade my FreeBSD 5.3 system to FreeBSD 5.4-RELEASE; I can't guarantee that they'll work for everyone, but this should be at least a good starting point.

N.B. I only install the "base" "dict", "doc", and "manpages" distributions here -- I don't want the "catpages", compat, "games", "info", "ports", "proflibs", or "src" distributions. If you want a different set of distributions, change the lists in steps 6, 9, and 10.


  1. If you haven't done so already, install FreeBSD Update.

    cd /usr/ports/security/freebsd-update && make install clean
    cp /usr/local/etc/freebsd-update.conf.sample /usr/local/etc/freebsd-update.conf
    
  2. Using FreeBSD Update, generate a list of files from the base system which have been locally modified. We might not want to overwrite these.

    freebsd-update -v IDS | tail +8 | grep . | cut -c 2- - > /root/base-modified
    
  3. Edit this list and delete files for which you don't want to keep your local changes. You'll almost certainly want to delete any lines starting with usr/, but you'll probably want to keep the lines which start with etc/ or var/log/.

    ee /root/base-modified
    
    (or use vi or any other text editor you have installed.)

  4. Generate a list of files installed which belong to the old RELEASE. We'll be using this list to make sure we don't leave old files lying around after the upgrade.

    cut -f 1 -d '$' /usr/local/freebsd-update/work/md5all | uniq |
    	while read X; do
    		if [ -f $X ]; then echo $X; fi;
    	done | sort > /root/base-old
    
  5. Download an ISO image for the new release and mount it.

    fetch -o /usr/disc1.iso	\
    ftp://ftp.freebsd.org/pub/FreeBSD/ISO-IMAGES-i386/5.4/5.4-RELEASE-i386-disc1.iso
    mdconfig -a -t vnode -f /usr/disc1.iso -u 9
    mount -t cd9660 -o ro /dev/md9 /mnt
    
  6. For the files which have been locally modified, extract the new versions to a temporary directory.

    mkdir /usr/release
    for dist in base dict doc manpages; do
    	cat /mnt/5.4-RELEASE/${dist}/${dist}.?? |
    		tar -xpzf - -I /root/base-modified -C /usr/release
    done 2>/dev/null
    
  7. For each of these files (in /root/base-modified), compare the existing and new versions to see if you need to update anything. (I didn't, but sometimes there are necessary changes in configuration files -- for example, in FreeBSD 4.7 a new "sshd" user was added.)

    grep ^etc /root/base-modified | while read f; do
    	diff -u /${f} /usr/release/${f}
    done | more
    
  8. Clear the immutable flag on files from the base system to make sure that we can overwrite or delete them.

    xargs chflags noschg < /root/base-old
    
  9. Extract the new release (minus the locally modified files that we don't want to overwrite).

    for dist in base dict doc manpages; do
    	/mnt/rescue/cat /mnt/5.4-RELEASE/${dist}/${dist}.?? |
    		/mnt/rescue/tar -Uxpzf - -X /root/base-modified -C /
    done
    
  10. Generate a list of files which belong to the new release, and compare this to the list of files which were in the old release, so that we can clean up the garbage left behind.

    ( for dist in base dict doc manpages; do
    	cat /mnt/5.4-RELEASE/${dist}/${dist}.?? | tar -tzf -
    done; cat /root/base-modified ) | sort | uniq | lam -s '/' - > /root/base-new
    comm -13 /root/base-new /root/base-old | xargs rm
    
  11. Clean up.

    umount /mnt
    mdconfig -d -u 9
    rm -r /usr/release
    rm /usr/disc1.iso
    rm /root/base-modified /root/base-old /root/base-new
    
  12. Reboot into your new 5.4-RELEASE system.

    shutdown -r now