Installing the RUCKUS Virtual Edge on a Kernel-based Virtual Machine Hypervisor

This section describes how to install the RUCKUS Virtual Edge on a KVM hypervisor.
  1. Download the vRUCKUS-Edge-2.2.0.xxxx.bin file that includes the QCOW2 and tool script.
  2. Copy the image to the KVM.
  3. Open the terminal window.
  4. Make the image bin file executable by entering the following command: ./vRUCKUS-Edge-2.2.0.xxxx.bin. For example: use 2.2.0.924 version.
    The End User License Agreement (EULA) is displayed.

    RUCKUS Virtual Edge End User License Agreement

  5. After checking the EULA, enter y to accept the agreement.
    The Virtual Edge installation process begins.

    Virtual Edge Installation Process

  6. In the new RUCKUS Virtual Edge, configure the following:
    • Enter 1 and enter a New name for the RUCKUS Virtual Edge.
    • Enter 2 and enter the New directory (absolute path). The location where you want to store the RUCKUS Virtual Edge disk image.
    • Enter 4 to confirm the name and directory for the new RUCKUS Virtual Edge device.
  7. Enter Y to confirm select and continue.
  8. Configure the number virtual CPUs and memory size required for the RUCKUS Virtual Edge VM host.
    • Selected vCPUs
    • Selected memory size

    Configuring vCPUs and Memory Size

  9. (Optional) You must configure at least one network interface for RUCKUS Virtual Edge to operate. The interface can either be a PCI or a virtio interface, or a combination of both. To configure a PCI interface, enter the PCI ID corresponding to the selected PCI passthrough interface.
    The address of the selected PCI interface is displayed.
  10. Enter the PCI interface ID and enter 4 at the Confirm Selection prompt.
  11. Enter y to Confirm selection and continue.

    Configuring PCI Interface

  12. (Optional) If you choose to add a virtio interface, type 1 and press enter. Else, proceed to Step 14.
  13. At the Host bridge name for the virtio connection prompt, type the bridge name and press enter.
  14. Type 3 and press enter.
  15. At the Confirm and continue? prompt, type y and press enter.

    Virtio Interface Selection

  16. (Optional) Rebind network device drivers. Enter ./dpdk-devbind.py --status-dev net to view the status of the PCI passthrough devices.
    Note: Skip Step 16 and Step 17 if no PCI passthrough interface was selected in Step 9.
  17. Enter sudo ./dpdk-devbind.py -b vfio-pci <PCI device ID> to rebind the selected PCI passthrough device to the vfio-pci usage.

    Rebinding the PCI Passthrough Device

    After the RUCKUS Virtual Edge script is deployed, by default, the Edge VM is powered off.
  18. Manually power on the virtual machine using the command: virsh start [<VSE_NAME>].

    Virtual Edge Setup on KVM

    You have completed setting up the RUCKUS Virtual Edge on the KVM hypervisor.