Monitor operations

This section describes the different areas of Knox E-FOTA that you can monitor in your dashboard.

When you log in to the Knox E-FOTA admin portal, you land on the dashboard. You can return to it at any time by clicking the Dashboard tab on the left navigation.

Device status

The DEVICE UPDATE STATUS widget shows a high-level view of the statuses of devices in the organization. Click a status to view the devices that fall under it. Clicking View all takes you to the Devices tab.

The different statuses are as follows:

  • Completed — These devices are up to date and no operations are pending.

  • In-Progress — These devices are waiting for or are currently in the process of a firmware download or installation.

  • Attention — These devices require you or the device user to take action. For example, a license is invalid and needs to be replaced.

  • Error — These devices failed to download or install firmware, or have experienced a campaign error.

  • Not Started — These devices have been added but the Knox E-FOTA client app has not been installed, or the campaign has not started yet.

Firmware trend

The FIRMWARE TREND displays how many devices are on which firmware version grouped by security patch level over the past 8 weeks. The graph updates every Monday (UTC±00:00). You can click on the firmware trends to see additional information about the devices on that security patch, such as firmware version, model, sales code, CSC, security patch, and device count.

You can add up to two additional graphs with custom filters that only display devices with specific campaign, model, sales code, or CSC.

firmware trend

The Latest security patch rate shows the percentage of devices that are on their latest patch, percentage of devices on the patch before their latest patch, and percentage of devices on any earlier patches. The firmware trend only considers the patches that are installed on your devices. It ignores any released patches that aren't installed.

OS trend graph

The OS TREND GRAPH shows a pie chart of the different OS versions of all enrolled devices. The chart includes a device count for each OS version. To view more details, click a device count next to the OS version you're interested in. The device list filters for the OS version you selected.

Active campaign

For each campaign you activate, a CAMPAIGN widget appears for it in the dashboard. You can have multiple active campaign widgets. Active campaign widgets show the following details.

  • The Status view shows the following:
    • Complete rate
    • Error — Number of devices which encountered an error.
    • Attention — Number of devices that require your attention. When you click this, the Devices list is displayed, filtered to show the devices that need your action.
    • In-progress — Number of devices that have yet to download or install firmware updates.
    • Completed — Number of devices which are up to date with target firmware.
    • Not Started — Number of devices which have not started firmware updates.

    active campaign

    The Status view is updated in real time.

  • The Trend view shows the success rate of the campaign over the last two weeks. This view is updated once a day.

    NOTE — Campaigns that were activated before KCS 1.32 will not have the trend view.

    active campaign trend

  • The Network view shows a pie chart of which networks were used by devices to install firmware.

    active campaign network

You can do the following:

  • View more details of the campaign's progress by hovering over the graph.
  • Unpin a campaign widget by clicking the X icon on it.
  • Pin a campaign you've previously unpinned.

To pin an active campaign:

  1. Click Select Campaign to Pin Here.
  2. In the drop-down menu, select the campaign you want to pin.
  3. Click Add.


The LICENSES widget lists up to 3 licenses, sorted by end date. Clicking View all takes you to the Licenses tab, which contains all licenses in the account and their details.

This widget becomes available as soon as you add a license. It contains the following:

  • A pie chart that shows the total license operation rate; that is, the total number of license seats currently assigned over the total number of license seats from all commercial and trial licenses in the account.
  • A list of up to three licenses with the most number of seats in the account. For each license, the following details are shown:
    • Type—Commercial or Trial.
    • Status—Active, Registered (that is, the license has been added to the account but is not yet active ), Expired, or Terminated.
    • Operation rate—Number of assigned seats over the total number of seats in this license.
    • End date—Date the license expires.

    To view the details of a particular license, click on that license’s name.

  • The remaining number of seats from all commercial and trial licenses in the account.