This is an old revision of the document!
Base Upgrade
Create BE for the Upgrade
Be sure to create and activate a new BE when it is time to do a major upgrade of the base system. For example, to upgrade from 12.1-RELEASE to 12.2-RELEASE …
# bectl list (verify your active BE is named 'default') # bectl rename default 12.1-RELEASE # bectl create 12.2-RELEASE # bectl activate 12.2-RELEASE # reboot
Do the Upgrade
(log back in as root) # freebsd-update -r 12.2-RELEASE upgrade # freebsd-update install # reboot
Retreat
Suppose things didn't go well after the reboot. You're pressed for time so you decide to delay the upgrade so you can take time to study the problem. No worries.
# bectl activate 12.1-RELEASE # bectl reboot
Now you are back to where you left off before attempting the upgrade. Log back in as root to clean up the broken BE.
# bectl list (verify the exact spellings of the BEs) # bectl destroy 12.2-RELEASE
A few weeks later, you read that a patch has been made that might solve the problem you ran into. You decide to try again. Go back to the beginning of this page and start over. Good luck.
Clean Up
Suppose your upgrade went smoothly. After a few days or weeks when certain you no longer need the old 12.1-RELEASE BE, you can delete the old BE to save some disk space.
# bectl list (verify the exact spellings of the BEs) # bectl destroy 12.1-RELEASE