OpenWRT (Uplink) Gateway | VXG Help Center

Overview

We develop and maintain Uplink Gateway software packages which run on a router or embedded network appliance running OpenWrt.

The primary OpenWRT devices we support are:

GL.iNet GL-MT300N-V2 (Mango)
Mikrotik hEX RB750Gr3

Please contact technical support for support of other models.

Setup Guides

The following setup guides are provided for each supported device:

Uplink Gateway Package Installation

Download the latest software packages from our downloads page.
After setup of the OpenWRT device, open the LuCI interface in a browser by going to the device IP address and signing in with the router administrator credentials.
Navigate to System > Software to open the system packages page.
Click Update lists to refresh the package index and wait for the update process to complete.
Choose Upload Package, select the uplink-gateway package file, and confirm the upload and installation. Do not install the uplink-gateway-luci-app first since it depends on the uplink-gateway package.
After the uplink-gateway package is installed, choose Upload Package again, select the uplink-gateway-luci-app package file, and confirm the upload and installation.
Now that the packages are installed, the gateway is ready to be added to the Cloud VMS platform.

Add Gateway to Cloud VMS

Follow the instructions on Settings -> Cameras page | New Gateway page. You will need the following information:

Serial Number (S/N)
MAC Address
Gateway Username and Password

In the LuCI interface, the device information can be found under Uplink Gateway > Gateway Controls, located at http://DEVICE-IP/cgi-bin/luci/admin/uplink-gateway/camera-html. Use the values displayed on this page for the gateway Serial Number (S/N) and MAC Address when adding the gateway in Cloud VMS.

The username is always root, the password is the one you set up in step 3.1.

Update OpenWRT Gateway

Update Using the Gateway’s Webpage

Open the gateway’s webpage by logging into the Web Client and going to Settings > Cameras > Gateways > Actions for the gateway you’re updating, then select Gateway UI.

In the Gateway UI, open the LuCI interface.
Navigate to System > Software to open the system packages page.
Click Update lists to refresh the package index and wait for the update process to complete.
Filter the list by installed packages, then search for uplink to show the installed gateway packages and their current versions.
Remove only the gateway luci-app package from the installed package list. Do not remove the uplink gateway package itself. Confirm the removal when prompted and wait for the package to be removed.
Upload the latest uplink-gateway package to update the gateway. Choose the package file, confirm the upload and installation, and wait for the install process to run.

During this step the connection will be disconnected as the package is updated.

Wait for the gateway to come back online, then reconnect to the Gateway UI if needed.
Once the connection is re-established, return to the packages page and confirm that the uplink-gateway package version has updated.

Upload the latest luci-app package by choosing the package file, confirming the upload and installation, and waiting for the install process to complete.
After install is complete, ensure that both packages have the latest version number.

Update using SSH Connection to Gateway

After connecting to the gateway via SSH, use wget to fetch the latest package from the downloads page.
```
wget https://downloads.cloud-vms.com/customer/glinet-mango-gateway-2.1.2.zip
```
Where customer is the specific downloads page and glinet-mango-gateway-2.1.2.zip is the latest package for the OpenWRT device.
Unzip the package.
```
unzip glinet-mango-gateway-2.1.2.zip
```
Update package lists.
```
opkg update
```

List the names of the gateway packages installed.

opkg list-installed | grep "gateway"

Example:

root@GL-MT300N-V2:~# opkg list-installed | grep "gateway"
uplink-gateway - 2.0-0
uplink-gateway-luci-app - 2.0

Remove the luci-app package.
```
opkg remove uplink-gateway-luci-app
```

Upgrade the uplink-gateway package with the new package.

opkg install uplink-gateway_2.1-2_mipsel_24kc.ipk

If the ssh connection is through uplink, the connection will be broken and a reconnect is needed.

Example:

root@GL-MT300N-V2:~# opkg install uplink-gateway_2.1-2_mipsel_24kc.ipk
Upgrading uplink-gateway on root from 2.0-0 to 2.1-2...
Killed uplink process with PID: 20900
Killed uplink process with PID: 21298
/etc/rc.common: line 94: /etc/uplink-gateway/stopagent: not found
Stopped uplink agents
Configuring uplink-gateway.
Starting router agent
MAC: 94:83:C4:30:2D:B4
SERIAL: fe3800c463cb75e4
Install complete.
Updating database.
Database update completed.

Re-install the luci-app package.

opkg install uplink-gateway-luci-app_2.1_all.ipk

Example:

root@GL-MT300N-V2:~# opkg install uplink-gateway-luci-app_2.1_all.ipk
Installing uplink-gateway-luci-app (2.1) to root...
Installing coreutils (9.0-2) to root...
Downloading https://fw.gl-inet.com/releases/v22.03.4/packages-4.2/mipsel_24kc/packages/coreutils_9.0-2_mipsel_24kc.ipk
Installing coreutils-base64 (9.0-2) to root...
Downloading https://fw.gl-inet.com/releases/v22.03.4/packages-4.2/mipsel_24kc/packages/coreutils-base64_9.0-2_mipsel_24kc.ipk
Configuring coreutils.
Configuring coreutils-base64.
Configuring uplink-gateway-luci-app.
MAC: 94:83:C4:30:2D:B4
SERIAL: fe3800c463cb75e4
PLATFORM: GLINET
Updating database.
Database update completed.

Check that the latest versions are now installed.

opkg list-installed | grep "gateway"

Example:

root@GL-MT300N-V2:~# opkg list-installed | grep "gateway"
uplink-gateway - 2.1-2
uplink-gateway-luci-app - 2.1