Prerequisites
VMS Gateway is a heavy user of CPU and memory. While it may operate in lower specification Raspery Pi, we don't recommend using anything less than a Raspberry Pi 5 with at least 8GB RAM.
To proceed, you should have:
A Raspberry Pi running Pi OS
There should be one enabled network interface (and make sure to disable Wi-Fi if you are not using it)
Configure your network interface with a static IP address
You can use multiple machines to create a VMS Gateway cluster - if so you will have to perform these steps for every machine you intend to add to your cluster.
VMS Gateway installation (on your first machine)
These instructions only apply to the first machine you install VMS Gateway on. Please read this article if you want to increase the capacity of your VMS Gateway cluster by adding additional machines.
Expert users can download the .deb file here if required; however, we recommend following the instructions to download and install in two simple commands.
Installation steps
Open the Terminal application – this should give you a command prompt
For a fresh installation, you must first prepare your machine to run VMS Gateway. Enter the following command (and confirm your Ubuntu password):
sudo nano /boot/firmware/cmdline.txt
Edit the existing line so that it matches the following:
group_memory=1 cgroup_enable=memory
To save your changes, hit CTRL + O (letter O), then hit Enter to confirm the filename. To exit nano, hit CTRL + X.
Reboot your machine with:
sudo reboot
After the reboot is complete, log back into your machine and open the Terminal application again.
Check the current directory does not already have a file called vmsg-arm-latest.deb - if it does, delete it with:
rm vmsg-arm-latest.deb
Download VMS Gateway using this command
wget http://get.edgevis.com/vmsg-arm-latest.deb
Run the installer using this command:
sudo apt install ./vmsg-arm-latest.deb
You will be asked to enter your Ubuntu password, and then to confirm installation.
After a short period, you will be asked some questions:
The first screen asks if this is the primary machine – select Yes.
The second screen provides the secret code required to add additional machines. It is possible to use this to install VMS Gateway onto secondary machines (but it's easier to download this directly from the web interface later).
The final screen displays the web address you can use on any PC on this network to login and configure VMS Gateway.
Open a web browser and visit the web address shown in the final screen above (i.e. http://[your IP address]/) to confirm successful installation – please allow a minute or so startup time.
You should now be presented with the login page for VMS Gateway - it's time to login in!
Incorrect warning messages
Once installation is complete it is common to see various Ubuntu warning messages:
This can be safely ignored.