OS Update (multiple packages) using SOTI MobiControl Mxconfig Script

Article ID: 68867499

Issue / Question

How to perform OS update - multiple OS update package - using SOTI MobiControl's mxconfig script command?
Device is enrolled in DO mode, how to update the OS using XML file and mxconfig?
OS update using upload list file .UPL

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 Tool

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 > Since applying multiple OS update packages at one time, specify the path and filename to upload text file (with .UPL extension) 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 Android Plus File Sync Rule. Read 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. Refer to Part 1 Step 7. 
  4. Under Server File / Folder Name, specify folder path to OS update package .ZIP, .UPL and .XML files.
  5. Select the device(s) and/or device group(s) that the rule should target.
  6. For synchronization, use Device Update Schedule.
  7. Under review summarized information, select Advanced button.
  8. Scroll down and select Scripts button.
  9. Under the After file synchronization has completed execute script section, enter below script.
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