Skip to content

Latest commit

 

History

History
191 lines (113 loc) · 4.26 KB

controller-vm-installation.rst

File metadata and controls

191 lines (113 loc) · 4.26 KB
Raw

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.io/netris-controller3.qcow2
  1. Download VM definition file.
cd /etc/libvirt/qemu

sudo wget http://img.netris.io/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