Skip to content
English
Sign in
Contact us
  • There are no suggestions because the search field is empty.

Restoring Kona Gateways to Previous Configurations

Configuration management is a critical part of maintaining reliable and secure IoT deployments.

In cases of misconfiguration, firmware issues, failed updates, or operational testing, restoring a gateway to a previous known-good configuration can significantly reduce downtime and operational risk.

This document outlines the best practices and procedures for restoring Kona Gateways to earlier configurations.

Creating and Restoring a Backup

Once the gateway is configured as desired and is in a state you wish to preserve, you can create a backup of its configuration using the methods outlined below:

Additionally, a backup of the gateway’s configuration associated with the previous BSP version is automatically generated whenever the gateway performs a BSP upgrade, unless this behavior has been explicitly disabled.

Creating and Restoring a Backup using Tektelic Network Server or Kona Element

  1. Log into your Tektelic Network Server account or Kona Element account

  2. Select "Gateway Groups" and select the gateway group belonging to the gateway you wish to create a backup for. Select "Manage Gateways"
  3. Select the gateway you wish to create the backup for and ensure it is online.
  4. In the tabs of the various gateway management features available on the Tektelic Network Server / Kona Element, scroll to the right using the arrow and select "Backups"
  5. Click the Cloud icon to create the backup as seen in the screenshot below:
  6. Once the backup has been created, you can click "Update Table" to view the backup you have just created
  7. To restore the gateway to an existing backup, click the circular symbol on the right hand side of the backup you wish to restore to listed in the table as seen below:
Creating and Restoring a Backup using the SSH Command Line

  1. Using an SSH client such as PuTTy or TeraTerm, connect to your gateway's IP address and log into your gateway using the credentials provided on the Test Summary sheet that comes with your gateway

  2. Initiate a system backup by running the command system-backup -b
  3. Once the backup has been created, you can view it using the command system-backup as seen in the below screenshot:
  4. To restore to your backup, run the command system-backup -r xxx (Where xxx corresponds to the backup number you would like to recover to as seen in the screenshot above) 

By default if no backup number is specified the gateways will restore to the 000 backup as 000 is always the most recently created backup.

Creating and Restoring a Backup via KonaFT

  1. Connect to your gateway via KonaFT by entering the IP address for your gateway and clicking the "Start" button.

  2. Select "Board Details" from the available tabs at the top and then select "Backup and Restore"
  3. At the bottom of the page, enter a description for the backup and click "Start Backup" as seen in the screenshot below:
  4. To view your existing backups, click "Update Table"
  5. To restore the gateway to an existing backup, select the backup you wish to restore the gateway to from the Table and click "Restore Selected"