Menu

Monitor Operations

This tutorial describes how to monitor operations.

An operation is the action that's performed on a target device set in a campaign. When a campaign is executed, it results in multiple operations generated for each device included in the campaign.

Monitor Operations

To monitor operations:

  1. Login to the Knox E-FOTA Advanced portal.
  2. Go to: Campaign Management > Operations.

The following details are displayed:

  • Device ID—International Mobile Equipment Identity number (IMEI).
  • Start Date—Start date and time the operation was created.
  • Model—Device model number and vendor.
  • Campaign Action—Action set when the campaign was created.
  • Campaign name—Campaign name indicated when the campaign was created.
  • Update Content—Content set to be updated, for example: the target software, profile name, or client configuration.
  • Status Info—Additional details related to the operation's status.
  • Retry #—Indicates the number of times the campaign has set the operation to retry.
  • Domain—Domain name indicated when the campaign was created.

Operation details

You can click the arrow beside the device ID to view additional details related to the operation.

Learn more about the details outlined:

  • Operation ID—Unique identifier of the operation. You can use this to apply a filter on the operations list.
  • Campaign ID—ID generated when the campaign was executed.
  • Campaign Run ID—A campaign generates a Campaign ID when executed, and since campaigns can be set to retry operations if a push update fails, each retry also generates a Campaign Run ID. Note that there can be more than one Campaign Run ID generated per campaign.
  • End date—End date and time of the operation, specified under Campaign period when the campaign was created.
  • Update Content—Displays the software's name for software updates, or displays the success/fail status for device configuration pushes.
  • Device inventory—Displays ID, name, vendor, version and variant details for software updates, or success/fail status for device configuration pushes.
  • Dependent Group—Lists the software, vendor, and version detail.
  • Updates—Displays the source and target version for software updates, or displays the FOTA device configuration.
  • Creation User—Displays the user name of the admin that created the operation.
  • DP retrieved from cache?—Displays true or false, depending on whether deployment packages were reused from the Knox E-FOTA Advanced portal cache.
  • Campaign Initiator—Displays the user name of the admin that created the campaign.
  • Download Time Slot—Displays the time range set by the admin for the device to download updates when the campaign was created.
  • Wi-Fi Only Expiration Date & time—Displays when the Wi-Fi only restriction expires.
  • Data download over mobile network—Displays Yes if downloads over a mobile network is allowed. Otherwise this displays No.
  • Max data downloaded over mobile network—Displays the maximum download size (in megabytes) permitted for download over a mobile network.
  • Network load—Displays the allowable data quota downloaded per time frame (in minutes or hours). This is set in campaign when customizing network options for network balancing.
  • Update Start Time—Displays the update start time set by the admin when the campaign was created.
  • Critical Update—Displays Yes if the critical update option was selected when the campaign was created. Otherwise, this displays No.
  • Silent Update—Displays Yes if the silent update option was selected when the campaign was created. Otherwise, this displays No.
  • Server Initiated Campaign—Displays Yes if the operation includes a server initiated message sent to device users. Otherwise this displays No.
  • Policy ID—Policy ID associated with the operations.

Filter operations

You can apply search filters to operations to narrow down what's displayed on the operations list. This is useful when generating specific export reports.

To set a filter on the operations list:

  1. Go to Campaign Management > Operations.
  2. Specify your desired filters.
  3. Optionally, select Filters for export only if the filters are for the purpose of generating an export. This ensures the filter is only applied until the export is generated, after which its automatically cleared after the specified date.
  4. Click Apply.

To clear the filters, be sure to click Reset if the Filters for export only wasn't selected.

Generate an Export Report

When setting a filter on the operations list, you can apply the filter for export purposes only, which is useful when generating a specific export report. Note that during installation, you can configure the system to send the report to an email or shared directory.

To generate a CSV file export report:

  1. Go to Campaign Management > Operations.
  2. Specify your desired filters.
  3. Optionally, select Filters for export only if the filters are for the purpose of generating an export. This ensures the filter is only applied until the export is generated, after which its automatically cleared after the specified date.
  4. Click Apply.
  5. Click Export.