Preparing for Installation
KVM CPU/IO Requirements
OS and Hardware Requirements
Required Software Packages
Ensure the latest software packages are installed for upgrade and bug fixes.
OS Versions
| OS | Toolkit |
|---|---|
| Debian 11 | libvirt-daemon-system, ovmf, qemu-system-x86, virtinst |
| Rocky Linux 8 | libvirt, edk2-ovmf, qemu-kvm, virt-install |
Install Required Packages
| OS | Command |
|---|---|
| Debian 11 |
sudo apt-get update sudo apt-get install <PKG_NAME> [<PKG_NAME> ...] |
| Rocky Linux 8 |
sudo dnf update sudo dnf install <PKG_NAME> [<PKG_NAME> ...] |
Networking
RUCKUS Virtual Edge needs at least one network interface to function, either a PCI passthrough or a virtio interface.
Skip this section if there is no requirement to use NIC PCI passthrough.
- Enable IOMMU support.
Note: You can check this by checking the status of the
/sys/kernel/iommu_groupsdirectory. If this directory exists and has content, IOMMU is likely enabled.Enabling IOMMU Support
- Auto-insert the
vfio-pcidriver at boot.echo 'vfio-pci' | sudo tee /etc/modules-load.d/vfio-pci.conf
- Enable user access to the
vfio device files.
Note: Ensure you log in using the user account that is going to execute the installation process and not the 'root' account.
For example, if the user $USER is the one that is going to execute the
.binfile.echo 'SUBSYSTEM=="vfio", OWNER="root", GROUP="kvm"' | sudo tee /etc/udev/rules.d/10-qemu-hw-users.rules sudo usermod -aG kvm "$USER"
- Edit
/etc/security/limits.conf, for example,sudo vi /etc/security/limits.confand add the two lines for the normal user that is going to execute the.binfile to unlimit memlock.foo soft memlock unlimited foo hard memlock unlimited
- Reboot the host after completing the preparation for PCI passthrough and verify:
- Skip this section if there is no
requirement to use virtio virtual network interfaces.
Use one of the following methods to create bridges for RUCKUS Virtual Edge.
- Using libvirt commands
and XML-based configurations.
Example: libvirt default network
- Manually create a bridge
using the following
commands:
sudo ip link add name vse-br0 type bridge sudo ip link set dev vse-br0 up
Add some host network interfaces, for example, eth0 to the bridge
sudo ip link set dev eth0 master vse-br0
Add NAT/DHCP services for devices that connect to the bridge.
A bridge named
vse-br0is created and ready for virtio interfaces to attach.
- Using libvirt commands
and XML-based configurations.
- Enable permission to access
bridges.
This applies to both methods listed in the previous step.
- Provide permission to create network tunnel devices.