Use the Knox E-FOTA firmware downloader

To help you manage firmware versions, Knox E-FOTA On-Premises supports a firmware downloader that allows you to select and download firmware versions of your choice.

The Knox E-FOTA firmware downloader uses two JSON files:

• A scenario JSON file, which contains a list of the firmware versions currently hosted on your Knox E-FOTA On-Premises server.
• An input JSON file, which contains a list of target firmware versions you can import into your server.

You need both of these files to download specific firmware versions.

If your PC is behind a proxy server, ensure that you have the proxy server host IP and port number ready. You’ll need to enter these when using the firmware downloader.

Download a scenario JSON file

If you’ve just installed Knox E-FOTA On-Premises, make sure your devices are successfully enrolled before following these steps. Otherwise, you won’t be able to export the firmware version information for your devices.

To download a scenario JSON file:

1. On the Knox E-FOTA On-Premises console, go to Settings and click Versions.

2. On the Versions page, click ACTIONS > Download Versions Scenario.

   

The scenario JSON file is downloaded to your PC.

Download an input JSON file

Before following these steps, make sure you’ve already exported the scenario JSON file. The input JSON file requires the scenario JSON file so that the firmware delivery servers can prepare the corresponding firmware versions for your devices.

To download an input JSON file:

1. Sign in to the Knox Admin Portal.

2. On the Knox Admin Portal homepage, under Knox E-FOTA On-Premises, click Get started.

3. Click Download Firmware Files.

4. Enter your Knox E-FOTA On-Premises license key, then click CONTINUE.

5. A page is shown with your license key. Click GENERATE REQUEST.

   

6. In the dialog that opens, click BROWSE to select and upload your scenario JSON file.

7. Click GENERATE REQUEST.

The console notifies you that your request was successfully submitted, and the input JSON file begins downloading shortly.

Get the firmware downloader

Before following these steps, make sure you’ve already uploaded a scenario JSON file. The firmware downloader link only appears after you’ve uploaded at least one scenario JSON file.

To get the Knox E-FOTA firmware downloader:

1. Sign in to the Knox Admin Portal.

2. On the Knox Admin Portal homepage, under Knox E-FOTA On-Premises, click Get started.

3. On the page that opens, click Download Firmware Files.

4. Enter your Knox E-FOTA On-Premises license key, then click CONTINUE.

5. Next to the firmware downloader tooltip, Click DOWNLOAD HERE.

   

The firmware downloader is saved to your PC.

Download specific firmware versions

Once you have the scenario and input JSON files ready, you can begin using the firmware downloader.

To download specific firmware versions using the Knox E-FOTA firmware downloader:

1. Launch the Knox E-FOTA firmware downloader.

2. Under input.json, click Browse and select the input JSON file you downloaded from the Knox Admin Portal.

3. Under Target firmware, click SELECT FIRMWARE.

4. A dialog opens with the firmware list specified by the input JSON file. Select the firmware versions you want to host in Knox E-FOTA On-Premises, then click SELECT.

5. Under scenario.json, click Browse and select the scenario JSON file you exported from the Knox E-FOTA On-Premises console.

6. Under Origin firmware, click SELECT FIRMWARE.

7. A dialog opens with the firmware list specified by the scenario JSON file. Select a firmware version equal to or lower than the lowest firmware version that your devices are running. You can select multiple origin firmware versions.

8. Under Save directory, click Browse to choose a location for your firmware download.

9. (Optional) If your PC is behind a proxy server, enter the Proxy host and Proxy port.

10. Click DOWNLOAD.

The target firmware versions are then downloaded to the location you selected, and can be imported to your Knox E-FOTA On-Premises server.