Installing a KVM Guest Using Virtual Machine Manager

The RUCKUS IoT Controller can be installed on a KVM guest using Virtual Machine Manager.
  1. Download the RUCKUS IoT Controller distribution package in the .tar file format from the RUCKUS Support website at https://support.ruckuswireless.com.
  2. Use the tar -xvf filename.tar command to obtain the qcow2 image file and template file.
  3. Open the Virtual Machine Manager.
  4. From the Virtual Machine Manager menu, select File > Create a New Virtual Machine.

    Virtual Machine Manager Menu

    The New VM dialog box is displayed.
  5. Enter the name of the virtual machine, select Import existing disk image, and click Forward.

    New VM Dialog Box Step 1

  6. Enter the path of the .qcow image, the operating system type, and the version number, and click Forward.

    New VM Dialog Box Step 2

  7. Select the memory size of RAM (in MB) and the number of central processing units (CPUs) for the virtual machine, and click Forward.

    New VM Dialog Box Step 3

  8. Select Customize configuration before install, and click Finish.

    New VM Dialog Box Step 4

    Note: Recommended clock speed is 3.1Ghz.

    The RUCKUS IoT Controller installation on the virtual manager begins.
  9. After the installation has completed, open the Virtual Machine Manager. Select Disk in the left pane and information about the disk is displayed. Expand Advanced options and ensure that the disk bus is IDE and the storage format is qcow2.

    Virtual Disk Configuration

  10. Select Boot Options in the left pane. Ensure that Start virtual machine on host boot up and Enable boot menu are selected. Select Hard Disk and click Apply.

    Boot Options Configuration

  11. Log in to the RUCKUS IoT Controller using the username and password.

    RUCKUS IoT Controller Login Prompt

  12. Enter 1 in the Enter Choice field to get the IP address of the virtual machine.
    This information is needed to access the RUCKUS IoT Controller Initialization page.

    Displaying the IP Address

    To configure N+1 on the RUCKUS IoT Controller, enter 5 in the Enter Choice field. Refer to "Configuring N+1" in the RUCKUS IoT Controller Configuration Guide to complete this configuration.

  13. Open a web browser on your host machine and enter the IP address of the VM in the address bar.
    HTTP and HTTPS on ports 80 and 443 are supported.

    The Initialization page is displayed.

    Initialization Page

    Initialization First page
  14. Select the required services and click Next.

    Inital VM and IP Configurations

  15. Confirm the configuration information and click Next.
    The RUCKUS IoT ControllerInitialization page is displayed.

    Confirming the Password

  16. Enter a new password and re-enter the new password in the Confirm Password field. Click Start.
  17. The End-user License Agreement page is displayed. Click Accept to accept the RUCKUS IoT Controller license.

    End-user License Agreement Page

You are ready to configure and start the RUCKUS IoT Controller services. Refer to the RUCKUS IoT Controller Configuration Guide for more information.
Parent topic: Installing RUCKUS IoT Controller on Hypervisor