Installing a Netris Controller on phoenixNAP BMC server¶
You can install the Netris controller almost on any 64-bit Linux host. You can use a single Netris controller for operating multiple sites (regions).
Minimum Hardware Requirements
RAM: 8 GB
CPU: 4 Cores
OS: Linux 64-bit
Deploy New Server
Deploy a new server in phoenixNAP BMC: select the Location, choose the server flavor (the smallest flavor, s0.d1.small, is enough for most users), type some name for Controller Server, request a new /31 public allocation for this instance.
In my example my host got a public IP address 126.96.36.199. While it is OK for users and nodes to refer to the Netris Controller through an IP address, we recommend using a DNS record (this way it will be easier to potentially move Netris Controller somewhere with a different IP address).
Below is example using Cloudflare DNS service. (same idea with any DNS software or service)
Ensure that newly created domain name indeed resolves into the right IP address of the machine that you are going to install the Netris Controller.
host netrisctl.netris.dev netrisctl.netris.dev has address 188.8.131.52
Install Netris Controller software and dependencies
curl -sfL https://get.netris.io | sh -s -- --ctl-hostname netrisctl.netris.dev --ctl-ssl-issuer letsencrypt
Netris Controller installer will stand up a K3S cluster and then will deploy Netris Controller on top of it using Helm Chart. The “–ctl-ssl-issuer” will instruct the installer to generate a Let’s Encrypt SSL certificate and the “–ctl-hostname” will hint for what domain name the certificate must be generated. That’s why it is important to create the DNS record before this step. Detailed info here: doc.
Once installation process is finished you will be able to access your newly installed Netris Controller web console using netris/newNet0ps credentials.
Change the default password
Setting → My Account → Change Password
Add new admin user
Accounts → Users → +Add