HowTo Install NEO as a VM over Hyper-V Using Windows 2012R2

Version 4

    This post lists the procedure for installing NEO as a VM over Hyper-V using Windows 2012-R2.

    The example below was performed using NEO version 1.7.

     

    References

     

    Setup

    • Windows 2012 R2 enabled with Hyper-V
    • Management Connection to the Network

     

    Configuration

    1. Get the NEO-VM in VHDK format via MyMellanox Portal (click here) to the Windows server. To ease the process, extract the content of the zip file into C:\Users\Public\Documents\Hyper-V\Virtual hard disk.

     

     

    2. Launch Hyper-V, click "Virtual Switch Manager", and create a Management Virtual Switch for the new NEO VM.

    Provide a name and make sure you choose the right network adapter connected to the management network.

    In this case:

    • Name: NEO Management
    • External Network: Connection #4 (onboard port)

     

     

    3. Click Action --> New --> Virtual Machine...

     

    4. Click Next after the New Virtual Machine Wizard appears.

     

     

    5. Set the VM name and click Next.

     

     

    6. Select the generation of the VM (you can keep the default generation).

     

     

    7. Assign a memory; use the minimum of 2048MB.

     

     

    8. Select the Virtual Switch management configured before.

    In this case, the NEO Management network is being used.

     

     

    9. Connect to the NEO Virtual Hard Disk you downloaded, located in C:\Users\Public\Documents\Hyper-V\Virtual hard disks.

     

     

    10. Check the Summary and click Finish.

     

     

    11. Start the NEO VM.

     

    12. Use the default root credentials:

     

    username: root

    password: 123456

     

    Note: This VM is based on CentOS 6.5

    NEO-VM # cat /etc/redhat-release

    CentOS release 6.5 (Final)

     

    13. Set eth0 network interface.

    Note: In this example, the IP will be configured via DHCP.

    NEO-VM # cat /etc/sysconfig/network-scripts/ifcfg-eth0

    DEVICE="eth0"

    TYPE="Ethernet"

    ONBOOT="yes"

    BOOTPROTO="dhcp"

    HWADDR=00:15:5D:01:01:02

    MN_CONTROLLED="yes"

    NAME="eth0"

     

    Note: In case you are using automatic DHCP IP assignment, make sure to add the MAC address of eth0 to the DHCP server for IP discovery.

    You can also use static IP configuration. For example:

    NEO-VM # cat /etc/sysconfig/network-scripts/ifcfg-eth0

    DEVICE="eth0"

    TYPE="Ethernet"

    ONBOOT="yes"

    BOOTPROTO="static"

    HWADDR=00:15:5D:01:01:02

    MN_CONTROLLED="yes"

    NAME="eth0"

    IPADDR=10.20.1.100

    NETMASK=255.255.255.0

    GATEWAY=10.20.1.1

     

    14. Restart the networking service, and verify that eth0 interface has received an IP.

    NEO-VM # service network restart

    Shutting down interface eth0:                              [  OK  ]

    Shutting down loopback interface:                          [  OK  ]

    Bringing up loopback interface:                            [  OK  ]

    Bringing up interface eth0: 

    Determining IP information for eth0... done.

                                                               [  OK  ]

    NEO-VM # ifconfig

    eth0      Link encap:Ethernet  HWaddr 00:15:5D:01:01:02 

              inet addr:10.20.2.58  Bcast:10.20.255.255  Mask:255.255.0.0

              inet6 addr: fe80::215:5dff:fe01:102/64 Scope:Link

              UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1

              RX packets:18779 errors:0 dropped:0 overruns:0 frame:0

              TX packets:2606 errors:0 dropped:0 overruns:0 carrier:0

              collisions:0 txqueuelen:1000

              RX bytes:8284197 (7.9 MiB)  TX bytes:274041 (267.6 KiB)

     

    lo        Link encap:Local Loopback 

              inet addr:127.0.0.1  Mask:255.0.0.0

              inet6 addr: ::1/128 Scope:Host

              UP LOOPBACK RUNNING  MTU:16436  Metric:1

              RX packets:5955 errors:0 dropped:0 overruns:0 frame:0

              TX packets:5955 errors:0 dropped:0 overruns:0 carrier:0

              collisions:0 txqueuelen:0

              RX bytes:3782218 (3.6 MiB)  TX bytes:3782218 (3.6 MiB)

     

    15. Verify that NEO service and HTTPd service are running.

    NEO-VM # /opt/neo/neoservice status

    neo-access-credentials (pid  1133) is running...

    neo-controller (pid  1105) is running...

    neo-device-manager (pid  1185) is running...

    neo-eth-discovery (pid  1212) is running...

    neo-ib (pid  1235) is running...

    neo-ip-discovery (pid  1258) is running...

    neo-monitor (pid  1287) is running...

    neo-performance (pid  1316) is running...

    neo-provisioning (pid  1343) is running...

    neo-solution (pid  1377) is running...

    neo-virtualization (pid  1404) is running...

     

    NEO-VM # service httpd status

    httpd (pid  1072) is running...

     

    16. Open a browser on your PC and type the IP address or the NEO VM hostname.

     

    http://NEO-VM/neo

     

    17. Type the default NEO username and password

     

    username: admin

    password: 123456

     

     

     

    18. In order to get started with NEO GUI, start by adding network elements. For more information, you can refer to HowTo Add Network Element in Mellanox NEO.

     

    19. Make sure you have at least 10GB disk space for NEO VM, refer to Troubleshooting Guidelines for Mellanox NEO  to see how to enlarge the disk space.