Premium APIsSoftware ManagementGuidesGetting Started

Campaign Lifecycle Flow for v2

Campaign Lifecycle Flow for HTTP Devices using the /v2 Resource Path

v2CampaignLifeCycle fix

  1. Creating a campaign starts with the user scheduling which devices with proper make, model and current software prerequisites need to be updated with which software at what date.
  2. Once the user schedules a campaign request, the campaign changes to “Request Pending” status
    • After passing parameter checks, campaign status typically moves to "Queued" status.
    • If parameter checks fail, it moves to "RequestFailed" and may bypass "Pending."
      Checks could include eligibility such as licenses, FOTA capable, prerequisistes or timing checks.
    • If it is an on-demand campaign, it bypasses the "Queued" status and moves to "Scheduled."
  3. The campaign normally stays in "Queued" status while the system collects requests.
    • Once the start date has begun, it moves to "Scheduled."
    • The user can choose to cancel the campaign in "Queued" status.
  4. The campaign stays in "In Progress" during the device update.
    • Once the campaign end date has been reached or if all devices were successfully upgraded, it moves to “ended.” For an on-demand campaign, the end date is one week after the start date.
    • After the campaign begins but before it ends, the user could decide to “abort” the campaign. Some devices may have already been upgraded.

Device Lifecycle Flow for HTTP Devices using the /v2 Resource Path

HTTPDeviceLifecycleFlow fix

Status and Error Messages for HTTP Devices using the /v2 Resource Path

Device StatusDevice Detail Status
AcceptedDevice cleared all checks so it can be added to the scheduled list.
DeviceRejectedDevice not found.
DeviceRejectedDevice scheduled for firmware upgrade previously, needs to be completed before another upgrade is scheduled.
DeviceRejectedDevice not eligible for service (not FOTA capable)
DeviceRejectedInvalid device IMEI.
DeviceRejectedCurrent device software version does not meet software prerequisites.
DeviceRejectedDevice make/model does not meet software prerequisites.
DeviceRejectedDevice is not in active state or is not connected.
DeviceRejectedInternal Error.
UpgradedFailed for UpgradePendingRovaClientDidNotReportStatus
UpgradedFailed for UpgradePendingRovaClientDownloadFailed
UpgradedFailed for UpgradePendingRovaClientDownloadNotInstalledYet
UpgradedFailed for UpgradePendingRovaClientDownloadedInstallFailed
UpgradedFailed for UpgradePendingUknown device error.
UpgradedFailed for UpgradePendingOther.
CampaignCancelledCampaign canceled by user.
UpgradeSuccessDownload and install succeeded.
CampaignAbortedCampaign aborted by user.

On this page