Legacy BSP Upgrade Guide

Kona Gateways that are running the below BSP versions have have a few extra steps that are required to upgrade the gateways:

To perform the BSP upgrade on these older legacy units please see the steps below:

Step 1: Determine the gateway's current BSP, and what BSP you will need to upgrade to

To identify what BSP is currently running on your gateway, access the gateway's command line via SSH and run the command: system_version

Once you have this information, please refer to the following page to identify what the next BSP version your gateway should be updated to is:

https://knowledgehub.tektelic.com/kona-gateway-bsp-upgrade-overview

Step 2: Download BSP Upgrade Files

Once you have determined the BSP version that your gateway should be upgraded to using the page shown above, you can download the corresponding BSP upgrade files from our FTP Server using the following instructions:

https://knowledgehub.tektelic.com/access-tektelic-ftp-server

Step 3: Uploading the BSP Upgrade Files to the Gateway

There are various ways of uploading the BSP Upgrade Package to the gateway. This guide will use FileZilla to upload files to the gateway.

Use the following site settings to connect to your gateway:

Site: (IP address of your gateway)

Username and Password: The SSH login credentials for your gateway.

Upload these BSP upgrade files to the /lib/firmware directory. If you have uploaded the entire .zip file, you will need to unzip this package using the "unzip" command, followed by the file name of the BSP .zip file you uploaded. Once completed, you should remove the original .zip file from the gateway.

Step 4: Edit, or create the BSP Upgrade Configuration File

The path to the BSP Upgrade configuration file is as follows: /etc/opkg/snmpManaged-feed.conf

If this file does not already exist you can create it using the VI text editor from the gateway command line, or create it on your desktop and upload it to the /etc/opkg folder using Filezilla as you did with the BSP Upgrade files above.

The BSP Upgrade configuration file should have the contents below:

For the Kona Micro Gateway:

src/gz bsp file:///lib/firmware/bsp
src/gz gpio-fpga file:///lib/firmware/gpio-fpga

For the Kona Macro or Mega Gateway:

src/gz bsp file:///lib/firmware/bsp
src/gz gpio-fpga file:///lib/firmware/gpio-fpga
src/gz fe-fpga file:///lib/fimrware/fe-fpga

Please note that the file path listed must match the location for where you uploaded these BSP upgrade files. For example, if the BSP files were uploaded to /lib/firmware/bspupgrade, the file path for the bsp line should be "file:///lib/firmware/bspupgrade/bsp.

Step 5: Initiating the BSP Upgrade

To initiate the BSP upgrade, the following commands must be run in order:

opkg update

opkg install opkg-arch-config

opkg install tektelic-upgrade

tektelic-dist-upgrade -Du

Your gateway now should have initiated the BSP Upgrade. This process typically takes around 15 minutes to complete. The gateway will also reboot a number of times during the upgrade, so if you lose connection, or see the upgrade progress % halted temporarily, this is not a cause for concern.