OS Update (single package) using SOTI MobiControl Mxconfig Script

Article ID: 14447682

Issue / Question

How to perform OS update - single OS update package - using SOTI MobiControl's mxconfig script command?
The device is enrolled in DO mode, how to update the OS using an XML file and mxconfig?

Applicable To

Zebra Android 8.x and later

Resolution / Answer


StageNow - Power Manager
The Power Manager (PowerMgr) allows an app to perform certain OS and power-related actions on the device. These include rebooting or performing an OS update, resetting the device to a factory-fresh state, or putting the device into Sleep mode.

SOTI MobiControl - mxconfig
Submits XML configuration instructions to the MX layer of the device.


Part 1: StageNow.

Create an .XML file using StageNow. In this example, create a profile for Zebra Android Oreo SD660 based on this product family (TC52, TC57, TC72, TC77, or PS20).

NOTE StageNow v4.0 or greater must be installed in your PC.
  1.  Launch StageNow, click Create new Profile.
  2. From the Select a Wizard window, select MX version 8.1 or later.
  3. Select Xpert Mode then click Create.

  1. Enter a profile name. For example: Oreo_OS_Upgrade then click Start.
  2. Under the SETTINGS tab, select PowerMgr then click +.
  3. The CONFIG tab should list PowerMgr. Click Add to proceed.

  1. Under Create New Setting tab, perform the following changes: 
  • OS Action > Set as OS Upgrade (Upgrade only, supported on Android Oreo and above)Read on Reset Action.
  • ZIP or UPL File > Specify the path and filename of the OS package .ZIP file to be consumed when updating the device. Read on OS Update File.

  1. Click Continue, review if needed then click Complete Profile.
  2. Click Export for MDM to generate the .XML file.


Part II. SOTI MobiControl v13.3 or later.

Create a File Sync Rule under the Android Plus tab which includes the mxconfig script to submit the XML configuration instructions to the MX layer of the Android device.

  1. Create the Android Plus File Sync RuleRead on Android+ Creating File Sync Rules
  2. Set the Direction to Download file(sfrom Server to Devices.
  3. Fill in the Device File / Folder Name as  /data/tmp/public. Referring to Part 1 Step 7.
  4. Under Server File / Folder Name, specify folder path to OS update package .ZIP and .XML files.
  5. Select the device(s) and/or device group(s) that the rule should target.
  6. For synchronization, use the Device Update Schedule.
  7. Under review summarized information, select the Advanced button.
  8. Scroll down and select the Scripts button.
  9. Under the After file synchronization has completed execute script section, enter script below: 
mxconfig /data/tmp/public/Oreo_OS_Upgrade.xml
  1. Click OK then Finish.

IMPORTANT! Make sure to disable the file sync rule once the target device(s) have been updated successfully, or else it may run again based on the device update schedule.

Helpful Information:

+ Applicable Products

  • StageNow
  • StageNow