How to Install FreeBSD 12.0 on the Vault

Last Updated On July 15, 2019
You are here:

Overview

As of writing this article FreeBSD 12.0 has a bug affecting the network interfaces on several models of Vaults. Here is a link to the bug report https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=235147. The workaround is fairly straightforward and can be done either during install or after.

Note: FreeBSD also inherited a bug from 11.2 which affects the FW1,FW2, and FW4A model Vaults. The workaround is simply changing the BIOS to UEFI. We have an article covering that here.

To Install FreeBSD 12.0 follow the FreeBSD 11.2 install guide (link) with the caveat below.

During a install

  • At the end of the install a “Manual Configuration” window opens
  • Select ‘Yes
  • Verify the command line is present
  • Edit the loader configuration file using the following command
# vi /boot/loader.conf
  • Verify loader.conf opens with a few lines already in place
  • Hit the ‘i‘ key to enable the insert function and ‘return‘ to make a new line
  • Add the following to the new, blank line
hw.pci.enable_msix=0
  • Hit ‘ESC‘ key
  • Type :wq to write the file and quit
  • Verify the command line prompt is present, then exit
# exit
  • Reboot the Vault
  • Verify the system boots into FreeBSD and the network interfaces now function as they should

Post-install

  • Verify FreeBSD boots and login
  • Verify the command line is present
  • Edit loader configuration file using the following command
# vi /boot/loader.conf
  • Verify loader.conf opens with a few lines already there
  • Hit the ‘i‘ key to enable the insert function and ‘return‘ to make a new line
  • Add the following to the new, blank line
hw.pci.enable_msix=0
  • Hit ‘ESC‘ key
  • Type ‘:wq‘ to write the file and quit
  • Verify the command line prompt is displayed and reboot
# reboot
  • Verify the system boots into FreeBSD and the network interfaces now function as they should

If you experience any issues, please feel free to reach out to us at: support@protectli.com.