OS Update Payload

An OS update payload allows Zebra and Panasonic Android devices with external SD cards to download and install operating system update files from a URL location or hosted on Avalanche. The files delivered to the device are then installed without end user interaction.

Only Zebra and Panasonic devices with external SD cards can receive an OS update payload. By default, the SD card with the most available space is the target of this payload.

The following files are supported and are used to indicate update type:

•OS update packages (e.g., xxRUxx.zip)

•OS recovery packages (e.g., xxRBxx.zip)

•Patches

Files distributed with this payload can be hosted in the Central File Store. For information about managing files with the Central File Store, see Using the Central File Store.

Ivanti always recommends manually checking package types before deploying them to devices, as this can result in accidental rollbacks and user data loss.

The results of a deployed OS update payload are accessible via the OS Update Status report on Avalanche. This report shows the download and update status, including errors and completions. Not all errors can be reported to the Avalanche server as some updates, such as recovery packages, will erase the Avalanche Enabler. For more information, see Configuring Reports.

If multiple OS update payloads are deployed to the same device, all updates are applied to the device and will result in multiple updates. If the update fails, the device should automatically roll back to an operational status. It is possible to deploy an older version OS update to a device. If an update fails, you must manually control the update at the device level.

Before updating a device's operating system, ensure that the Avalanche enabler on the device will work with the new OS. You may need to update the enabler before updating the OS.

An OS update payload has the following options:

Payload name	The name of the payload.
Target device	The type of device that will receive the payload. Only Zebra and Panasonic devices with external SD cards can receive an OS update payload.
OS update file hosting	The location hosting the OS update file. You can pick one of the following options: •Avalanche. The update file is uploaded and stored in Avalanche. If a new update file is attached to this payload, the previous update file is overwritten. •URL. The full URL path to the OS update file, without the file name. Ivanti recommends only using this method to access secure files stored in your network.
File	The location of the OS file when Avalanche is selected as the OS update file hosting setting. You can browse for the file location by clicking Browse. The file must be in .zip format and contain OS update files. Avalanche will not automatically check to ensure the correct file types are included within the `.zip` file.
URL	The location of the OS file when URL is selected as the OS update file hosting setting. The URL must include an HTTP or HTTPS protocol. An absolute path with the file name is not supported.
Force OS Update	Forces the device to install the OS update file, regardless of whether the OS version already exists on the device.
Scheduled downloads	Sets a schedule for when the device can download OS updates. Updates are not downloaded until the criteria set by the Scheduled downloads setting are met. •Only download between _____ and _____. Specifies a time range for when the device is allowed to attempt an OS update download. The time is set using the HH:MM format with a 24-hour clock. This setting uses the device's local time zone. •Device must be docked (not running on battery). The device cannot actively download an update until it is docked and no longer running on its internal battery. We recommend keeping this setting selected, because if the device turns off mid-download it may result in a corrupted update file. You can also specify acceptable ways for downloading update files within your network. The connection options available include: •Ethernet •Wi-Fi •Cellular data
Scheduled updates	Sets a schedule for when the device can install any OS updates it has downloaded. These updates are not installed until the criteria set by the Scheduled updates setting are met. •Only update between _____ and _____. Specifies a time range for when the device is allowed to attempt an OS update install. The time is set using the HH:MM format with a 24-hour clock. This setting uses the device's local time zone. •Device must be docked (not running on battery). The device cannot actively install an update until it is docked and no longer running on its internal battery. We recommend keeping this setting selected, because if the device turns off mid-update it may result in a corrupted operating system.