FreeBSD Guest Notes: Difference between revisions

From Proxmox VE
Jump to navigation Jump to search
(Update to FreeBSD 9.3, FreeBSD has now Virtio drivers, remoce deprecated Information)
(Add note regarding space required for jails and building from source)
 
(7 intermediate revisions by 3 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.
:'''Note:''' This has been tested with FreeBSD 13.1 RELEASE.
 
==Pre-Install==
* Find the downloadable ([https://download.freebsd.org/releases/amd64/amd64/ISO-IMAGES/13.1/ amd64 dvd1.iso version]).
* Mimimum hardware ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-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 ([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
* 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


:'''Note:''' This has been tested with FreeBSD 9.3 RELEASE (and patch levels). Some steps have been removed as they have been deprecated in newer FreeBSD versions.
==Create VM==
==Create VM==
* Download the FreeBSD 9.3-RELEASE-amd64 DVD ISO (from [http://www.freebsd.org/where.html here]) and transfer it to your VM server.
* Use "Create VM" in GUI
* Create a new VM:
* In "Create: Virtual Machine" use these settings
** CPU: dual-socket or dual-core
** "General" - default settings
*** '''IMPORTANT:''' As of current PVE releases, you may need to set your CPU to '''qemu64''' rather than '''kvm64''' for FreeBSD to be able to boot.
** "OS"
** RAM: 2GB (minimum)
*** Set "ISO Image" to your downloaded ISO file
** Network: Intel e1000 (bridged) or Virtio
** "System" - default settings
** Create a 32GB primary disk (scsi, qcow2) or Virtio
** "Disks"
** Add FreeBSD 9.1-RELEASE-amd64 DVD ISO as an optical drive (scsi).
*** Set "Disk Size" to 8GB (or higher)
** "CPU"
*** dual-socket and/or dual-core
** "Memory" - 2GB (minimum)
** "Network" - Virtio


==Install FreeBSD==
==Install FreeBSD==
* Power on the VM.
* Start the VM.
* It should boot to the FreeBSD 9.1-RELEASE-amd64 DVD ISO.
* Boot menu with countdown will show - just wait and it should boot to the optical drive by default and start the installation
* System Components: Add "src".
* ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-start Installation guide])
* Disks: Guided, use entire disk.
* ([https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-components System Components])
* Network: Use ipv4 only (unless you also use ipv6).
** 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.
* Services: Add ntpd.
* This should leave you with FreeBSD 9.1-RELEASE installed on the 32GB primary drive.
* Change any other configurations offered. When you get to "Final Configuration" you can select Exit
* Shut down the VM after installation.
* This should leave you with FreeBSD 13.1 RELEASE installed on the primary drive
* Remove the ISO from the VM's optical drive (set to empty).
* Reboot
* Verify the VM's boot order is set to the primary hard disk first.
* 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==
==First Boot==
* Power on the VM and log in.
* Power on the VM and log in.
If you have choosed to use VirtIO devices you can check their existence with dmesg:
<pre>
dmesg | egrep '(vtnet|vtblk)'
vtblk0: <VirtIO Block Adapter> on virtio_pci1
vtblk0: 16384MB (33554432 512 byte sectors)
vtnet0: <VirtIO Networking Adapter> on virtio_pci2
vtnet0: Ethernet address: b2:ae:f1:97:36:52
</pre>
* Set the time:
* Set the time:
<pre>
<pre>
Line 45: Line 62:
</pre>
</pre>
* Reboot
* Reboot
 
<pre>
== Links ==
reboot
* [http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html FreeBSD Handbook - Portsnap: a Ports Collection Update Tool]
</pre>
* [http://www.freebsd.org/cgi/url.cgi?ports/ports-mgmt/portmaster/pkg-descr freebsd.org - Port description for ports-mgmt/portmaster]

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