Deploying DataWedge Configurations to Zebra Devices Using SOTI MobiControl

This article explains how to deploy reference Zebra device DataWedge setting configurations to multiple Zebra devices that are enrolled in SOTI MobiControl using file sync policies.

SOTI MobiControl

Android Classic;Android Enterprise

Before you start:

1. Install the StageNow application on a PC/Server by visiting the following link: StageNow Installation

2. Confirm the Zebra device MX version.

 

Note: The minimum required version of the Zebra MX firmware is MX 7.1.1.0. However, SOTI recommends using the latest available version. You can upgrade the MX firmware version through an OS upgrade. To find the MX version of a Zebra device, go to Settings > About Phone > SW Components > MX.

 

Note: Using a higher MX firmware version in the barcode creation process may result in MX version errors when configuring a device with a lower MX version. While it is possible to configure devices with higher MX versions using lower MX versions, it is not recommended, as higher MX versions typically provides more configuration options.

 

There are three primary steps to deploy reference Zebra device DataWedge setting configurations to multiple Zebra devices.

 

1.1. If you do not have a reference device that you intend to match with the DataWedge configurations of your other Zebra devices, configure the DataWedge settings on a device to use as a reference device.

 

1.2. Open the DataWedge application on the device, select the three dots icon in the upper-right corner, and then select Settings:

 

 

 

1.3. You can choose to either export all profiles or select a specific profile. This example uses the export all profiles option. Select Export to export the current DataWedge configuration from the device.

 

 

1.4. Choose the location to export the profile configuration to. Note of the path for the exported profile configuration and select on Export.

 

 

1.5. Navigate to the chosen location to locate the exported datawedge.db file on your device. Save this .db file to your PC or server. (You will use this file later to execute the script in Step 3).

 

 

or

 

 

Note: For devices running Android 11 and above, establish an ADB connection to copy the .db file from your device. This is necessary because it is a hidden file and cannot be copied by other means.

 

Step 2: Finalize the configuration in StageNow

 

2.1. Within the StageNow application, select Create New Profile. This action opens the Profile Creation wizard.

 

 

2.2. Pick the appropriate MX firmware version and select OK. Refer to the Before you start section for guidance on the necessary MX version.

 

 

2.3. Select Xpert Mode.

 

 

2.4. Enter a profile name, and select Start.

 

2.5. In the Xpert Mode Configuration wizard, select the Settings tab, and then select DataWedgeMgr to add the configuration.

 

 

2.6. Select Add to include the configuration.

 

 

2.7. Specify the DataWedge configuration file path.

 

 

2.8. In the StageNow Config section, leave the other settings as default. Select Continue.

 

 

2.9. In the Review section, select unencrypted, and then select Complete Profiles.

 

 

2.10. In the Publish section, select the Export for MDM option to generate the XML file.

 

 

2.11. Save the file with the .xml extension. Select OK once you receive the Exported Successfully notification.

 

Step 3: Deploy DataWedge configuration to multiple Zebra devices using SOTI MobiControl

 

You now have two files:

• The datawedge.db file from Step 1.
• The DataWedgeConfiguration.xml file that you saved on your server/PC in Step 2.

To configure the DataWedge settings on your Zebra devices, send these two files to the devices and send out a post installation legacy script to execute the mxconfig.

 

Choose one of the following options:

• File Sync Policy: Use the File Sync Policy option by selecting Download from Server as File Sync Type. This will allow you to push the files to your Zebra devices. This is covered in the steps below.
• Create a Package: Alternatively, create a package by uploading these files and add the package to a profile. This will make the files accessible on the device(s) at the /sdcard/config device path.

 

File Sync Policy

 

3.1. In the SOTI MobiControl web console, access the File Sync option. Create a New File Sync Policy and then select Next.

 

3.2. Choose Download from Server as File Sync Type. In the File Settings section, fill in the following:

• In the Server File/Folder Name field, enter the path to your Zebra files (the .xml and .db files) on your server.
  • For example, C:\FileSync_File_Folders\Zebra_Config.
• In the Device File/Folder Name field, enter /sdcard/config.
• Select Next.

3.3. In the Post-Sync Script Settings section:

• Enable Enable Post-Sync Script.
• Select Custom as the Script Type.
• In the Script Editor, add mxconfig DataWedge_xml_Filepath_on_your_device.
  • For example: mxconfig /sdcard/config/datawedge_config.xml
• Enable Execute Script Only if Files Transmitted.
• Select Next.

3.4. Choose Device Update as the Schedule Type. Select Save and Assign. Target the File Sync Policy on a test device to verify that it is functioning as expected. Once confirmed, extend to other devices.

 

3.5. The script is executed after the file synchronization process and the DataWedge configuration on the target devices is identical to the configuration of the reference device.

To verify the process, on one of the test devices, ensure that there is an assigned File Sync Policy (created in the previous step) under the Configurations section, and confirm that its status is Assigned.

 

 

Ensure both DataWedge configuration files (.xml and .db files) are on the test device in the /sdcard/config path.