======================================= FreeBSD Upgrade 13.4 to 14.5 to 15.1 ======================================= 1. recipe to upgrade freebsd completely offline with a single reboot 2. this example starts with a host machine and jails all running freebsd 13.4 3. we will migrate everything properly through 14.5 and ending up with 15.1 4. audit the usual config files and pay close attention to: - /etc/rc.conf - /etc/jail.conf - /etc/mail/mailer.conf - /etc/dma/dma.conf - /boot/loader.conf - /etc/sysctl.conf ======================================= always upgrade the server first ======================================= --------------------------------------- upgrade server 13.4 to 14.5 --------------------------------------- bectl create upgrading bectl mount upgrading /tmp/be_up mount -t devfs devfs /tmp/be_up/dev chroot /tmp/be_up freebsd-version -ku freebsd-update -b /tmp/be_up --currently-running 13.4-RELEASE-p4 -r 14.5-RELEASE upgrade freebsd-update -b /tmp/be_up --currently-running 13.4-RELEASE-p4 install freebsd-update -b /tmp/be_up --currently-running 14.5-RELEASE install env ABI=FreeBSD:14:amd64 OSVERSION=1405000 pkg-static --chroot /tmp/be_up -o IGNORE_OSVERSION=yes -o 'FreeBSD-kmods[enabled]=no' bootstrap -f env ABI=FreeBSD:14:amd64 OSVERSION=1405000 pkg-static --chroot /tmp/be_up -o IGNORE_OSVERSION=yes upgrade -fr FreeBSD -y freebsd-update -b /tmp/be_up --currently-running 14.5-RELEASE install chroot /tmp/be_up freebsd-version -ku --------------------------------------- continue to upgrade server 14.5 to 15.1 --------------------------------------- freebsd-update -b /tmp/be_up --currently-running 14.5-RELEASE -r 15.1-RELEASE upgrade freebsd-update -b /tmp/be_up --currently-running 14.5-RELEASE install freebsd-update -b /tmp/be_up --currently-running 15.1-RELEASE install env ABI=FreeBSD:15:amd64 OSVERSION=1501000 pkg-static --chroot /tmp/be_up -o IGNORE_OSVERSION=yes -o repository=FreeBSD bootstrap -f env ABI=FreeBSD:15:amd64 OSVERSION=1501000 pkg-static --chroot /tmp/be_up -o IGNORE_OSVERSION=yes upgrade -fr FreeBSD-ports -y freebsd-update -b /tmp/be_up --currently-running 15.1-RELEASE install chroot /tmp/be_up freebsd-version -ku umount /tmp/be_up/dev ======================================= upgrade the jails last ======================================= --------------------------------------- uppgrade jail 13.4 to 14.5 --------------------------------------- zfs snapshot tank/jail/cujo/disk/zroot/ROOT/default@13.4 zfs clone -o canmount=on -o mountpoint=/tmp/cujo_up tank/jail/cujo/disk/zroot/ROOT/default@13.4 tank/jail/cujo/disk/zroot/ROOT/upgrading mount -t devfs devfs /tmp/cujo_up/dev chroot /tmp/cujo_up freebsd-version -ku freebsd-update -b /tmp/cujo_up --currently-running 13.4-RELEASE-p4 -r 14.5-RELEASE upgrade freebsd-update -b /tmp/cujo_up --currently-running 13.4-RELEASE-p4 install freebsd-update -b /tmp/cujo_up --currently-running 14.5-RELEASE install env ABI=FreeBSD:14:amd64 OSVERSION=1405000 pkg-static --chroot /tmp/cujo_up -o IGNORE_OSVERSION=yes -o 'FreeBSD-kmods[enabled]=no' bootstrap -f env ABI=FreeBSD:14:amd64 OSVERSION=1405000 pkg-static --chroot /tmp/cujo_up -o IGNORE_OSVERSION=yes upgrade -fr FreeBSD -y freebsd-update -b /tmp/cujo_up --currently-running 14.5-RELEASE install chroot /tmp/cujo_up freebsd-version -ku --------------------------------------- continue to upgrade jail 14.5 to 15.1 --------------------------------------- freebsd-update -b /tmp/cujo_up --currently-running 14.5-RELEASE -r 15.1-RELEASE upgrade freebsd-update -b /tmp/cujo_up --currently-running 14.5-RELEASE install freebsd-update -b /tmp/cujo_up --currently-running 15.1-RELEASE install env ABI=FreeBSD:15:amd64 OSVERSION=1501000 pkg-static --chroot /tmp/cujo_up -o IGNORE_OSVERSION=yes -o repository=FreeBSD bootstrap -f env ABI=FreeBSD:15:amd64 OSVERSION=1501000 pkg-static --chroot /tmp/cujo_up -o IGNORE_OSVERSION=yes upgrade -fr FreeBSD-ports -y freebsd-update -b /tmp/cujo_up --currently-running 15.1-RELEASE install chroot /tmp/cujo_up freebsd-version -ku umount /tmp/cujo_up/dev ======================================= prepare and reboot host ======================================= --------------------------------------- ed /tmp/host_upgrading/etc/rc.conf --------------------------------------- # jails #jail_enable="YES" #jail_list="cujo" cloned_interfaces="bridge0 bridge1" ifconfig_igb1="up" ifconfig_bridge0="addm igb0 up" ifconfig_bridge1="addm igb1 up" --------------------------------------- bectl umount upgrading bectl rename default 13.4-RELEASE-p4_backup bectl rename upgrading default bectl activate default shutdown -r now freebsd-version -kru ======================================= prepare and start jails one at a time ======================================= --------------------------------------- ed /etc/rc.conf --------------------------------------- # jails jail_enable="YES" jail_list="cujo" cloned_interfaces="bridge0 bridge1" ifconfig_igb1="up" ifconfig_bridge0="addm igb0 up" ifconfig_bridge1="addm igb1 up" --------------------------------------- ed /etc/jail.conf --------------------------------------- exec.clean; exec.start = "/bin/sh /etc/rc"; exec.stop = "/bin/sh /etc/rc.shutdown"; allow.raw_sockets = 1; mount.devfs; path = "/export/jail/${name}/root"; exec.consolelog = "/var/log/jail_${name}.log"; cujo { vnet; # 1. private link epair ends with 1 exec.prestart = "ifconfig epair11 create up"; exec.prestart += "ifconfig bridge0 addm epair11a"; # 2. public link epair ends with 2 exec.prestart += "ifconfig epair12 create up"; exec.prestart += "ifconfig bridge1 addm epair12a"; vnet.interface = "epair11b"; vnet.interface += "epair12b"; exec.poststop = "ifconfig bridge0 deletem epair11a"; exec.poststop += "ifconfig bridge1 deletem epair12a"; exec.poststop += "ifconfig epair11a destroy"; exec.poststop += "ifconfig epair12a destroy"; } --------------------------------------- ed /tmp/cujo_up/etc/rc.conf --------------------------------------- hostname="cujo" ifconfig_epair11b="inet 192.168.100.10 netmask 255.255.255.0" ifconfig_epair12b="inet 100.100.100.10 netmask 255.255.255.248" defaultrouter="100.100.100.1" --------------------------------------- ed /tmp/cujo_up/etc/mail/mailer.conf --------------------------------------- # # mailer.conf for use with dma(8) # # If sendmail is configured, an example of mailer.conf that uses sendmail # instead can be found in /usr/share/examples/sendmail. sendmail /usr/libexec/dma mailq /usr/libexec/dma newaliases /usr/libexec/dma --------------------------------------- ed /tmp/cujo_up/etc/dma/dma.conf --------------------------------------- SMARTHOST smtp.mydomain.com MASQUERADE cujo.mydomain.com --------------------------------------- zfs umount tank/jail/cujo/disk/zroot zfs promote tank/jail/cujo/disk/zroot/ROOT/upgrading zfs rename tank/jail/cujo/disk/zroot/ROOT/default tank/jail/cujo/disk/zroot/ROOT/13.4-backup zfs set canmount=noauto tank/jail/cujo/disk/zroot/ROOT/13.4-backup zfs rename tank/jail/cujo/disk/zroot/ROOT/upgrading tank/jail/cujo/disk/zroot/ROOT/default zfs set mountpoint=/export/jail/cujo/root tank/jail/cujo/disk/zroot/ROOT/default zfs set canmount=on tank/jail/cujo/disk/zroot/ROOT/default zfs mount -a service jail start cujo jexec cujo freebsd-version -ku ======================================= cleanup ======================================= bectl destroy 13.4-RELEASE-backup zfs destroy tank/jail/cujo/disk/zroot/ROOT/13.4-backup zfs destroy tank/jail/cujo/disk/zroot/ROOT/default@13.4 ======================================= done =======================================