Virtual Machine Installation

Requirements

Minimal system requirements for the VM:

  • CPU - 4 Core

  • RAM - 4 Gb

  • Disk - 100Gb

  • Network - 1 virtual NIC

Recommended system requirements for the VM:

  • CPU - 8 Core

  • RAM - 16 Gb

  • Disk - 100Gb

  • Network - 1 virtual NIC

KVM Hypervisor Installation

If KVM is not already installed, install Qemu/KVM on the host machine (example provided for Ubuntu Linux 18.04)

sudo apt-get install virt-manager

VM Controller Installation

  1. Download the Netris Controller image. (contact Netris support for repository access permissions).

cd /var/lib/libvirt/images

sudo wget http://img.netris.ai/netris-controller3.qcow2
  1. Download VM definition file.

cd /etc/libvirt/qemu

sudo wget http://img.netris.ai/netris-controller3.xml
  1. Define the KVM virtual machine

sudo virsh define netris-controller3.xml

Note

Netris Controller virtual NIC will bind to the “br-mgmt” interface on the KVM host machine. See below for the network interface configuration example.

Example: Network configuration on host (hypervisor) machine.

Note

replace <Physical NIC>, <host server management IP/prefix length> and <host server default gateway> with the correct NIC and IP for your host machine.

sudo vim /etc/network/interfaces
#Physical NIC connected to the management network
auto <Physical NIC>
iface <Physical NIC> inet static
                        address 0.0.0.0/0

#bridge interface
auto br-mgmt
iface br-mgmt inet static
                        address <host server management IP/prefix length>
                        gateway <host server default gateway>
                        bridge-ports <Physical NIC>

source /etc/network/interfaces.d/*
sudo ifreload -a
  1. Set the virtual machine to autostart and start it.

sudo virsh autostart netris-controller
sudo virsh start netris-controller

Accessing the Netris Controller

By default, Netris Controller will obtain an IP address from a DHCP server.

Below steps describe how to configure a Static IP address for the Netris Controller.

  1. Connecting to the VM console.

default credentials. login: netris password: newNet0ps

sudo virsh console netris-controller

Note

Do not forget to change the default password (using passwd command).

  1. Setting a static IP address.

Edit network configuration file.

sudo vim /etc/network/interfaces

Example: IP configuration file.

# The loopback network interface
auto lo
iface lo inet loopback


# The primary network interface
auto eth0
iface eth0 inet static
        address <Netris Controller IP/prefix length>
        gateway <Netris Controller default gateway>
        dns-nameserver <a DNS server address>

source /etc/network/interfaces.d/*

Reload the network config.

sudo ifreload -a

Note

Make sure Netris Controller has Internet access.

  1. Reboot the controller

sudo reboot

After reboot, the Netris Controller GUI should be accessible using a browser. Use netris/newNet0ps credentials.

Netris Credentials

Replacing the SSL certificate

  1. Replace the below file with your SSL certificate file.

/etc/nginx/ssl/controller.cert.pem;
  1. Replace the below file with your SSL private key.

/etc/nginx/ssl/controller.key.pem;
  1. Restart Nginx service.

systemctl restart nginx.service