The System configuration form holds the general settings of the device: its name, the date and time, the web server, the logs and the storage of remanent values. Open the System page and click System configuration in the left menu. Only administrators see this form.
To change a setting, click the cog next to System configuration, edit the fields and confirm with the check mark. The cross cancels your changes.
Some changes need a restart of the web server, of the device software or of the whole device. The page tells you which one and asks you to confirm.
On Windows installations, Optimize memory, Save logs on disk, Activate disk monitor, Grafana LOKI and the Datetime configuration are not shown.
| Parameter | Description |
|---|---|
| System name | Name of the device. It is shown in the title of the browser tab. Default: Weble IoT gateway. |
| Optimize memory | Lowers the memory used by the device software, at the cost of some speed. Off by default. Changing it restarts the device software. |
| Parameter | Description |
|---|---|
| Save logs on disk | Writes the logs of the device software to its storage. Off by default. |
| Activate disk monitor | Records which files the device software writes to the storage, and how much. Off by default. When it is on, the System home page shows the disk write statistics. The change applies at once. |
| Remanent value storage | Where the remanent values are stored. Remanent values are the address values kept across restarts. default: the internal storage of the device. usb: a removable storage device. custom: a folder of your choice. |
| Remanent USB device | Shown with usb. The storage device to use. Leave it empty to let the device find it. |
| Remanent dir | Shown with custom. Path of the folder. It cannot contain the characters : and =. |
Writing logs all the time wears flash storage (SD card, eMMC). Turn Save logs on disk on only while you look for a problem, and turn it off when you are done.
After a change of Remanent value storage, the device software must restart. The page asks you to confirm.
The device can send its logs to a Grafana Loki server. This works also when Save logs on disk is off.
| Parameter | Description |
|---|---|
| Grafana LOKI enable | Turns the sending of the logs on. |
| Host | URL of the Loki server. |
| Username | User name of the Loki account. |
| Password/Token | Password or token of the Loki account. |
| Application name | Value of the app label attached to the logs. Default: iot-gateway. |
The Datetime configuration section sets the time source and the time zone.
| Parameter | Description |
|---|---|
| Mode | Time source of the device. See the modes below. Default: NTP. |
| Timezone | Time zone of the device. After a change, the page asks you to reboot the device. |
| DateTime | Shown in defined mode. The date and time to set. |
| NTP Server 1 to NTP Server 4 | Shown in Custom NTP mode. Host names or IP addresses of your NTP servers. One server is enough. |
| NTP Server | When ticked, the device also answers the NTP requests of other equipment on the network (UDP port 123). Use it in NTP or Custom NTP mode. |
| NTP sync. interval (ms) | Time between two synchronisations, in milliseconds. Default: 14400000 (4 hours). |
| Mode | Description |
|---|---|
| NTP | The device synchronises with the Weble server through the VPN, and with the public servers 0.ch.pool.ntp.org to 3.ch.pool.ntp.org. |
| defined | You set the date and time by hand in DateTime. The device does not synchronise. |
| Custom NTP | The device synchronises with the servers entered in NTP Server 1 to NTP Server 4. |
| From DHCP | The device uses the NTP servers given by the DHCP server. |
In NTP and Custom NTP modes, the device must reach the servers on UDP port 123. Check the firewall of the site if the time drifts.
| Parameter | Description |
|---|---|
| Use HTTP | Serves the web interface and the API over HTTP. On by default. |
| HTTP Port | Port of the HTTP server. Default: 80 (8888 on Windows installations). |
| Use HTTPS | Serves the web interface and the API over HTTPS. Off by default. |
| HTTPS Port | Port of the HTTPS server. Default: 443. |
| HTTPS redirect HTTP | Sends the pages opened over HTTP to HTTPS. Use HTTPS must be on. Use it with the default ports 80 and 443. |
| Websocket compression | Compresses the live data exchanged with the browser. On by default. |
| Custom certificates | Uses your own certificate for HTTPS. See below. |
At least one of Use HTTP and Use HTTPS must stay on. A port already used on the device is refused.
After a change in this section, the web server must restart. The page asks you to confirm, and you lose the page for a few seconds. If you changed the port or the protocol, open the device again with the new address.
Without your own certificate, HTTPS uses a self-signed certificate built into the device. The connection is encrypted, but the browser shows a warning.
To use your own certificate, tick Custom certificates and load the three files with the change button. The files are in PEM (text) format.
| Parameter | Description |
|---|---|
| Cert | Certificate of the device. |
| Key | Private key of the certificate. |
| Key passphrase | Passphrase of the private key. Leave it empty if the key has none. |
| CA | Certificate of the authority that signed the certificate. |
Cert, Key and CA are all required. If the device cannot load your certificate, it uses the built-in one.