Difference between revisions of "FreeBSD Guest Notes"

From Proxmox VE
Jump to navigation Jump to search
(Add note regarding space required for jails and building from source)
 
(37 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
[[Category:HOWTO]]
 
[[Category:HOWTO]]
−
Tweaks and tips for better performance with FreeBSD on KVM.
+
Setting up a FreeBSD Guest on PVE.
−
==Enable Virto==
+
:'''Note:''' This has been tested with FreeBSD 13.1 RELEASE.
−
'''WARNING: This part is currently in test - it may render your system un-bootable when you make changes to your <code>/etc/fstab</code>.'''
+
 
−
* Install virtio-kmod:
+
==Pre-Install==
−
<pre>
+
* Find the downloadable ([https://download.freebsd.org/releases/amd64/amd64/ISO-IMAGES/13.1/ amd64 dvd1.iso version]).
−
cd /usr/ports/emulators/virtio-kmod && make clean install
+
* Mimimum hardware ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-hardware requirements])
−
</pre>
+
** 2-4GB RAM
−
* When prompted on each required package, accept defaults and OK.
+
** 8 GB drive space
−
* Copy the virtio modules into <code>/boot/kernel</code> directory:
+
*** Full install without jails will use at least 5GB
−
<pre>
+
*** If you will be using jails and building kernel from source, use at least 35GB
−
cp -Rp /usr/local/modules/* /boot/kernel/
+
 
−
kldxref /boot/kernel
+
==Create Install Media==
−
</pre>
+
* Option 1: (IDEAL) Using Proxmox GUI, local Storage > Download from URL, copy in ([https://download.freebsd.org/releases/amd64/amd64/ISO-IMAGES/13.1/ ISO link]), query it to get file name, and use the contents of the provided ([https://download.freebsd.org/releases/amd64/amd64/ISO-IMAGES/13.1/ CHECKSUM file]) to verify the download
−
* Add the following to <code>/boot/loader.conf</code>:
+
* Option 2: Using Proxmox GUI, local Storage > Upload file from your non-Proxmox machine
−
<pre>
+
* Option 3: (for server without internet) Download ISO image and burn to DVD or save to USB drive then transfer to server
−
virtio_load="YES"
+
 
−
virtio_pci_load="YES"
+
==Create VM==
−
virtio_blk_load="YES"
+
* Use "Create VM" in GUI
−
if_vtnet_load="YES"
+
* In "Create: Virtual Machine" use these settings
−
virtio_balloon_load="YES"
+
** "General" - default settings
−
</pre>
+
** "OS"
−
* Enable virtio for disk by changing your <code>/etc/fstab</code> entries to use the '''vtbd''' prefix. Example:
+
*** Set "ISO Image" to your downloaded ISO file
 +
** "System" - default settings
 +
** "Disks"
 +
*** Set "Disk Size" to 8GB (or higher)
 +
** "CPU"
 +
*** dual-socket and/or dual-core
 +
** "Memory" - 2GB (minimum)
 +
** "Network" - Virtio
 +
 
 +
==Install FreeBSD==
 +
* Start the VM.
 +
* Boot menu with countdown will show - just wait and it should boot to the optical drive by default and start the installation
 +
* ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-start Installation guide])
 +
* ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-components System Components])
 +
** If you will be installing jail templates, make sure to check "System source tree"
 +
* Network
 +
** Choose vtnet0 VirtIO Networking Adapter
 +
** Use ipv4 ONLY, unless you also use ipv6
 +
* Disks
 +
** Auto (ZFS) Guided Root-on-ZFS, stripe virtual device, choose vtbd0 VirtIO Block Device
 +
** If you are planning to also transfer the image to another cloud host as a standalone OS, make sure they support ZFS, or change your selections accordingly
 +
* Services: Add ntpd.
 +
* Change any other configurations offered. When you get to "Final Configuration" you can select Exit
 +
* This should leave you with FreeBSD 13.1 RELEASE installed on the primary drive
 +
* Reboot
 +
* After reboot, check:
 +
** In VM > Hardware remove the ISO from the VM's optical drive (set to empty)
 +
** Verify in VM > Options the boot order is set to the primary hard disk first
 +
 
 +
==First Boot==
 +
* Power on the VM and log in.
 +
* Set the time:
 
<pre>
 
<pre>
−
# Device        Mountpoint      FStype  Options Dump    Pass#
+
ntpdate -s pool.ntp.org
−
/dev/vtbd0p2    /              ufs    rw      1      1
 
−
/dev/vtbd0p3    none            swap    sw      0      0
 
 
</pre>
 
</pre>
−
* Enable virtio for network by changing the <code>ifconfig_em0="DHCP"</code> line in <code>/etc/rc.conf</code> to:
+
* Update the system:
 
<pre>
 
<pre>
−
ifconfig_vtnet0="DHCP"
+
freebsd-update fetch
 +
freebsd-update install
 
</pre>
 
</pre>
−
* Shutdown the VM
+
* Reboot
 
<pre>
 
<pre>
−
shutdown -p now
+
reboot
−
</pre>
 
−
* Change network and disk drivers to virtio.
 
−
* Power on the VM.
 
−
* Verify that virtio is loading:
 
−
<pre>
 
−
kldstat
 
−
 
 
−
Id Refs Address            Size    Name
 
−
1  12 0xffffffff80200000 11cdab0  kernel
 
−
2    5 0xffffffff813ce000 4ca0    virtio.ko
 
−
3    1 0xffffffff813d3000 5880    virtio_pci.ko
 
−
4    1 0xffffffff813d9000 5010    virtio_blk.ko
 
−
5    1 0xffffffff813df000 aeb0    if_vtnet.ko
 
−
6    1 0xffffffff813ea000 3210    virtio_balloon.ko
 
 
</pre>
 
</pre>

Latest revision as of 19:03, 6 January 2023

Setting up a FreeBSD Guest on PVE.

Note: This has been tested with FreeBSD 13.1 RELEASE.

Pre-Install

  • Find the downloadable (amd64 dvd1.iso version).
  • Mimimum hardware (requirements)
    • 2-4GB RAM
    • 8 GB drive space
      • Full install without jails will use at least 5GB
      • If you will be using jails and building kernel from source, use at least 35GB

Create Install Media

  • Option 1: (IDEAL) Using Proxmox GUI, local Storage > Download from URL, copy in (ISO link), query it to get file name, and use the contents of the provided (CHECKSUM file) to verify the download
  • Option 2: Using Proxmox GUI, local Storage > Upload file from your non-Proxmox machine
  • Option 3: (for server without internet) Download ISO image and burn to DVD or save to USB drive then transfer to server

Create VM

  • Use "Create VM" in GUI
  • In "Create: Virtual Machine" use these settings
    • "General" - default settings
    • "OS"
      • Set "ISO Image" to your downloaded ISO file
    • "System" - default settings
    • "Disks"
      • Set "Disk Size" to 8GB (or higher)
    • "CPU"
      • dual-socket and/or dual-core
    • "Memory" - 2GB (minimum)
    • "Network" - Virtio

Install FreeBSD

  • Start the VM.
  • Boot menu with countdown will show - just wait and it should boot to the optical drive by default and start the installation
  • (Installation guide)
  • (System Components)
    • If you will be installing jail templates, make sure to check "System source tree"
  • Network
    • Choose vtnet0 VirtIO Networking Adapter
    • Use ipv4 ONLY, unless you also use ipv6
  • Disks
    • Auto (ZFS) Guided Root-on-ZFS, stripe virtual device, choose vtbd0 VirtIO Block Device
    • If you are planning to also transfer the image to another cloud host as a standalone OS, make sure they support ZFS, or change your selections accordingly
  • Services: Add ntpd.
  • Change any other configurations offered. When you get to "Final Configuration" you can select Exit
  • This should leave you with FreeBSD 13.1 RELEASE installed on the primary drive
  • Reboot
  • After reboot, check:
    • In VM > Hardware remove the ISO from the VM's optical drive (set to empty)
    • Verify in VM > Options the boot order is set to the primary hard disk first

First Boot

  • Power on the VM and log in.
  • Set the time:
ntpdate -s pool.ntp.org
  • Update the system:
freebsd-update fetch
freebsd-update install
  • Reboot
reboot
Retrieved from "https://pve.proxmox.com/mediawiki/index.php?title=FreeBSD_Guest_Notes&oldid=11552"