Apply a firmware update to devices

To apply a firmware update to devices, you must create a campaign and specify which firmware version will be pushed. You then assign devices to that campaign. When you activate the campaign, the firmware update is pushed to the assigned devices. Every 24 hours from the time the campaign is activated, the Knox E-FOTA client app on the assigned devices automatically polls the Knox E-FOTA server to check for any policy changes made to the campaign.

This section describes how to create a test campaign and a real campaign.

NOTE—You must enroll devices first before you can assign them to a campaign.

Create a test campaign

A test campaign allows you to test the campaign policies using a dummy firmware version.

NOTE—When you're done with your test campaign, revert your devices back to your regular firmware by unassigning them from the test campaign. You cannot apply a real campaign on a device that has dummy firmware.

  1. Log in to the Knox E-FOTA One portal.
  2. In the Campaigns tab, click Actions > Create Test Campaign.

  3. Click Assign Devices.

  4. From the device list, select one or more devices to assign to the test campaign.

    NOTE—When creating a test campaign, you can’t select a firmware version to apply. Instead, a dummy firmware will be applied by default.

  5. Click Assign.

  6. Click Create and Activate.

    The campaign is added to the Campaigns list.

  7. Check the device for the dummy firmware update. If the campaign is applied successfully, the device status changes to Campaign Active.

    In the following example, the dummy firmware to be applied has the file extension .DM.

  8. When you're done with your test campaign, revert the dummy firmware to regular firmware.
    1. Go to DevicesAll Devices.
    2. Click Action > Unassign campaign.

    The device status changes to Enrolled and the dummy firmware is reverted to regular firmware.

Create a campaign

  1. Log in to the Knox E-FOTA One portal.
  2. Go to Campaigns and then click Create Campaign.

  3. Assign devices to the campaign:
    1. Click Assign Devices.
    2. In the Assign devices screen, select one or more devices to assign to the campaign.

      NOTE—By default, the device list is pre-filtered to show only the following:

      • Devices that aren't assigned to any campaign.
      • Devices assigned to expired or canceled campaigns.

      If you want to select a device currently assigned to an active campaign, click Clear Filters.

      Device that are not enrolled are excluded from the device list. Only enrolled devices can be assigned to a campaign.

    3. Click Assign.

      The table at the bottom of the form is populated based on the devices you selected.

  4. In the table, select a firmware version to push for each device model you selected. You can also lock the device to the current firmware version.

    NOTE—For device models that are newly added to the Knox E-FOTA service, it may take a few hours to for the list of applicable firmware versions to become available. If you do not see the firmware list for a device model you've just added, try again in a few hours.

  5. Click Create and Activate.

    A notification is displayed confirming that the campaign was created. The campaign is added to the Campaigns list.

NOTE—A device that is off during this campaign period will have a pending status until the device is turned on. If the device remains off during the duration of the campaign period, it won't receive the command to update.
NOTE—In some cases, especially when upgrading devices to a major Android OS version, several firmware updates are installed incrementally to reach the target firmware version, even if you only applied one campaign. This will result in devices automatically rebooting multiple times, corresponding to the number of firmware updates that actually occurred.