AdvanNet SW Upgrade Utility

Introduction

AdvanNet is the controller SW that all the Series 60 and Series 150 readers and derived systems. AdvanNet SW is technically a SW module running on top of a bootloader.

This Keonn Bootloader provides convenient options:

• • It allows upgrading modules

  • It allows a fall-back version of the modules, in case upgrades fail.

  • It allows upgrading  just AdvanNet SW or the device configuration files

  • It allows generic OS upgrades. 

Keonn releases AdvanNet upgrades periodically.

Follow this guide to know how to upgrade your AdvanNet module of your device.

Requirements

• • Running a Keonn Bootloader version higher or equals to 180102

  • To be able to upgrade a new version of AdvanNet module, it is required to have a ZIP file signed by Keonn. The reason of required signed file is to avoid unauthorized or corrupted software versions. AdvanNet signed versions can be found in our public Dropbox folder:
    https://www.dropbox.com/scl/fo/y7xdnqj7ooqovbyqio8yw/h?rlkey=8a4a4g0l7dclt0tivs6dh73y0&dl=0

  • Also, it is required a connection to the device (Local network, direct Ethernet or USB). If the device IP has been forgotten, check the Discover Devices section.

Keonn bootloader

If you are familiar with the Keonn bootloader and you are aware of all the warnings to take into account, you may proceed to the upgrade steps here.

To open AdvanNet Updater (Keonn bootloader) connect the device and open your browser with the URL:

• http://<Device-IP-address>:8080 (replace the <Device-IP-address > for your IP device).

or

• https://<Device-IP-address>:8080 (replace the <Device-IP-address > for your IP device).

If the following web page is not shown, please contact with support@keonn.com.

The minimum bootloader version is 180102.

Installed modules

All the installed SW modules, and upgrades, including AdvanNet, are listed with their version information. If there is more than one version per module, they will be listed in version descendant installation order, being the last one the Original SW version.

OS upgrades are not listed.

2. OS upgrades: If there are some updates available for your OS device Keonn will deploy a signed ZIP. 

Each Keonn's devices has its own AdvanNet signed version associated to it.

Before updating your device, take into account:

• • The downloaded version must match your device model:

• • Updates can only be performed using AdvanNet software signed by Keonn. AdvanNet updates with non-signed or modified AdvanNet files will cause the update to fail.

  • If your machine is updated with several versions, only the last uploaded version will be executed (even if the last uploaded version is older than previously uploaded versions )

  • If there is an error updating AdvanNet version, the factory AdvanNet SW will always be kept.

Reboot system

If the device is not responding, you can use this option to make a clean reboot of the device. Press the button Reboot, accept the information pop-up and wait until you are redirected again.

HOW TO upgrade (steps)

If not already opened, please use Firefox or Chrome and open the URL

http://<Device-IP-address>:8080

(replace the <Device-IP-address > for your IP device).

Upgrade AdvanNet module

• 1. Go to the Upgrade Module section of your device updater.

  2. Select the option AdvanNet.

1. Click on Browse button and find the ZIP file provided by Keonn. Make sure that you are choosing the proper file.

2. Press Upgrade button. A warning message will be displayed. Read it carefully, follow the instructions and accept it.

   1. Now, the upgrade process will start. Wait until you are redirected again to the upgrade main web page.

Upgrade OS

Devices can also be updated with custom software provided by Keonn (signed software).

The process is explained below:

• 1. Go to the Upgrade Model section of your device updater.

  2. Select the option OS upgrade.

  3. Click on Choose file button and select the signed zip file provided by Keonn.

  4. Click on Upgrade button.

  5. Accept the pop-up and wait for the upgrade process to finish.

Identify active AdvanNet directory

The default AdvanNet directory is 

/home/keonn/kernel/module/app.AdvanNet

However, when we start applying AdvanNet SW upgrades, the directory structure of the device is modified, and the directory that holds the active version of AdvanNet changes.

In order to identify the active AdvanNet directory, please follow this procedure:

1. Using any SFTP client or by login into the system using SSH, list the contents of the directory /home/keonn/kernel/module/app.AdvanNet

drwxr-xr-x 3 keonn keonn 4096 May 11 09:11 META-INF

-rw-rw---- 1 keonn keonn 5696 May 11 11:03 advannet.jks

drwxr-xr-x 5 keonn keonn 4096 May 18 07:52 alternatives

-rw-r--r-- 1 keonn keonn   46 May 11 09:11 build-info

drwxr-xr-x 3 keonn keonn 4096 May 11 09:11 lib

-rw-r--r-- 1 keonn keonn  168 May 11 09:11 module-upgrade.xml

-rw-r--r-- 1 keonn keonn  688 May 11 09:11 module.xml

drwxr-xr-x 7 keonn keonn 4096 May 11 09:11 native-lib

drwxr-xr-x 3 keonn keonn 4096 May 11 09:11 templates

drwxr-xr-x 9 keonn keonn 4096 May 11 09:11 web

2. In case the directory below does not contain a sub-directory called alternatives, the active directory is directly the same directory

/home/keonn/kernel/module/app.AdvanNet

3. In case the directory /home/keonn/kernel/module/app.AdvanNet/alternatives exists, list the contents of /home/keonn/kernel/module/app.AdvanNet/alternatives

drwxr-xr-x 6 keonn keonn 4096 May 11 11:00 2.5.1-rc3.001
drwxr-xr-x 2 root  root  4096 May 18 07:52 2.5.1-rc4.002
drwxr-xr-x 2 root  root  4096 May 18 07:52 2.5.1.003

4. The active directory would be the entry in /home/keonn/kernel/module/app.AdvanNet/alternatives with the highest suffix value.

In the previous example it would be:  /home/keonn/kernel/module/app.AdvanNet/alternatives/2.5.1.003

Known errors while upgrading

The upgrade procedure is designed to be a 100% safe process.

The main mechanism is having a module factory SW, which is never altered, and is used as a fallback version whenever the installed upgrades fail to boot.

The web page, while upgrading, may show the following messages:

Internal error while processing last operation. MANIFEST_FILE_NOT_FOUND

Possible reasons:

• • The chosen file is not signed by Keonn.

  • File not valid for your device.

Upgrade for module app.AdvanNet failed. Destinamtio_pathfile (Is a directory)

Possible reasons:

• • No file selected before submitting.

Internal error while processing last operation. New module {product} does not match with upgrade product: {your_product}

Possible reasons:

• • The file uploaded to upgrade is not for your device.