Manage devices

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

View device information

  1. Log in to the Knox E-FOTA One portal.
  2. Go to DevicesAll Devices.
  3. (Optional) In Search, 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.

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 One app installed on the device.
  • Campaign—Campaign the device is assigned to (if any).
  • Status—Current status of the device. See Device statuses.
  • Carrier Code—Device carrier code 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 the device was added and the user that added it.
  • Modified—Date 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 the device belongs to (if any).
  • Source—How the device was added: through an EMM, reseller upload, or CSV 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 the license was issued.
  • License end date—Date 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 One 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 One 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.

NOTE—Changes in the sales code does not affect the device status.

Status Description
Pending (visible only in Devices > Uploads) The reseller has uploaded the device but an admin has not approved it.
Not enrolled

The upload was approved by an IT admin. The device is now in the device candidate pool and is ready to be enrolled.

A device that was previously enrolled also has this status if an admin unenrolls it. In this case, the following occur:

  • The device loses its license seat.
  • The device is unassigned from any campaign it's assigned to.
  • The Knox E-FOTA client is automatically uninstalled from the device.
  • Any default Knox E-FOTA policies applied to the device are removed. For example:
    • The B2C FOTA client is enabled.
    • Factory reset is allowed on the device.
    • Recovery mode is allowed on the device.
Enrollment pending

An IT admin has enrolled the device under a valid license key.

One of the following:

  • The device is waiting for the Knox E-FOTA client to be installed.
  • The Knox E-FOTA client is installed and is waiting to complete provisioning. The provisioning process involves the following:
    • Downloading and installing the Knox E-FOTA client.
    • Registering the device information to the Knox E-FOTA server.
    • Disabling the B2C FOTA client.
    • Applying a default Knox E-FOTA policy.

Provisioning is complete; the device is enrolled.

A device also has this status if:

  • Its license expires. In this case, no campaign can be assigned to the device until there is a valid license for it.
  • The device that was previously assigned to a campaign is unassigned.
Failed to enroll

The device failed to enroll to the Knox E-FOTA service due to any of the following reasons:

  • The device failed to install the Knox E-FOTA client.
  • The license of the device expired while it was in Enrollment pending state.
  • A network failure occurred.
  • Other error cases occurred, for example, the default Knox E-FOTA policy was not applied to the device.
Campaign assigned

An admin has assigned the device to a campaign.

A device also has this status if:

  • The campaign it's assigned to has been scheduled.
  • The campaign it's assigned to has ended.
Campaign canceled An admin has canceled the campaign the device is assigned to.
Campaign error An error occurred while the device was attempting to apply the campaign policy.
Campaign failed An error occurred while attempting to download or install the firmware update.
Campaign active
  • Campaign active (locked firmware)—The campaign has locked the firmware of the device.
  • Campaign active (downloading)—The device is downloading the firmware update.
  • Campaign active (ready to install)—The device was able to download the firmware update and will install it during the "FOTA allowed period"
  • Campaign active (installing)—The device is installing the firmware update.
  • Campaign active (update complete)—The device has been updated to the target firmware version.
  • Campaign active (update complete)—The device already has a higher version than the target version set in the campaign.
Exchanging The IMEI or serial number is in the process of being changed by a Samsung Admin.
Reverting The device is trying to revert to normal firmware from a dummy binary. When this is complete, the device's status changes to one of the statuses above.
Error A system error has occurred. View the device log for more information.
Unenrollment pending An admin has unenrolled the device through the Knox E-FOTA admin portal, but the unenrollment has not reached the device.

Perform common operations on devices

NOTE—For devices that were synced from an EMM, most operations can only be performed in the EMM groups tab.

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

  • Enroll devices
  • Assign devices to a campaign
  • Create a campaign
  • Replace a license
  • Push a campaign
  • Unassign a campaign from devices
  • Unenroll devices
  • Delete devices
  • Download devices as CSV
  • View the device deletion log

To perform a common operation on one or more devices:

  1. Log in to the Knox E-FOTA One portal.
  2. Go to DevicesAll Devices.
  3. Select the checkboxes corresponding to the relevant devices.
  4. Click Actions and select the operation you want to perform.

See also

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. Log in to the Knox E-FOTA One portal.
  2. Go to DevicesAll Devices.
  3. Click the device ID of the device you want to view.
  4. In the Device details popup, click View device log.
Share it: