Installation

Device Tracker 5.2

Overview

Device Tracker is a cloud-based solution that consists of:

  • A cloud-based server that is hosted and managed by Zebra.
  • A client software that runs on Zebra Android devices.

Client app installation is required for the device to communicate with the server and for devices to be tracked by the solution. This section discusses how to install and enable Device Tracker on the mobile device. To access Device Tracker server, the first step is to procure Device Tracker licenses.


Installation Notes

  • During a Google Play Services update, the Android system automatically stops Device Tracker. After the update is complete, relaunch the Device Tracker app or reboot the device to continue tracking of the device.
  • Backward Compatibility - Device Tracker Cloud Server v5.0 or above supports Client software versions 4.0, 4.1 and 4.2. Starting on January 1, 2023, Device Tracker Cloud Server will no longer support Device Tracker Client versions 4.0, 4.1 and 4.2. The device must be upgraded with Device Tracker Client version 5.0 or above. See Zebra Support Portal for the latest Device Tracker client.
  • Config Service Notification - When Device Tracker client is configured for the first time, a notification appears indicating the Config Service is running. This notification disappears after a subsequent device reboot.

Requirements

Device Requirements

Requirements for Device Tracker client on the device:

  • Supported Devices - See compatible devices table on the Zebra support portal.
  • Operating System - Only supported on select Android 8 Oreo, Android 10 and Android 11 GMS devices. See Device Tracker Support on Zebra support portal for compatible devices.
    Note: For Android 11, all LifeGuard updates support Device Tracker except for LG update 11-20-18.00, which requires May LG update 11-23-13.00 for support. For A11 LG updates, see the respective product page in Zebra support portal.
  • Optionally, Secondary BLE allows a device to be located if it loses battery power or is powered off. This feature is available on select hardware that are capable of secondary BLE; see the device compatibility table. Also see Secondary BLE Configuration for instructions to enable this feature.
  • Device licenses are required for Device Tracker to operate. Contact a Zebra reseller to procure licenses.

Network Requirements

Network requirements for communication between the device client app and the cloud server:

  • Open HTTPS port. By default, port 443 is typically used for HTTPS communication. However, this may vary based on network configuration.

  • For administrators and managers to access the web portal (supplied by Zebra during onboarding), allow the web portal URL through the firewall or proxy .

  • An email is sent from zdtrksupport@zebra.com if reporting is enabled and if the password is reset.

  • For device access and communication to the cloud server, specific domain names must be allowed through the firewall or proxy.

    • If the firewall or proxy supports wildcards, add the following domain names to the allow list:

      • connectivitycheck.gstatic.com 0
      • *.googleapis.com
      • *.firebaseio.com
      • *.cloudfunctions.net
      • [ProjectID].firebaseapp.com 1
      • [Web portal URL] (supplied by Zebra during onboarding)
    • If the firewall or proxy does not support wildcards, add the following domain names to the allow list:

      • connectivitycheck.gstatic.com 0
      • www.googleapis.com
      • firestore.googleapis.com
      • cloudfunctions.googleapis.com
      • us-central1-[ProjectID].cloudfunctions.net 1
      • [ProjectID].firebaseio.com 1
      • [ProjectID]-default-rtdb.firebaseio.com 1
      • *.firebaseio.com 2
      • [ProjectID].firebaseapp.com
      • [Web portal URL] (supplied by Zebra during onboarding)

    0 ICMP or TCP Echo Requests must not be blocked by your firewall.

    1[ProjectID] is supplied by Zebra services during the onboarding process. An XML file is provided, which contains a string similar to:

    <parm name="ProjectId" value="<customer name>-dtrk-na-p" />
    

    The "value" field contains the ProjectID enclosed in double quotes. In this example, the project ID is: <customer name>-dtrk-na-p

    2 Used by Device Tracker client to communicate with Device Tracker realtime database. Google Firebase SDK uses the URLs internally. The active URL depends on Google resource allocation and changes dynamically. Zebra recommends to use the URL with wildcard. To retrieve the latest URL that is being used, create a script to regularly look up the URL using https://[ProjectID]-default-rtdb.firebaseio.com/.settings/owner.json (or https://[ProjectID].firebaseio.com/.settings/owner.json) and update the rules accordingly.

Web Portal Requirements

The web portal allows adminstrators to (1) configure Device Tracker, (2) manage users, (3) manage access points, sites, and devices, (4) automate workflows, (5) generate reports, and (6) view licenses. The web portal URL is supplied by Zebra during onboarding.

To access the web portal, in a supported browser enter the web portal URL. The supported browsers are:

  • Chrome
  • Edge
  • Safari (v14.0 and later)

For first-time use, the administrator must set their password. Click Forgot Your Password in the web portal and enter the administrator email address, which is registered as a user in the system during onboarding. An email will be sent to the administrator with a link to set the password in order for the administrator to login.

If using single sign-on (SSO), see SSO for procedures on configuring SSO.

Licenses

End-user licenses are required for Device Tracker to operate. Additionally, separate BLE licenses are required for secondary BLE operation, allowing devices to be tracked even after losing battery power. See Licensing.


Install Manually

Steps to manually install Device Tracker client app on the device:

  1. Open the required ports and allow the domains specified in network requirements for the device to communicate to the cloud server.
  2. Connect the device to a Wi-Fi network that can access the cloud server based on the network requirements.
  3. Enable Bluetooth and Location services on the device to allow device tracking.
  4. Download Device Tracker client from Zebra support portal and install it on the device.
  5. Launch Device Tracker app. Grant all permissions when prompted:
    • Choose option “Allow all the time” when granting Location permissions.
    • Allow permission for Device Tracker to always run in the background.
    • Grant overlay permissions. Additional steps are required:
      1. In apps, tap and hold the Device Tracker icon to show App info. Tap on this option.
      2. Scroll down and tap Advanced.
      3. Tap Display over other apps.
      4. Toggle to enable Allow display over other apps.
  6. Launch StageNow client and scan the barcode from the .PDF file provided by Zebra during the onboarding process. This configures Device Tracker with the cloud server settings.
  7. Optionally, enable secondary BLE to allow devices that support this feature to be located even when powered off. Follow instructions in Secondary BLE Configuration to enable and configure secondary BLE.

Install through EMM

For mass deployment, install Device Tracker client on devices through an EMM. A server connectivity XML file is provided by Zebra services to configure Device Tracker with the server settings.

Installation Steps

To install and configure Device Tracker through an EMM - all steps must be followed sequentially:

  1. Open the required ports and allow the domains specified in network requirements for devices to communicate to the cloud server.
  2. Connect the device to a Wi-Fi network that can access the cloud server based on the network requirements.
  3. Enable Bluetooth and Location services on the device to allow device tracking, if Bluetooth and Location services are disabled or restricted.
  4. Download Device Tracker client from the Zebra support portal and deploy it to the device through EMM.
  5. Grant the required permissions through EMM (refer to the EMM guide) based on the Android platform. For any platform versions not mentioned below, permissions are automatically granted.
    • For Android 11 devices with LG version 11-20-18.00-RG-U02 or lower or Android 10 devices with LG version 10-16-10.00-QG-U111 or lower, grant the following permissions:
      • android.permission.ACCESS_BACKGROUND_LOCATION – Required to find devices using the Bluetooth proximity meter.
      • android.permission.ACCESS_FINE_LOCATION – Required to find devices using the Bluetooth proximity meter.
    • For Android 8, for TC51 and MC3300 devices with LG version 02-52-21.00-OG-U00 or lower or other devices with LG version 01-30-04.00-OG-U41 or lower, grant the following permissions:
      • android.permission.ACCESS_FINE_LOCATION – Required to find devices using the Bluetooth proximity meter.
      • android.permission.READ_PHONE_STATE – Required to read the device serial number and register devices with the Device Tracker server for tracking.
  6. Download and deploy Device Tracker setup XML to MX through EMM. This grants permissions to display over other apps, disables battery optimization and starts the device tracking service.
  7. Download and deploy the server connectivity settings XML to MX through EMM provided by Zebra during the onboarding process. If steps 6 and 7 are skipped, an error may occur indicating the device has not registered with MX Framework. Refer to the EMM guide for XML deployment.
  8. Optionally, enable secondary BLE to allow devices that support this feature to be located even when powered off. Follow instructions in Secondary BLE Configuration to enable and configure secondary BLE.

Upgrade

Important notes pertaining to Device Tracker when upgrading from a previous version:

  • If upgrading from v5.0, both server and clients must be upgraded in order to utilize the new features. Failure to do so may result in an error when using new features.
  • If upgrading from Device Tracker 5.0 or lower, sites imported via .CSV file on the device must be updated with the local time zone information in order for the new data reporting features to work.
  • If upgrading from a version below v5.0, Device Tracker must be uninstalled before installing this version. Starting with v5.0, a change was required to the app package name and app signature, resulting to new MX XML and server connectivity XML files. Follow the updated installation instructions to generate the new deployment package.

Uninstallation

Instructions to uninstall Device Tracker from the device, remove the Device Tracker client app manually or through an EMM.

Termination

To terminate Device Tracker Cloud, contact Zebra services. This removes the cloud server instance and deletes all data stored.


See Also