Settings

General Settings

The General Settings tab allows you to modify the gateway’s name, configure system logs, synchronize time via an NTP server, and reboot the device.

Change the Gateway Name

You can modify the default name of the gateway to improve identification within a network.

Figure 1: Changing the gateway name

1. Navigate to Settings > General settings.
2. Enter the desired name in the Name field.
3. Click the Save button to apply the change.

Configure the System Log

The System Log settings allow you to manage log storage and send logs to an external log server for monitoring, troubleshooting, and long-term analysis.

Figure 1: Configure the System Log

1. Navigate to Settings > General settings.
2. Set Log Buffer Size: Enter the maximum log buffer size (in KiB) in the Buffer size (KiB) field (e.g., 64 KiB).
3. Choose Log Retention Period: Select a duration from the Log expiration dropdown:
   • 14 days
   • 1 month
   • 3 months
   • 6 months
   • 12 months
4. Configure External Log Storage (Optional):
   • Enter the External system log server IP address if remote log storage is required.
   • Specify the Port number used by the external log server.
5. Click Save to apply changes.

Time Synchronization

The gateway supports Network Time Protocol (NTP) to maintain accurate system time.

Figure 1: Time synchronization

1. Navigate to Settings > General settings.
2. Toggle Enable NTP client to activate time synchronization.
3. Configure NTP servers in the NTP server candidates list:
   • Click Add new server candidate to add an NTP server (e.g., pool.ntp.org).
   • To remove an NTP server, click the × button next to it.
4. Click Save to apply the settings.

Reboot the Gateway

This option allows you to restart the gateway. Note that all unsaved changes will be lost.

Figure 1: Reboot the Gateway

1. Navigate to Settings > General settings.
2. Click the Reboot button.
3. In the confirmation dialog, click Confirm to restart the gateway.

Backup and Restore

In this tab, you can backup, restore, or reset the gateway's settings to ensure configuration management and recovery.

Backup Configuration

This function enables you to create a backup of the gateway's current configuration, allowing for easy restoration when needed. For enhanced security, you can encrypt the backup file with a password.

Figure 1: Backup configuration

1. (Optional) Enable Backup Encryption:
   • Check the Set password to protect the backup archive box.
   • Enter a secure password to encrypt the backup file.
2. Click Generate and download backup to create and download the backup archive.
3. Store the backup file in a secure location for future use.

Restore Configuration

This function allows you to revert the gateway settings using a previously saved backup file.

Figure 1: Restore configuration

IMPORTANT

Restoring a backup will overwrite the current settings. Make sure you are using the correct file.

1. Click choose file or drag and drop the backup archive into the designated upload area.
2. Click Restore to apply the backup configuration.
3. Wait for the process to complete, and ensure the gateway restarts properly.

Reset to Factory Defaults

This function resets the gateway to its original factory settings, permanently erasing all configurations.

Figure 1: Reset to factory defaults

IMPORTANT

This action is irreversible. Ensure you have a backup before proceeding.

1. Click the Reset button.
2. In the confirmation dialog, click Reset to reset the gateway.
3. Wait for the gateway to reboot with factory default settings.

Firmware

The Firmware tab allows you to check the current firmware version and update it when needed.

Figure 1: Firmware tab

Before You Upgrade

Backup Before Any Upgrade

Before performing any firmware upgrade, it is highly recommended to create a full backup of your configuration. This ensures that you can restore your settings in case of unexpected issues or if a reset is needed.

For detailed steps on how to back up your configuration, refer to Backup Configuration.

Upgrade to WisGateOS 2.2.x

If you are upgrading to WisGateOS 2.2.x, please review the following important considerations:

• Downgrading Restrictions
  Once you upgrade to WisGateOS 2 2.2.x, you will not be able to revert to version 2.1.x using the standard downgrade (WebUI). Make sure to back up and secure all critical data before proceeding with the upgrade. Only through a recovery procedure will a downgrade be possible. You can find the steps on RAK Learn site: OpenWRT Recovery Procedure .

• Extension Signature Requirement
  Starting from WisGateOS 2 version 2.2.x, all extensions are required to have a valid signature to ensure improved security and compatibility. If your gateway was upgraded to WisGateOS 2.2.x from an earlier version, any previously installed extensions without signatures will continue to work and do not need to be reinstalled.

• Internet Connection Requirement
  An Internet connection is required during the update to verify the new firmware and extension signatures.

• Dual Firmware Support
  Both 2.1.x and 2.2.x will be supported, but you must use the correct extensions for each version to avoid compatibility issues.

Upgrade WisGateOS 2 Firmware

1. Download the latest firmware of the gateway and unzip it.

2. Drag and drop the .rwi file in the Drop your RWI file here or choose file form, or click the choose file link to browse for the file.

   Figure 1: Upload the firmware file

3. Check the Keep settings after updating option.

   NOTE

   The Keep settings after updating check box is selected by default. Unchecking it will reset the gateway to stock settings after the upgrade.

4. Click Update to initiate the flashing process.

   Figure 1: Upgrading

5. After the upgrade is complete, log in to the gateway and check the Firmware tab to confirm that the installed firmware version is correct.

Troubleshoot Firmware Upgrade

If you are unable to update the firmware from the Firmware tab, it may be because the update is managed by WisDM.

Figure 1: Firmware tab inactive

If the gateway is:

• Registered in WisDM
• Allow WisDM Integration is enabled
• Enable FOTA is turned on

The firmware update option will be locked because it is centrally managed by WisDM.

To enable manual firmware updates:

1. Go to WisDM tab.
2. Turn off Enable FOTA.
3. Save the settings.

Once FOTA is disabled, the firmware update option in the Firmware tab will be unlocked, and you can proceed with the manual update.

NOTE

When FOTA is disabled, your gateway won't receive any firmware updates from WisDM and can only be managed via the WisGateOS.

File Browser

The File browser allows users to view and download files stored on the gateway. This feature is useful for accessing log files, firmware images, configuration data, and other stored resources.

Figure 1: File browser tab

1. Navigate through the file system using the interface.
2. Click on a file to download it to your local device.

WisDM

The WisDM tab allows you to integrate your gateway with WisDM, a cloud-based remote management platform, and enable FOTA (Firmware Over-The-Air) updates.

Figure 1: WisDM tab

Allow WisDM Integration
Enable this option to connect the gateway to the WisDM Platform for remote management.

NOTE

Simply enabling this option does not automatically register your gateway in WisDM. You must register it in WisDM separately to fully manage and monitor it remotely.

Registered in WisDM
This indicator shows whether the gateway is successfully registered in WisDM, enabling full remote management capabilities.

• : The gateway is successfully registered in WisDM and can be monitored, configured, and managed remotely.
• : The gateway has not been registered in WisDM yet. Remote management and FOTA are not available until registration is completed.

Enable FOTA (Firmware Over-The-Air)
When enabled, the gateway can receive automatic firmware updates via WisDM, ensuring it stays up to date with the latest security patches and feature enhancements.

NOTE

If you prefer to update the firmware manually through the WisGateOS 2 Web UI, this feature must be disabled.