Installing RUCKUS IoT Controller on Hyper-V

The RUCKUS IoT Controller can be installed on Hyper-V using a VHD file.
Parent topic: Installing RUCKUS IoT Controller on Hypervisor

Installing Hyper-V

  1. Extract the VMDK file from the .OVA file using a zip extractor application such as 7-Zip, WinZip, WinRAR, and so on.
  2. Download the QEMU file for Windows from the following link https://www.qemu.org/download/#windows.
  3. Install QEMU or extract the ZIP version to a preferred directory.
  4. Open command prompt in the folder that contains your .vmdk file and execute the following command qemu-img.exe convert -f vmdk input.vmdk -O vpc -o subformat=dynamic output.vhd where input.vmdk represents actual VMDK filename, and output.vhd represents the desired name for the converted VHD file.

    After completion, you will have a VHD file ready for use with Hyper-V.

  5. From the Windows 10 Start menu, enter Settings, and press Enter.
    The Windows Settings page is displayed.
  6. Click Apps, and select Apps and Features.
  7. Under Related settings, select Programs and Features.
    The Uninstall or change program page is displayed.
  8. Select Turn Windows Features on or off.

    Windows Features

  9. Select Hyper-V, and click OK.
  10. From the Windows 10 Start menu, enter Hyper-V Manager, and press Enter.

    Hyper-V Manager App

  11. Click Open.
    The Hyper-V Manager page is displayed.
  12. Click the Hyper-V host computer name in the left pane, and select Virtual Switch Manager from the Actions list in the right pane.

    The Virtual Switch Manager dialog box is displayed.

    Creating Virtual Switch

  13. Select the type of virtual switch (External, Internal or Private), click Create Virtual Switch, and click OK. .
    The Virtual Switch Properties dialog box is displayed.
  14. In the Name field, enter the name of the virtual switch. You can enter additional information in the Notes field.
  15. Under Connection type, select External network, Internal network, or Private network. If you select External network, select the type of network adapter you want to use, and select the Allow management operating systems to share the network adapter check box.

    Selecting the Network

    Selecting the Network
  16. Click Apply.

Creating a New Virtual Machine

  1. After installing Hyper-V on your computer, you can create new virtual machine. To create Virtual Machine, type Hyper-V Manager in the search box situated on the taskbar below and press ENTER.
  2. From the Windows 10 Start menu, enter Hyper-V Manager, and press Enter.
    The Hyper-V Manager page is displayed.
  3. Click Action tab, select New > Virtual Machine.
    The New Virtual Machine Wizard is displayed. You must complete each of the virtual machine configuration options through the wizard.
  4. Under Specify Name and Location, in the Name field, enter the name of the VM. Either store the VM in the default location or select the Store the virtual machine in a different location check box, and click Browse to select a different location.

    Specify Name and Location Wizard Page

  5. Click Next.
  6. Under Specify Generation, select Generation 1 or Generation 2. It is recommended to select Generation 1, because Generation 1 VMs support 32-bit and 64-bit guest operating systems and BIOS-based architectures.

    Specify Generation Wizard Page

  7. Click Next.
  8. Under Assign Memory, in the Startup memory field, enter the amount of memory that will be assigned to the VM (4096 MB as it is minimum RAM required for RUCKUS IoT controller). Select the Use Dynamic Memory for this virtual machine check box to save memory.

    Assign Memory Wizard Page

  9. Click Next.
  10. Under Configure Networking, select the connection that will be used when connecting the VM to the network. If you have not created a virtual switch earlier, select Not Connected.
    Note: Use the default switch for the internal network, and use a different virtual switch with an external network.

    Configure Networking Wizard Page

  11. Click Next.
  12. Under Connect Virtual Hard Disk, select Use an existing virtual hard disk to attach an existing virtual hard disk in VHD or VHDX format, and click Browse to select the location of the virtual hard disk.

    Connect Virtual Hard Disk Wizard Page

  13. Click Finish.
  14. Open the VM in Hyper-V Manager and from the Actions list in the right pane, click Settings. Confirm the displayed VM configuration settings such as number of PROCESSOR is 4, RAM size is 4096 MB, and HDD size is 100 GB, click Apply, and click OK.

    Confirming the VM Settings

    The RUCKUS IoT Controller login prompt is displayed.

    RUCKUS IoT Controller Login Prompt

  15. Log in to the virtual machine using the username and password.
    The command-line interface (CLI) window with the admin prompt is displayed.

    Displaying the CLI Window

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

    Viewing the Available Commands

    Viewing the Available Commands
  17. 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

  18. Open a web browser on your host machine and enter the IP address of the VM in the address bar.

    The IoT Controller Initialization page is displayed.

    IoT Controller Initialization Page 1

  19. Click Accept and Continue to agree the terms.

    IoT Controller Initialization Page 2

  20. Configure the Network Settings. Enter the Hostname. Select Primary Node to configure the controller as standalone or select Secondary Node to add the controller to the HA cluster. Select the IP Configuration (DHCP or Static), and click Next.

    Confirming the Password

  21. Configure the Time & Admin. Enter the values for Timezone and NTP Address. In the Create Admin Password, enter new password and re-enter the new password in the Confirm Password field. Enable the toggle switch to answer the security questions. These answers help you to recover your password in case you forget it. Click Next.
    Note: If you enable High Availability (HA) on the RUCKUS IoT Controller, ensure that the admin password is the same on both the primary and secondary nodes.
  22. Review the configurations and click Finish and Start.

    Reviewing and Starting the Services

    Reviewing and Starting the Services
  23. The End-user License Agreement page is displayed. Click Accept and Start 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.