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

    The command-line interface (CLI) window with the admin prompt is displayed.

    Displaying the CLI Window

    Displaying the CLI Window
  12. Enter help at the admin prompt to view the list of available commands.

    Viewing the Available Commands

    Viewing the Available Commands
  13. Enter ip info at the admin prompt 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

  14. Open a web browser on your host machine and enter the IP address of the VM in the address bar.
    The Initialization page is displayed.

    Initialization Page

  15. Select I agree to the terms and conditions stated above and click Next.

    Inital VM and IP Configurations

  16. Select Primary Node to configure the controller as standalone or select Secondary Node to add the controller to the HA cluster. Enter the Hostname, Time Zone, and select the IP Configuration (DHCP or Static), and click Next.
    The RUCKUS IoT Controller Initialization page is displayed.

    Confirming the Password

  17. Enter a new password and re-enter the new password in the Confirm Password field. Click Start.
  18. 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