FreeBSD Guest Notes: Difference between revisions

From Proxmox VE
Jump to navigation Jump to search
No edit summary
(Add note regarding space required for jails and building from source)
 
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:HOWTO]]
[[Category:HOWTO]]
==Enable Virto==
Setting up a FreeBSD Guest on PVE.
'''WARNING: This part is currently in test - it may render your system un-bootable when you make changes to your <code>/etc/fstab</code>.'''
:'''Note:''' This has been tested with FreeBSD 13.1 RELEASE.
* Install virtio-kmod:
 
<pre>
==Pre-Install==
cd /usr/ports/emulators/virtio-kmod && make clean install
* Find the downloadable ([https://download.freebsd.org/releases/amd64/amd64/ISO-IMAGES/13.1/ amd64 dvd1.iso version]).
</pre>
* Mimimum hardware ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-hardware requirements])
* When prompted on each required package, accept defaults and OK.
** 2-4GB RAM
* Copy the virtio modules into <code>/boot/kernel</code> directory:
** 8 GB drive space
<pre>
*** Full install without jails will use at least 5GB
cp -Rp /usr/local/modules/* /boot/kernel/
*** If you will be using jails and building kernel from source, use at least 35GB
kldxref /boot/kernel
 
</pre>
==Create Install Media==
* Add the following to <code>/boot/loader.conf</code>:
* 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
<pre>
* Option 2: Using Proxmox GUI, local Storage > Upload file from your non-Proxmox machine
virtio_load="YES"
* Option 3: (for server without internet) Download ISO image and burn to DVD or save to USB drive then transfer to server
virtio_pci_load="YES"
 
virtio_blk_load="YES"
==Create VM==
if_vtnet_load="YES"
* Use "Create VM" in GUI
virtio_balloon_load="YES"
* In "Create: Virtual Machine" use these settings
</pre>
** "General" - default settings
* Enable virtio for disk by changing your <code>/etc/fstab</code> entries to use the '''vtbd''' prefix. Example:
** "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
* ([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