Create a campaign

  1. Sign in to the Knox Admin Portal. In the navigation pane, click Knox E-FOTA.
    1. Go to Campaign and then click Create Campaign.

      campaign page

      • On the Devices tab, you can customize the table columns to include each device's Consumer Software Customization (CSC). When you export the device list to a CSV file, the CSC info is also included.
      • When viewing a device's Device details, you can obtain that device's CSC.
      • When assigning target devices to a campaign, fill in the Assign Devices and Firmware table on the campaign creation page. Each row of that table represents a device group, that is, a model and sales code pair. The CSC of each device group is pre-populated next to the sales code. For device groups that have multiple possible CSCs, a list is available instead, from which you can select the CSC for that group.
      • When you move on to select the target firmware for a device group, only the firmware versions that are compatible with that device group are available, given the group's model, sales code, and CSC.
      • When creating, editing, and viewing a campaign, you can obtain the CSCs of devices in that campaign.
  2. Assign devices to the campaign:
    1. Click Assign Devices.
    2. On the Assign devices page, 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.

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

      When you download the device list as a CSV file, the file will contain the version of the Knox E-FOTA client app installed on each device.

    3. Click Assign.

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

  3. For each row in the table, click on EDIT and do one of the following:

    • Click Latest firmware if you want the campaign to automatically push the latest firmware version to the assigned devices. Additionally, select one of the following:

      • Any — The latest firmware, regardless of its OS version, is pushed to devices.

      • Up to — The latest firmware, within a particular OS version, is pushed to devices.

        IMPORTANT — If you select this option, you may not receive security patches included in the latest firmware of the latest OS version.

        If no firmware meeting your criteria is available for devices of a particular model-carrier pair, an error is displayed.

    • Click Lock current firmware if you want to prevent any firmware from being installed on the corresponding devices.

    • Click Select from firmware list if you want to select a firmware version to push to the corresponding devices. Then, select the target firmware in the next page.

    add firmware

    • 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.
    • If Knox E-FOTA is in the process of syncing the firmware list for your assigned devices, you'll have to wait until the firmware sync is complete. You'll receive an email notification when the firmware is ready to be used.
    • If you purchased the Software Customization Services license, you can request custom firmware from a Samsung admin. Once you've received custom firmware from a Samsung admin, you'll find it in the Custom Firmware tab when selecting your target firmware.
    • If you have purchased support for Enterprise Security Patches (ESP), you can select them as target firmware in the firmware list.
  4. Click Create and Activate.

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

  5. (Optional) Set gradual campaign rollout

    You can choose to randomly and gradually rollout campaigns to devices. You can rollout the campaign at a certain rate to a random set of devices daily. For example, 5% of the devices can start a firmware download on the first day, the next 5% on the day after, and so on. This feature helps with troubleshooting and discovering critical issues with firmware rollout and prevents the spread of bad firmware to all company devices.

    gradual campaign rollout
  • 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.

  • 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 process results in devices automatically rebooting multiple times, corresponding to the number of firmware updates that actually occurred.

Assign devices to an existing campaign

You can assign devices to an existing campaign:

  1. Go to Devices.

  2. Select the devices you want to assign.

  3. Click ACTIONS > Assign campaign.

  4. Select which campaign to assign the devices to.

  5. Click ASSIGN.