Network configuration for the virtual machine

The Joan on-premises server requires network connectivity. It will connect to the global Joan Portal, which will still manage all of your devices. 

As the virtual machine requires an internet connection, it will open connections to:

  • master.joan.vnct.xyz, ports 80 and 443
    static.getjoan.com, port 443
    which provides the Graphical User Interface (GUI) on your devices
  • firmware.visionect.com, port 8089
    which provides firmware upgrades

You can run Joan on your infrastructure by using a static IP address. Changing the IP of the on-premises server can be done in a couple of simple Linux commands.

  1. Login or ssh to your on-premises server using your credentials. By default, the following credentials are set
    • Username: joan
    • Password: joanaccess
  2. Find the name of the network adapter whose IP address you would like to change. Usually, this will be the bridged adapter. Find the name of the adapter by typing the following command into the terminal:
    ip addr
  3. Set the adapter’s static IP address by following the steps here.
  4. Restart the networking service:
    sudo service networking restart
  5. Check whether the static address has been set up for the selected network adapter:
    ip addrs

However, if you wish to change the IP of the On-Premises server simply use the Linux command:

sudo vim /etc/network/interfaces
auto eth0
iface eth0 inet static
           address 192.168.1.10
           netmask 255.255.255.0
           network 192.168.1.0
           gateway 192.168.1.1
           broadcast 192.168.1.255
           dns-nameservers 192.168.1.1 8.8.8.8

 

Note:

If you have a VM newer than 18.04 you have to use the following network configuration:

In Ubuntu 20.04 static IP needs to be set in netplan configuration. You can set it up by following the next steps

1. First you need to log in with your credentials. By default, the following credentials are set:

  • Username: joan
  • Password: joanaccess

2.  Use the following command to view the IP address. As you will see, a dynamic IP is assigned automatically. So, to make this IP address static, we must edit the netplan configuration file.

ip addr

To set up the static IP address via netplan you will first have to enter netplan configuration. You can do this by using the following command:

sudo vim /etc/netplan/60-visionect-network.yaml 
network:
ethernets:
eth0:
dhcp4: true
eth1:
dhcp4: true
eth2:
dhcp4: true
version: 2

3. Above are the default entries, which show that interface “eth0” is getting the IP from the DHCP server. As it is a YAML file, while making the changes in the file we must follow the correct indentation. Add the following lines to the YAML file,

network:
ethernets:
eth0:
dhcp4: false
addresses: [192.168.1.222/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8]
eth1:
dhcp4: true
eth2:
dhcp4: true
version: 2

5. When editing Yaml files, make sure you follow the YAML code indent standards. If the syntax is not correct, the changes will not be applied.

Once done, save the file and apply the changes by running the following command:

sudo netplan apply

Now you can run “ip addr” and “ip route” commands to view the IP address and route details to see results for yourself.