SoftGate Installation

Hardware Requirements

  • 8 CPU cores

  • 16 GB RAM

  • 300 GB HDD

SoftGate software provisioning

Requires freshly installed Ubuntu Linux 22.04 LTS and internet connectivity.

Note

Netris controller ships with two SoftGate nodes pre-defined in the Default site. (softgate1-default, softgate2-default). We recommend using these if you are new to Netris. Alternatively, you can learn how to define new SoftGate nodes here: “Adding SoftGates”.

  1. Navigate to the Net–>Inventory section and click the three vertical dots (⋮) on the right side of the SoftGate node you are provisioning. Then click Install Agent and copy the one-line installer command to your clipboard.

../_images/softgate-install-agent.png
  1. Paste the one-line install command on your SoftGate node as an ordinary user. (keep in mind that one-line installer commands are unique for each node)

../_images/softgate-provisioning-cli-output.png

Note

Please note that Netris replaces Netplan with regular ifupdown and attempts to migrate any prior configuration to /etc/network/interfaces.

  1. Handoff Netris the bond0 interface for further automatic operations. Netris will automatically create necessary subinterfaces under your bond0 interface. (bond0.<xyz>). But you need to manually configure which physical interfaces should bind under the bond0 interface. Netris will only make changes to your bond0 and loopback interfaces; all other interfaces will remain as you describe in /etc/network/interfaces.

[email protected]:~$ sudo vim /etc/network/interfaces
 # The loopback network interface
 auto lo
 iface lo inet loopback

 # Physical port on SoftGate node connected to a TRUNK port of your network
 auto ens<X>
 iface ens<x> inet static
     address 0.0.0.0/0

# Optionally you can add more physical interfaces under your bond0
 auto ens<Y>
 iface ens<Y> inet static
     address 0.0.0.0/0

 # Bond interface
 auto bond0
 iface bond0 inet static
     address 0.0.0.0/0
     bond-slaves ens<X> ens<Y> # Please replace the ensX/Y with actual interface names present in the OS.
     bond-mode active-backup # Optional, please adjust the bonding mode according to the desired functionality.

 source /etc/network/interfaces.d/*
  1. Ensure that SoftGate node will maintain IP connectivity with Netris Controller after reboot.

[email protected]:~$ sudo vim /etc/network/interfaces
# The management network interface
auto ensZ
iface ensZ inet static
    address <Management IP address/prefix length>
    up ip route add <Controller address> via <Management network gateway> # Please delete this line if Netris Controller is located in the same network with the SoftGate node.
  1. Reboot the SoftGate

[email protected]:~$ sudo reboot

Once the server boots up, you should see its heartbeat going from Critical to OK in Net→Inventory, Telescope→Dashboard, and the SoftGate color will reflect its health in Net→Topology.

../_images/vpc-anywhere-softgates-green.png