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. Convert the VMDK to VHD using a tool such as StarWind V2V Converter or QEMU disk image utility for Windows.
  3. From the Windows 10 Start menu, enter Settings, and press Enter.
    The Windows Settings page is displayed.
  4. Click Apps, and select Apps and Features.
  5. Under Related settings, select Programs and Features.
    The Uninstall or change program page is displayed.
  6. Select Turn Windows Features on or off.

    Windows Features

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

    Hyper-V Manager App

  9. Click Open.
    The Hyper-V Manager page is displayed.
  10. 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

  11. 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.
  12. In the Name field, enter the name of the virtual switch. You can enter additional information in the Notes field.
  13. 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
  14. 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 Initialization page is displayed.

    Intialization Page 1

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

    Initialization Page 2

  20. 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

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