Deploying Zebra Services Agent

Zebra Services Agent for SOTI MobiControl Installation Guide V4.x

Install the ZSA app on the devices.

Download the

Zebra_Services_Agent_V4.0.0.0.apk

file from zebra.com/zebra-services-agent.

Log into

Soti Mobicontrol Web Console

Select

and scroll down to

Configuration

section.

In the

Configuration

section, navigate to

Policies

and then choose

Apps

Select

New App Policy

from the top-right corner. After you make the selection, a

Create App Policy

dialog box displays.

Go to

Android option

Android Enterprise

General

tab, provide App Policy Name
.

Go to

Apps

tab, click on

Add new app

Select

Enterprise apps

App Source

and click

Click

+ Upload new apk

and select

Import

under the

Source

field.

Click

Browse File

to upload the

APK

file.

Click

It will redirect to

Configuration

step.

Go to

Installation Options

and enable

Launch App After Installation

Go to

Managed App Config

, enable the

Enable Managed App Config

option and

Import

The configuration app list display.

Under the

System Configuration

section, enable the Enable/Disable of ZSA
option and set the Configuration of the log level for ZSA
with the following values:

0: Info

1: Debug

2: Sensitive

Enable

Start Collecting a logs in file

to capture ZSA logs.

The system settings include three features for uploading log files:

File upload URL

: Specifies the server path for uploading log files.

File upload retry count

: Defines the number of retry attempts if the upload fails.

File upload retry interval in minutes

: Sets the duration (in minutes) between each retry attempt after a failed upload.

Settings for managing data uploads on non-Zebra devices:

Data Upload URL

: Specifies the server path for uploading data collection details.

Data Upload Interval in minutes

: Sets the frequency of uploads, defaulting to 24 hours (1440 minutes).

Data collection settings for non-Zebra devices:

Enable/Disable of data collection

: Data collection is turned off by default. When enabled, it gathers information on default enabled data collections, which can be uploaded to the server specified in the

Data upload URL

. Admin can modify the data collection that is default disabled.

Allow user to toggle data collection

: Enabled by default, allowing users to change the status of data collection via the app. Administrators can disable this option to restrict user access.

For the

Account No

, users must enter their MDM account number for non-Zebra devices (Optional).

Go to

PBR Configuration

, turn on

Enable/Disable PBR Configuration

, and provide a

Custom Message

as required.

Set the

In case of bad battery alert the user through a notification or dialog box

with the following values:

Notification (default)

Dialog

Dialogue with Assist

The

Block device usage

option is disabled by default. If enabled by the administrator, it prevents device access when a bad battery is detected.

Go to

Drop Detection

, toggle the

Enable/Disable of drop detection

option as required.

Set the

Drop sensitivity level

with the following values:

High

Medium (default)

Low

Custom - in case of custom, specify the sensitivity number in

Drop sensitivity

Set the

In case of device drop alert the user through a notification or dialog box

with the following values:

Notification (default)

Dialog

Dialogue with Assist

The

Allow user to toggle drop collection

is enabled by default. Users can control this feature, and admins can disable it to restrict access for users.

Navigate to the

Data Collection

section. The settings for data collection on non-Zebra devices are as follows:

Default enabled data collections:

Battery

Device Info

Application List and Events

Application Usage

Battery Events

Bluetooth Events

RAM Stats

Flash Stats

Utilization

WWAN Information

Admin can change below data collections:

WLAN Info

: Select

Enable/Disable of WLAN info collection

and add value in

Interval of WLAN info data collection in minutes

Low RAM

: Select

Enable/Disable of Low RAM collection

GPS Location

: Track device with turning on

Enable/Disable of GPS Location data collection

and add values in

Interval of GPS data collection in minutes

Geofence

: Get notified when the device leaves the predefined fencing area by selecting

Enable Geofence

and add

Location details

Geofence Name

: Name of the area

Latitude-Longitude

: Lat-long of the specific area

Radius (meter)

: Radius area to cover around specified lat-long

Data is uploaded based on the configured

Data Upload URL

and interval settings in the

System Configuration

Under the

DDT Configuration

Enable the

Enable/Disable DDT

option.

Keep the

Clear DDT configurations

option disabled in the primary setup.

One-time tests

: Set the

Schedule test on specific date

in DD-MM-YYYY format if required to schedule one-time tests.

Repetitive tests

: For repetitive tests, specify days using the format MON,TUE,WED in the

Schedule tests on specific days

section.

Schedule tests on specific time

, enter the test time in HH:MM 24-hour format for executing one-time or periodic tests.

Click

Add

in the Test Plan
section.

Under the

Schedule

section, configure the test plan with the following values:

Test Day

: Day of the Week (For example, Monday)

Test Time

: Time of the day for the test (HH: MM format)

Select

Bluetooth

as the

System to Test

option.

Under the

Delivery

section, select the

Protocol

FTP

, enter a valid

IP Address

User Name

, and

Password

, then click

Save

Select the

Test-log Retention

as required.

Select the

Upload Preference

as required.

Under the

Application Configuration

section, there are two options,

Wireless Insight

and

ZDS

, which are designated for Zebra devices only. More applications will be supported in the future.

Wireless Insight

: Configured using Managed Configuration through MDM or VIQ.

Configuration ID

: Pre-defined ID specific to the Wireless Insight configuration that includes several options.

Custom Configuration

: Add the custom Wireless Insight configuration as a value.

ZDS

: Configured through VIQ with a custom ZDS configuration.

Go to the

Advance Troubleshooting

option and enable the following settings.

Frequent Device Drops

Frequent Wi-Fi Disconnections

Frequent Bluetooth Disconnections

Frequent Device Reboots

Click on

Save

From the left panel of

Configuration Options

, select

App Permissions

Select

Allow

from the drop-down of

Default Permission Policy

Click on

+ Add

and select all permissions one by one from the

Permission

drop-down.

Select

Save

From the left panel, go to

Scripts

Manage Scripts

Select

Create New Script

and add the script below in the

Script Editor

sendintent -b

"intent:#Intent;action=com.zebra.zsa.action.FETCH_DEVICE_IDENTIFIERS; S.serialNumber=%SERIALNUM%; component=com.zebra.zsa/com.zebra.utility.deviceIdentifier.SOTIReceiver; end;"