Device Registration Error

Zebra Access Management System (ZAMS) Troubleshooting Guide

This section explains how to register Android 10 and 11 devices when facing permission issues.

The error occurs due to permission issues when obtaining the build serial number or

MANAGE_EXTERNAL_STORAGE

To resolve the issue, ensure to transfer the

AmsDeviceExecute.xml

file in the

/sdcard/Download/

directory on your device. Then, open the StageNow app and scan the V2 Barcode.

Device Configuration File

The following shows the

AmsDeviceExecute.xml

configuration file settings. The

AmsDeviceExecute.xml

configuration file is read each time it is transferred to the

/sdcard/Download/

directory on the device.

    
<wap-provisioningdoc>
  <characteristic version="5.1" type="AppMgr">
    <parm name="Action" value="Install" />
    <parm name="APK" value="/sdcard/Download/AmsDevice.apk" />
  </characteristic>
  <characteristic version="5.0" type="FileMgr">
    <parm name="FileAction" value="1" />
    <characteristic type="file-details">
    <parm name="TargetAccessMethod" value="2" />
    <parm name="TargetPathAndFileName" value="/enterprise/device/settings/datawedge/autoimport/dwprofile_amsPin.db" />
    <parm name="SourceAccessMethod" value="2" />
    <parm name="SourcePathAndFileName" value="/sdcard/Download/dwprofile_amsPin.db" />
    </characteristic>
  </characteristic>
  <characteristic version="5.0" type="FileMgr">
    <parm name="FileAction" value="1" />
    <characteristic type="file-details">
    <parm name="TargetAccessMethod" value="2" />
    <parm name="TargetPathAndFileName" value="/enterprise/device/settings/datawedge/autoimport/dwprofile_AmsDevice.db" />
    <parm name="SourceAccessMethod" value="2" />
    <parm name="SourcePathAndFileName" value="/sdcard/Download/dwprofile_AmsDevice.db" />
    </characteristic>
  </characteristic>
  <characteristic version="6.0" type="DevAdmin">
    <characteristic type="AppAsDevAdmin">
    <parm name="DevAdminAction" value="1" />
    <characteristic type="DevAdminDetails">
    <parm name="DevAdminPkg" value="com.zebra.ams.device" />
    <parm name="DevAdminClass" value="com.zebra.backsafe.android.splash.BacksafeAdmin" />
    </characteristic>
    </characteristic>
  </characteristic>
  <characteristic version="4.3" type="Intent">
    <parm name="Action" value="StartActivity" />
    <parm name="ActionName" value="android.intent.action.MAIN" />
    <parm name="Package" value="com.zebra.ams.device" />
    <parm name="Class" value="com.zebra.backsafe.android.splash.SplashActivity" />
  </characteristic>
  <characteristic version="4.2" type="XmlMgr">
    <parm name="ProcessingMode" value="2" />
  </characteristic>
  <characteristic version="6.0" type="ConditionMgr">
    <parm name="DataType" value="3" />