DragonFly BSD

Upgrading

Updating the System

Supported methods

The only supported method of upgrading DragonFly BSD is by building from source code. The supported upgrade process includes going from the previous release to latest release.

Getting the source code

There is a Makefile in /usr which will ease the task of retrieving the source tree; it needs to be run as root:

% cd /usr
% make src-create
 [...]

This will check out (download) the source tree to /usr/src and switch to the master branch. For the stable branch, you need to check it out with the following command (remember to replace the DragonFly_RELEASE_3_0 with the appropriate branch name for the release needed).

% cd /usr/src
% git checkout DragonFly_RELEASE_3_0

To see the available remote branches:

# cd /usr/src 
# git pull
# git branch -r

The leading edge (development trunk) version of the system will be the "master".

Build and upgrade process

The build process requires some time to build all the userland programs and the DragonFly BSD kernel. Once built, the next step is to install everything and make the upgrade target. No configuration files in /etc are changed by this process. More details can be found in build(7) manpage.

% cd /usr/src
% make buildworld
% make buildkernel
% make installkernel
% make installworld
% make upgrade
(reboot)

Note: You may use a concurrent build if you have a SMP (a machine with several cores or CPUs). You may specify -j x parameter to make where x is the number of CPUs + 1. If you run DragonFly 2.12 or higher the kernel will auto-detect the number of CPUs your computer has and activate them all if possible. To find out how many CPUs your computer has:

% sysctl hw.ncpu
hw.ncpu: 2

An explanation of each step follows.

If your computer fails to boot the new kernel, you can always select 'Boot DragonFly using kernel.old' in the loader menu, so that the old kernel is loaded instead of the new one.

Additional upgrading instructions can be found in /usr/src/UPDATING in the source tree. They can also be found online, here