Troubleshoot and see potential issues on Android Zebra devices in Microsoft Intune
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:
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 checking 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, and lists some other potential issues with Zebra devices that may not be reflected in the logs.
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
When you test a profile directly using StageNow on your computer in, instead of using Intune to deploy the profile, 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 already 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
Get logs from email
To get logs after the profile is already 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 looking at the logs, there's an error whenever you see the
<characteristic-error> tag. Error details are written to the
<parm-error> tag >
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, see Zebra's documentation (opens Zebra's web site).
- The device reports another issue or error.
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, connect it to the internet, and check for updates. If the device doesn't have Google Play installed, 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, 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, the Company Portal app doesn't get automatically updated. If the minimum required version is newer than the installed version, the Company Portal app stops working. Update to the latest Company Portal app using sideloading on Zebra devices.
Zebra discussion boards (opens Zebra's web site)