Zebra Data Services (ZDS) Agent Verification Guide
June 2021
Overview
Zebra Data Service (ZDS) agent software is a continuous background service running on all supported Zebra devices. It is responsible for collecting and uploading analytics data from ZDS plug-ins and Zebra-authorized third-party apps. ZDS starts collecting and transmitting data from the first time the device is turned on and updates itself and the ZDS Plug-ins automatically. Data is uploaded to the Zebra analytics database every 24 hours by default, secured with HTTPS transport.
Zebra's VisibilityIQ (VIQ) service leverages ZDS agent data to provide actionable insight for Zebra Android mobile computers. ZDS data is required in all VIQF offerings to ensure users have the same level of visibility and insight, regardless of whether a customer has an MDM in place or not.
Verification Procedure
For VisibilityIQ Foresight customers, follow these steps to verify if ZDS is running on their devices and collecting/transmitting data to the ZDS cloud.
1. Confirm Device Compatibility with ZDS
- ZDS is compatible with all Zebra devices running Android 4.4 (Kit Kat) and later.
- Zebra offers active ZDS support for devices running Android 6.x (Marshmallow) and later.
- ZDS comes preinstalled on most devices with the latest Android 7.x (and later) builds.
- Installation might be required for devices running Android 4.4, Android 5.x (Lollipop), and later Android versions.
2. Confirm ZDS Agent is Installed
The current ZDS agent is implemented as two applications installed on the device:
- com.symbol.dataanalytics.apk | Main analytics engine (2 MB)
- com.symbol.dataanalytics.dca.apk | Data collection plug-in (0.2 MB)
There are two ways to check if ZDS is installed on devices:
- If a customer has an MDM with enrolled devices, they can check if the following package names appear for their devices on the MDM console:
- com.symbol.dataanalytics.apk
- com.symbol.dataanalytics.dca.apk
If the package names do not appear, the customer should contact the VIQF portal support team (email: mscustomeronboarding@zebra.com) to request service for guidance on installing the ZDS agent from the ZDS team.
- A customer can also check ZDS status on the device if they have access to their devices by following the procedure below:
- In the Settings panel, locate and tap the "Apps" button. This displays a list of all apps and services on the device.
- Scroll the list until the ZDS components are shown.
- Tap on a service to view its status and options. For example, tapping "Zebra Data Service" shows:
- Version: 7.0.0.1005
- Storage: 8.79 MB used in Internal storage
- Data usage: 6.62 MB used since Nov 7, 2019
- Permissions: Storage
- Notifications: Storage
- Open by default: No defaults set
- Battery: 0% use since last full charge
- Memory: 14 MB avg memory used in last 3 hours
- Store: App details (App installed from Proxy Framework)
- To exit the panel, tap the left-facing arrow.
3. Confirm ZDS Agent is Enabled
As mentioned in step 2, customers have two ways to verify if the ZDS agent is enabled or not:
- If a customer has an MDM with enrolled devices, they can check if the following package names show up for their devices on the MDM console:
- com.symbol.dataanalytics.apk
- com.symbol.dataanalytics.dca.apk
If both apps show up, it indicates that both applications of the ZDS agent are enabled.
- Customers can also check if the ZDS agent is enabled on the device when they have access to their devices by following the procedure below:
- Check if the ZDS main analytics engine is enabled. In the Settings panel, locate and tap the "Zebra" button. This brings up the ZDS info screen:
Device Data
Help Zebra improve its products and services by sending machine data related to device usage. Required for Zebra Mobility DNA and Visibility Services. About machine data.
Location Data: Toggle On/Off Read the EULA
An Administrator has configured this device to collect location data, as part of device data, from the following sources:
- GPS (Off)
- Bluetooth (Off)
- Wi-Fi (Off)
If the toggle switch is "on", it indicates the main analytics engine is enabled.
If the toggle switch is "off", the user can switch it to "on" to enable the main analytics engine.
- Check if the ZDS data collection plug-in is enabled:
- In the Settings panel, locate and tap the "Apps" button. This displays a list of all apps and services on the device.
- Click on "Zebra Data Service Plug-in" and check if it is enabled or disabled.
If either application is not running, the customer can use a barcode or XML to ensure ZDS apps are running and enabled. Please follow the procedure described in the document: ZDS Agent Configuration Guide.
- Check if the ZDS main analytics engine is enabled. In the Settings panel, locate and tap the "Zebra" button. This brings up the ZDS info screen:
4. Confirm Devices are Connected to Internet
Verify if the devices can reach the Internet via Wi-Fi connection or Cellular connection. Devices need to connect to the Internet to transmit data to the VisibilityIQ platform.
5. Modify Firewall Settings if Needed
In scenarios where customers restrict their devices from directly connecting to the Internet, they need to modify their firewall settings to allow devices to reach the ZDS cloud server so data can be transmitted to the VisibilityIQ platform.
The following 2 URLs need to be whitelisted in the firewall settings to allow devices to send data to the ZDS cloud server:
- ZDS Server 1:
URL: https://analytics.zebra.com
Port: 443 - ZDS Server 2:
URL: https://device-https.savannacore.zebra.com
Port: 443
For more detailed information regarding the ZDS agent, please follow the link below: ZDS About.