更新系统之前， 请先阅读 /usr/src/UPDATING 文件， 以便了解重新编译 world 之前需要了解哪些事情或注意事项， 然后再执行以下步骤。

这里假定从一个包含旧编译器、 旧内核、旧 world 和旧配置文件的较早 FreeBSD 版本上的升级步骤。 “World” 包含了核心系统二进制文件， 库和程序文件。 编译器是 “world” 的一部分， 但也有一些需要特别注意的问题。

此外， 我们还假定您已获得最新版本的源代码。 如果你还没来得及更新源代码， 请参照 Section 23.6, “同步源代码” 获取同步到最新版本的详细帮助。

从源代码更新系统的步骤有时会比初看上去更麻烦一些， 另一方面， FreeBSD 开发者有时又不得不修改推荐更新步骤， 特别是当出现无法避免的依赖关系的时候。 本节余下部分将介绍目前推荐的更新步骤及其原因。

所有成功的更新操作都必须解决以下这些问题：

这两个问题就是为什么需要按照 buildworld 、 buildkernel 、 installkernel ， installworld 的顺序来更新的原因， 除此之外还有：

由于这些问题的存在， 一般会建议以下更新步骤。 请注意， 对于特定的更新步骤可能需要一些额外的步骤， 但这些核心步骤应该会在很长一段时间保持不变的：

注意， 如果您正从一个主要 FreeBSD 发行版的分支升级， 例如， 从 9.0 升级到 9.1 ， 则上述步骤可能就没那么必要了， 因为它不太可能遇到严重的编译器、 内核、 用户空间程序和配置文件不匹配的情况不匹配的情况。 旧的 make world 命令可能能完成编译， 并按照新内核， 并有可能正常完成这种次要版本的升级工作。

但是， 在大主版本升级时， 不按前面所介绍的步骤进行升级则很有可能需要一些问题。

值得一提的是， 很多升级过程可能需要额外的附加步骤， 例如， 重命名或删除 installworld 之前的一些特定文件。 仔细阅读 /usr/src/UPDATING 文件， 特别是它结尾部分推荐的升级步骤。

由于这个过程是不断演化的过程中， 开发者可能会发现某些不能完全避免的不匹配方面的问题。 不过幸运的是， 目前这个推荐升级步骤应该会在很长的时间内保持不变。

总之， 目前推荐的从源代码升级 FreeBSD 的步骤是：

# cd /usr/src
# make buildworld
# make buildkernel
# make installkernel
# shutdown -r now

在 installkernel 完成后， 需要重启进入单用户模式（loader 加载器提示符后输入 boot -s）。

如果使用 UFS 文件系统， 运行：

# mount -u /
# mount -a -t ufs

如果使用的是 ZFS 文件系统 （假设 zpool 存储池名为 zroot）， 则运行：

# zfs set readonly=off zroot
# zfs mount -a

然后运行：

# adjkerntz -i
# mergemaster -p
# cd /usr/src
# make installworld
# mergemaster
# make delete-old
# reboot
# make delete-old-libs

在执行任何更新操作之前， 请务必阅读 /usr/src/UPDATING 文件。 这个文件包含了更新可能存在的潜在问题的重要信息， 或可能指定了某些命令的执行顺序。 如果 UPDATING 中出现的内容与本文相冲突， 请按 UPDATING 中的内容执行。

make(1) 可用的参数可以在 make.conf(5) 和 /usr/share/examples/etc/make.conf 中找到。 这些参数可以添加到 /etc/make.conf 文件中， 以控制 make(1) 的运行及其编译程序的方式。 请注意， 默认参数照顾到了性能与安全性， 变更默认参数值可能会产生严重后果， 但也可能会达到意想不到的效果。

/etc/make.conf 中的参数会影响到 make(1) 的每次执行， 包括 Ports Collection ， 用户自己写的 C 语言程序以及重新编译 FreeBSD 操作系统。

/etc/src.conf 文件控制从源代码构建操作系统的相关参数。 与 /etc/make.conf 不同， /etc/src.conf 仅控制构建 FreeBSD 操作系统本身。 有关这个文件的更多信息， 请参考 src.conf(5) 。 有时， 禁用那些看起来很不是必要的内核模块或编译选项也能有意想不到的效果。

/etc 目录中包含了大部分系统配置文件及系统启动脚本， 这些文件可能会因为 FreeBSD 版本的不同而有所差别。

一些配置文件日常运行时都要经常用到， 比如， /etc/group 文件。

有时作为安装过程的一部分， make installworld 会要求事先建立某些特定的用户或用户组， 在升级前它们可能并不存在， 因此 make buildworld 会先检查它们是否已存在。

解决的办法是在构建前 （pre-buildworld） 使用个带 -p 参数运行 mergemaster(8) 命令。 它只会更新在 buildworld 和 installworld 过程起关键性作用的文件。

# find / -group GID -print

您可能会考虑在单用户模式下编译系统。 重新安装涉及很多重要的系统文件， 包括所有基本系统的二进制文件、 库文件， 头文件等等。 在正在运行中的系统（尤其是大量用户在线时）更新将是自寻烦恼的行为。

另一种方法是在多用户模式编译系统， 然后切换到单用户模式进行安装。 如果使用这种方法， 可以在编译完成后， 以下命令， 这将会直接切换为单用户模式， 然后执行 installkernel 或 installworld 命令即可：

从正在运行的系统进入单用户模式使用：

# shutdown now

也可以重启系统， 然后在 boot 提示符下， 选择 “single user” 选项。 单用户模式启动完毕后会得到一个 shell 提示符， 执行：

# fsck -p
# mount -u /
# mount -a -t ufs
# swapon -a

这将会检查文件系统， 重新以读/写方式挂载 / ， 根据 /etc/fstab 里的记录挂载所有 UFS 文件系统， 最后启用交换分区。

# adjkerntz -i

随着系统重新构建的进行， 编译结果默认会放到 /usr/obj 中， 目录里的结构会对应 /usr/src 里的目录结构。

为了加快 make buildworld 过程， 并避免可能出现的依赖性问题， 如果这个目录已存在， 请删除它。

在 /usr/obj 中的某些文件可能设置了不可更改标志， 删除前必须先使用 chflags(1) 取消这些标志。

# cd /usr/obj
# chflags -R noschg *
# rm -rf *

要充分利用新系统， 您应该重新编译内核。 这是很有必然的， 因为特定的内存结构已经发生了改变， 像 ps(1) 和 top(1) 这样的程序可能无法正常工作， 除非内核与源代码树的版本是一样的。

要做到这一点最简单， 最安全的方式是构建和安装一个基于 GENERIC 配置文件的内核。 虽然 GENERIC 可能没有包含所有系统所需的设备驱动， 但它包含启动到系统启动到单用户模式所需的所有内容。 这是一个很好的测试新系统是否正常工作的方法。 从 GENERIC 启动， 校验完系统后， 就可以建立您自己的自定义内核了。

在 FreeBSD 上， 在构建新内核前完成 build world 是非常重要的。

# cd /usr/src
# make buildkernel KERNCONF=MYKERNEL
# make installkernel KERNCONF=MYKERNEL

如果您已把 kern.securelevel 调高到 1 或 以上 ， 而且还设置了 noschg 或相似标志到您的二进制内核上， 你可能会发现需要切换到单用户模式执行 installkernel 。 否则， 这两个命令在多用户模式下执行应该也不会有问题。 请参阅 init(8) 以了解更多关于 kern.securelevel 的信息； 参阅 chflags(1) 了解更多不同文件标志的信息。

您应该使用单用户模式测试新内核， 根据 Section 23.7.6, “切换到单用户模式” 中的说明去操作。

接下来， 我们使用 installworld 来安装新系统二进制文件：

# cd /usr/src
# make installworld

# make -DNO_PROFILE buildworld

# make -DNO_PROFILE installworld

重构的 world 将不会更新下某些目录， 如 /etc ， /var 和 /usr 目录下的新的或有变更的文件。

更新这些目录中的文件的最简单的方法是使用在 mergemaster(8) 。 为了避免出错， 请务必先备份 /etc 目录。

# cp -Rp /etc /etc.old

# mkdir /var/tmp/root
# cd /usr/src/etc
# make DESTDIR=/var/tmp/root distrib-dirs distribution

# cd /var/tmp/root
# find -d . -type d | xargs rmdir 2>/dev/null

# diff /etc/shells /var/tmp/root/etc/shells

# mkdir /var/tmp/root-`date "+%Y%m%d"`

由于 FreeBSD 的开发周期里， 偶尔会有些文件或内容会过时的情况。 这可能因为这个功能在其他地方实现， 或库版本号变更， 也可能是完全从系统中移除等等。 在更新系统时， 包括旧文件， 旧库文件， 旧目录， 它们都应该被从系统中移除， 这是有好处的， 这样可以保证系统稳定， 同时减少了不必要的磁盘空间及备份空间的浪费， 另外， 如果旧库或文件存在安全或稳定性问题， 系统更新它们可以保证安全， 同时防止因旧库导致的崩溃。 过时的文件， 目录， 库文件都会在 /usr/src/ObsoleteFiles.inc 中列出。 接下来， 将介绍如何删除这些文件。

在 make installworld 和 mergemaster 命令完成后， 可以使用以下命令检测过时的文件和库文件：

# cd /usr/src
# make check-old

如果检测到任何过时的文件， 则可以使用以下的命令移除：

# make delete-old

当删除每一个文件之前都会出现一个确认提示。 要跳过提示， 让系统自动删除这些文件， 可以设置 BATCH_DELETE_OLD_FILES 变量， 就像这样：

# make -DBATCH_DELETE_OLD_FILES delete-old

也可以使用 yes 命令配合管道实现类似目的：

# yes|make delete-old

确认一切都已正确完成后， 就可以使用 shutdown(8) 重启系统了：

# shutdown -r now

通用检测共享库依赖的工具 sysutils/libchk 和 sysutils/bsdadminscripts 可以通过 Ports Collection 安装。

过时的共享库与新共享库可能发生冲突， 会导致类似的警告消息：

/usr/bin/ld: warning: libz.so.4, needed by /usr/local/lib/libtiff.so, may conflict with libz.so.5
/usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may conflict with librpcsvc.so.5

为了解决这类问题， 需要确定是哪个 port 安装了这个库文件：

# pkg_info -W  /usr/local/lib/libtiff.so
  /usr/local/lib/libtiff.so was installed by package tiff-3.9.4
  # pkg_info -W /usr/local/lib/libXext.so
  /usr/local/lib/libXext.so was installed by package libXext-1.1.1,1

然后卸载， 重新编译和安装的该 port 。 可以使用 ports-mgmt/portmaster 工具自动化完成此过程。 在确认所有 ports 都已经重建， 并不再有需要依赖旧库的情况后， 执行以下命令删除它们：

# make delete-old-libs

你现在应该已经成功升级了 FreeBSD 。 恭喜。

如果进展不顺利， 很容易重建系统的某一部分。 例如， 在升级或合并 /etc 时不小心删除了 /etc/magic ， 这将会导致 file(1) 停止工作， 这种情况下， 可以执行以下命令进行修复：

# cd /usr/src/usr.bin/file
# make all install