Back to top

Manage devices

Last updated September 6th, 2023

This section describes how to use tools in the Devices tab to manage devices in Knox E-FOTA. View device information, edit devices, delete devices, and label devices in this tab.

View device information

  1. Sign in to the Knox Admin Portal. In the left sidebar, click Knox E-FOTA.

  2. Go to Devices > DEVICES.

  3. (Optional) In the Search field, enter a search string to refine the device list. You can search on the following fields:

    • Device ID
    • Model
    • Campaign
    • Tags
  4. Review the list of devices.

Note

To generate a list of devices, click Actions > Download devices as CSV. If no devices are selected, all devices are included in the CSV file.

Each device has the following details:

  • IMEI/MEID — Unique ID associated with the device.

  • Model — Device model.

  • Firmware version — Firmware version installed on the device.

  • OS version — Android OS version installed on the device.

  • Agent version — Version of the Knox E-FOTA client app installed on the device.

  • Campaign — Campaign the device is assigned to (if any).

  • Status — Current status of the device. See Device statuses for more details.

  • Carrier Code — Device carrier code is specified from multiple Consumer Software Customization (multi-CSC) when a carrier specific SIM card is inserted.

  • Security patch info — Android security patch currently applied to the device.

  • Added — Date when the device was added and the user that added it.

  • Modified — Date when the device was last modified. For example:

    • The device was added.
    • The device’s status changed.
    • The campaign changed.
    • The license changed.
    • The source changed.
    • The EMM group changed.
  • EMM group — Device group in the EMM that the device belongs to (if any).

  • Source — How the device was added, either through an EMM, reseller upload, or CSV file upload.

  • Last Seen — Last time the Knox E-FOTA server was able to ping the device.

  • OS Version — Current OS version of the device.

  • License — License the device is enrolled under.

  • License start date — Date when the license was issued.

  • License end date — Date when the license expires.

  • Order Number — Order number the device was purchased under.

  • Previous IMEI/SN(s) — Previous IMEI or serial number of the device, if it has been exchanged.

  • Tags — Labels associated with the device (if any). There are two types:

    • System tags — Labels that Knox E-FOTA automatically assigns to devices. You cannot delete these. For example:

    • DUMMY — The device has a dummy binary installed through a test campaign.

    Note

    Devices synced to Knox E-FOTA from an EMM cannot be assigned a test campaign, so they will never have this system tag.

    • Custom tags — Custom labels you can assign to devices.

Device statuses

This section describes the different statuses devices can have and what they mean:

  • Operation status: Describes the status of the device licensing and campaign sync.

  • Campaign status: Describes the status of an assigned campaign.

  • Client status: Describes the status of the Knox E-FOTA client app on the device.

  • Update status: Describes the status of a firmware update, information that is now also included in the Device Update Status dashboard and Campaign Graph.

For details about a status, hover over the status to display a tooltip description.

Perform common operations on devices

You can perform the following operations on one or more devices:

  • Assign campaign
  • Create campaign
  • Replace license
  • Manage device tags
  • Unassign campaign
  • Unenroll devices
  • Delete devices
  • Force client refresh
  • Download devices as CSV
  • View device log
  • View the device deletion log

To perform a common operation on one or more devices:

  1. Sign in to the Knox Admin Portal. In the left sidebar, click Knox E-FOTA.
  2. Go to Devices > All Devices.
  3. Select the checkboxes corresponding to the relevant devices.
  4. Click Actions and select the operation you want to perform.

Additionally, see Add devices to know more about adding devices.

View a device log

The device log shows a list of events that occurred on a device. For each event, the resulting device status is shown along with the timestamp.

  1. Sign in to the Knox Admin Portal. In the left sidebar, click Knox E-FOTA.
  2. Go to Devices > All Devices.
  3. Click the device ID of the device you want to view.
  4. In the Device details popup, click View device log.

Tag a device

Tagging is useful if you want to label devices and easily search for them in the device list. For example, you can label devices by their business function or by the location of their device users. This section describes how to tag a single device. If you want to tag multiple devices at once with the same tags, see Perform common operations on devices.

  1. Sign in to the Knox Admin Portal. In the left sidebar, click Knox E-FOTA.
  2. Go to Devices > All Devices.
  3. Click the device ID of the device you want to tag.
  4. In the Device details dialog, under the Tags field, enter the labels to associate with the device. For example: sales.
  5. Click Save.

Is this page helpful?