BlueRange Gateway WebUI

Overview

The BlueRange Gateway WebUI is a web interface installed on each BlueRange Gateway. The WebUI provides, besides some parameters for monitoring, the possibilities to customize configurations. In addition to this, it can also be used to enroll the gateway in a network.

Gateway WebUI Dashboard

Gateway WebUI Enrollment Wizard

To access the WebUI, you must be on the same network as the device. You can then use a browser of your choice to reach the website at https://meshgw-ABCDE.local. Please replace ABCDE with the serial number, that is also printed on the side of the gateway.

This address is only available in your local network where the gateway is plugged in. Also, your computer must have a zeroconf client such as Apple Bonjour installed. It is also possible to connect to the Gateway by using its IP address which you can either find on your network router or (if the gateway is already enrolled) in the device details page of our Portal.

Gateway Web server Certificate

Your browser will probably show you a warning that the connection is not secure. This is fine as it is a local domain name that cannot be certified by any standard certificate authority. You can tell your browser to continue to the page. Alternatively, you can also install our root certificate which guarantees the identity of our gateways.

  • Download the certificate from here: MWAY DIGITAL Root CA

  • Make sure that it is installed into the location for Authorized Root Certification Authorities

Afterwards, you should be able to access the Gateway WebUI without any security warnings.

Enrollment Wizard or Dashboard

Depending on whether the gateway is enrolled in a network or not, you will see the Dashboard or the Enrollment Wizard.

Enrollment Wizard

The enrollment wizard guides you through the enrollment process in several steps. After the device is enrolled, it restarts. You can now access the dashboard under the same URL.

Dashboard

The dashboard can be accessed when the device is enrolled and active. The dashboard provides various views, which are explained below.

Sitemap

Dashboard

On this page you can see the most important values of your device. The dashboard consists of two sections: a section with dynamic values and further down a section with static values.

Dynamic values can be updated in real time by adjusting the refresh rate, so you always have the current status. Static values are updated only when the page is loaded.

A status icon gives you a quick overview about the status of the device

Traffic

Here you can generate diagrams for various metrics and thus check specific values in real time. In addition, you have the option here to gain insight into the data traffic via the MQTT-Client.

Logging

Here you get an insight into the system log of the device. A filter can be used to change the level of detail shown in the view. Furthermore, you can search for messages in a targeted way and download them as well.

Via the level of detail you always set the lowest log level to be displayed. This means that it is possible that you set a log level and additionally or exclusively higher levels are displayed.
The number of messages is limited, so you may be able to see different amounts of time in the past.

Connections

This page gives you an overview of your mesh network. You can see several tables with known devices in the network. By selecting individual rows or clicking on a device, you can obtain more information about the device.

Spring Boot Admin

A direct link to the Gateway Console of the Device.

Gateway WebUI Settings

On the Settings page of the WebUI, you are able to configure network related tasks. This allows you to configure the gateway for a network environment requiring advanced settings.

Trusted SSL certificates

An SSL certificate is required for a secure connection between gateway and server. For on-premise installations, it is possible to use a self-signed server certificate. Be aware, however, that certain applications such as iPhone Apps and other external services may require a trusted signed certificate to be able to communicate with the server.

Custom Network Configuration

The BlueRange Admin app allows you to change certain settings such as static IP, DNS server, time-server IP, and some others.

For more advanced settings, you may upload a ConnMan Profile to your BlueRange Gateway. The following configuration is an example of using Ethernet as a priority and Wi-Fi as a fallback. Save it as a network.config file on your computer and apply it in the WebUi in SettingsCustom network config.

[service_network]
Type=ethernet
Name=Wired
IPv4=dhcp
Timeservers=0.de.pool.ntp.org,1.de.pool.ntp.org,0.pool.ntp.org,1.pool.ntp.org
#Nameservers=1.1.1.1,8.8.8.8

[service_wifi]
Type=wifi
Name=My SSID
Passphrase=PASSWORD

[WiFi]
Enabled=true

WPA supplicant Configuration

Here you can configure advanced settings for the Wi-Fi configuration by uploading a wpa_supplicant.conf file.

Diagnosis

In case of misbehavior of the device, a detailed diagnosis of the device can be made. This can help the BlueRange team to solve the existing problem.

After starting, this will be downloaded after a few seconds.

Diagnostic results contain sensitive data and should be handled confidentially.

Manual Software Updates

Keeping the gateway device up to date using the automatic update configuration of the BlueRange server is recommended. In preparation of enrollment or in case of device recovery updates may be applied directly.

Resetting the Device

Deletes the enrollment of the device and restarts it. You will then be redirected to the Enrollment Wizard and will have to enroll the device again in order to use it.

Licenses

The license section contains a list of the used licenses of the BlueRange Gateway Software.