Troubleshoot and see potential issues on Android Zebra devices in Microsoft Intune

Article
06/27/2024

In Microsoft Intune, you can use Zebra Mobility Extensions (MX) to manage Android Zebra devices. When using Zebra devices, you create profiles in StageNow to manage settings, and upload them to Intune. Intune uses the StageNow app to apply the settings on the devices. The StageNow app also creates a detailed log file on the device that's used to troubleshoot.

This feature applies to:

Android device administrator

For example, you create a profile in StageNow to configure a device. When you create the StageNow profile, the last step generates a file for you test the profile. You consume this file with the StageNow app on the device.

In another example, you create a profile in StageNow, and test it. In Intune, you add the StageNow profile, and then assign it to your Zebra devices. When you check the status of the assigned profile, the profile shows a high-level status.

In both these cases, you can get more details from the StageNow log file, which is saved on the device every time a StageNow profile applies.

Some issues aren't related to the contents of the StageNow profile, and aren't reflected in the logs.

This article shows you how to read the StageNow logs. It also lists some potential issues with Zebra devices that may not be reflected in the logs.

Important

Microsoft Intune is ending support for Android device administrator management on devices with access to Google Mobile Services (GMS) on December 31, 2024. After that date, device enrollment, technical support, bug fixes, and security fixes will be unavailable. If you currently use device administrator management, we recommend switching to another Android management option in Intune before support ends. For more information, see Ending support for Android device administrator on GMS devices.

Use and manage Zebra devices with Zebra Mobility Extensions has more information on this feature.

Get the logs

Use the StageNow app on the device

You don't have to use Intune to deploy the profile. Instead, you can test a profile directly using StageNow on your computer. The StageNow app on the device saves the logs from the test. To get the log file, use the More (...) option in the StageNow app on the device.

Get logs using Android Debug Bridge

To get logs after the profile is deployed with Intune, connect the device to a computer with Android Debug Bridge (adb) (opens Android's web site).

On the device, logs are saved in /sdcard/Android/data/com.microsoft.windowsintune.companyportal/files.

Get logs from email

To get logs after the profile is deployed with Intune, end users can email you the logs using an email app on the device. On the Zebra device, open the Company Portal app, and send the logs. Using the send logs feature also creates a PowerLift incident ID, which you can reference if contacting Microsoft support.

Read the logs

When you look at the logs, there's an error whenever you see the <characteristic-error> tag. Error details are written to the <parm-error> tag > desc property.

Error types

Zebra devices include different error reporting levels:

The CSP isn't supported on device. For example, the device isn't a cellular device and doesn't have a cellular manager.
The MX or OSX version is mismatched. Each CSP is versioned. For a full support matrix, go to Zebra's documentation (opens Zebra's web site).
The device reports another issue or error.

Examples

For example, you have the following input profile:

<wap-provisioningdoc>
    <characteristic type="Clock">
        <parm name="AutoTime" value="false"/>
        <parm name="TimeZone" value="GMT-5"/>
        <parm name="Date" value="2014-12-03"/>
        <parm name="Time" value="11:11:11"/>
    </characteristic>
</wap-provisioningdoc>

In the log, the XML is identical to the input. This matching output means the profile successfully applied to the device with no errors:

<wap-provisioningdoc>
    <characteristic type="Clock" version="6.0">
        <parm name="AutoTime" value="false"/>
        <parm name="TimeZone" value="GMT-5"/>
        <parm name="Date" value="2014-12-03"/>
        <parm name="Time" value="11:11:11"/>
    </characteristic>
</wap-provisioningdoc>

In another example, you have the following input:

<wap-provisioningdoc>
    <characteristic type="XmlMgr" version="4.2" >
        <parm name="ProcessingMode" value="1"/>
    </characteristic>
    <characteristic type="AppMgr" version="4.2" >
        <parm name="Action" value="Install"/>
        <parm name="APK" value="/sdcard/test.apk"/>
    </characteristic>
</wap-provisioningdoc>

The log shows an error, as it contains a <characteristic-error> tag. In this scenario, the profile tried to install an Android package (APK) that doesn't exist in the given path:

<wap-provisioningdoc>
    <characteristic type="XmlMgr" version="4.2">
        <parm name="ProcessingMode" value="1"/>
    </characteristic>
    <characteristic-error type="AppMgr" version="5.1" desc="missing">
        <parm-error name="Action" value="Install" desc="apk doesnot exist in the path"/>
        <parm name="APK" value="/sdcard/test.apk"/>
    </characteristic-error>
</wap-provisioningdoc>

Other potential issues with Zebra devices

This section lists other possible issues you may see when using Zebra devices with Device Administrator. These issues aren't reported in the StageNow logs.

Android System WebView is out of date

When older devices sign in using the Company Portal app, users may see a message that the System WebView component is out of date, and needs upgraded:

If the device has Google Play installed, then connect the device to the internet, and check for updates.
If the device doesn't have Google Play installed, then get the updated version of the component, and apply it to the devices. Or, update to the latest device OS issued by Zebra.

Management actions take a long time

If Google Play services aren't available, then some tasks take up to 8 hours to finish. Limitations of Intune Company Portal app for Android (opens another Microsoft web site) may be a good resource.

"Device spoofing suspected" shows in Intune

This error means that Intune suspects a non-Zebra Android device is reporting its model and manufacturer as a Zebra device.

Company Portal app is older than minimum required version

Intune may update the minimum required version of the Company Portal app. If Google Play isn't installed on the device, then the Company Portal app doesn't get automatically updated. If the minimum required version is newer than the installed version, then the Company Portal app stops working. Update to the latest Company Portal app using sideloading on Zebra devices.

Next steps

Zebra discussion boards (opens Zebra's web site)

Use and manage Zebra devices with Zebra Mobility Extensions in Intune

Partager via