Zebra Services Agent for SOTI MobiControl Installation Guide

Overview

SOTI MobiControl is an Enterprise Mobility Management (EMM) solution that enables companies to securely manage devices and endpoints with any form factor and operating system throughout their lifecycle, from deployment to retirement. The Zebra Services Agent (ZSA) and Zebra Services Battery Health (ZSBH) apps are designed to be installed and configured through EMM tools.

Pre-requisites

All target devices for the app installation must be enrolled in Soti Mobicontrol under one or more Organization Groups. Devices must be enrolled as Work Managed. To verify if devices are configured as Work Managed, select Group > Device name > Device Details > Android Enterprise > Management Type. 'Work Managed Device' (1) displays.

[Visual Description: A screenshot of the SOTI MobiControl interface showing device details. Under 'Android Enterprise', the 'Management Type' is clearly labeled as 'Work Managed Device' with a numerical indicator (1).]

Deploying Zebra Service Battery Health

Install the Zebra Service Battery Health (ZSBH) app on the devices. Download the Zebra_Services_Battery_Health_V1.3.0.0.apk file from zebra.com/zebra-services-agent.

1. Log into Soti Mobicontrol Web Console.
2. Select Menu and scroll down to the Configuration section.
3. In the Configuration section, navigate to Policies and then choose Apps (1).
4. Select 'New App Policy' (2) from the top-right corner. After selection, a 'Create App Policy' dialog box displays.

[Visual Description: A screenshot of the SOTI MobiControl interface showing the 'Policies' section. A button labeled 'NEW APP POLICY' (2) is visible in the top right corner.]

Go to Android option > Android Enterprise.

On the General tab, fill in the details. The 'App Policy Name' is mandatory.

[Visual Description: A screenshot of the 'CREATE APP POLICY' dialog box, General tab. Fields include 'App Policy Name', 'Description', 'Policy Status', 'Family', and 'Type'. The 'App Policy Name' is pre-filled with 'Zebra Services Agent Policy'.]

7. Select Apps.
8. Select 'Add App' ➕ from the top-right corner.

[Visual Description: A screenshot of the 'CREATE APP POLICY' dialog box, Apps tab. A '+' icon labeled 'Add App' is visible in the top right corner.]

Select 'Enterprise' (1) as the App Source.

[Visual Description: A screenshot of the 'SELECT APPS' dialog box. The 'App Source' dropdown is open, showing 'Managed Google Play' and 'Enterprise' as options. 'Enterprise' is highlighted (1).]

Select 'Import' under the Source field.

[Visual Description: A screenshot of the 'SELECT APPS' dialog box showing the 'Source' options: 'Import' and 'Enterprise URL'. 'Import' is selected.]

Click 'Browse File' (1) to upload the APK file.

[Visual Description: A screenshot of the 'SELECT APPS' dialog box, showing the 'Upload APK File' section. A button labeled 'Browse File' (1) is visible.]

After uploading the APK file, scroll down and select 'Configure':

12. Keep the 'App Details' and 'Installation Options' as they are, or modify them as required.
13. To display a store-specific notification message for a faulty battery instead of a generic message, enable 'Managed App Config' (1).

[Visual Description: A screenshot of the 'ADVANCED CONFIGURATIONS' section. The 'Enable Managed App Config' toggle switch is shown, with a numerical indicator (1) pointing to it.]

13. Provide a 'Custom Message' (1) as required.

[Visual Description: A screenshot of the 'ADVANCED CONFIGURATIONS' section, showing the 'Managed App Config' input field. A placeholder text 'YOUR_CUSTOM_MESSAGE_HERE' is visible, with a numerical indicator (1) pointing to it.]

14. Select 'Save' > 'Add'. The Zebra Service Battery Health (1) app is added.
15. Click 'Save and Assign' (2).

[Visual Description: A screenshot of the 'CREATE APP POLICY' dialog box, Apps tab, showing the added 'Zebra Services Battery Health' app. A button labeled 'SAVE AND ASSIGN' (2) is visible.]

Assign (1) to a group device or single device.

[Visual Description: A screenshot of the 'ASSIGN Zebra Services Agent Policy' interface. A device group 'ZEBRA_USA_GROUP' is selected, and a device 'AndroidEnterprise 00310' is checked. A button labeled 'ASSIGN' (1) is visible.]

The application is now installed on the devices.

Deploying Zebra Services Agent

Install the Zebra Services Agent app on the devices. Download the Zebra_Services_Agent_V1.3.0.0.apk file from zebra.com/zebra-services-agent.

1. Log into Soti Mobicontrol via desktop or laptop.
2. Select Menu and scroll down to the Configuration section.
3. In the Configuration section, navigate to Policies and then choose Apps (1).

[Visual Description: A screenshot of the SOTI MobiControl interface showing the 'Policies' section. A button labeled 'NEW APP POLICY' (2) is visible in the top right corner.]

Go to Android option > Android Enterprise.

On the General tab, fill in the details. The 'App Policy Name' is mandatory.

[Visual Description: A screenshot of the 'CREATE APP POLICY' dialog box, General tab. Fields include 'App Policy Name', 'Description', 'Policy Status', 'Family', and 'Type'. The 'App Policy Name' is pre-filled with 'Zebra Services Agent Policy'.]

7. Select Apps.
8. Select 'Add App' ➕ from the top-right corner.

[Visual Description: A screenshot of the 'CREATE APP POLICY' dialog box, Apps tab. A '+' icon labeled 'Add App' is visible in the top right corner.]

Select 'Enterprise' (1) as App Source.

[Visual Description: A screenshot of the 'SELECT APPS' dialog box. The 'App Source' dropdown is open, showing 'Managed Google Play' and 'Enterprise' as options. 'Enterprise' is highlighted (1).]

Select 'Import' under the Source field.

[Visual Description: A screenshot of the 'SELECT APPS' dialog box showing the 'Source' options: 'Import' and 'Enterprise URL'. 'Import' is selected.]

Click 'Browse File' (1) to upload the APK file.

[Visual Description: A screenshot of the 'SELECT APPS' dialog box, showing the 'Upload APK File' section. A button labeled 'Browse File' (1) is visible.]

After uploading the APK file, scroll down and select 'Configure':

12. Keep the 'App Details' and 'Installation Options' as they are, or modify them as required.
13. Keep 'Managed App Config' (1) as disabled.

[Visual Description: A screenshot of the 'ADVANCED CONFIGURATIONS' section. The 'Enable Managed App Config' toggle switch is shown as disabled, with a numerical indicator (1) pointing to it.]

13. Select 'Save' > 'Add'. The Zebra Services Agent app is added.
14. Click 'Save and Assign' (1).

[Visual Description: A screenshot of the 'CREATE APP POLICY' dialog box, Apps tab, showing the added 'Zebra Services Agent' app. A button labeled 'SAVE AND ASSIGN' (1) is visible.]

Assign (1) to a group device or single device.

[Visual Description: A screenshot of the 'ASSIGN Zebra Services Agent Policy' interface. A device group 'ZEBRA_USA_GROUP' is selected, and a device 'AndroidEnterprise 00310' is checked. A button labeled 'ASSIGN' (1) is visible.]

The application is now installed on the devices.

Auto-launching Zebra Services Agent

After deploying the apps, set the app to auto-launch:

1. Select 'Devices' from the menu.
2. Select all devices (1) and click 'Send Script' (2) from the available options below.

[Visual Description: A screenshot of the SOTI MobiControl 'Devices' view. Multiple devices are listed, with checkboxes. A 'Send Script' button (2) is visible in the options bar, and a numerical indicator (1) points to the selected devices.]

3. Select 'Manage Scripts' (1).

[Visual Description: A screenshot of the 'SEND SCRIPT' dialog box. A button labeled 'MANAGE SCRIPTS' (1) is visible.]

4. Select 'Add New Script' (1).

[Visual Description: A screenshot of the 'MANAGE SCRIPTS' interface. A '+' icon labeled 'Add New Script' (1) is visible.]

5. Add the command below to the script (1) and then click 'Save Script' (2).

[Visual Description: A screenshot of the 'Script Editor' within the 'MANAGE SCRIPTS' interface. The script editor contains the command 'start com.zebra.usa'. A button labeled 'SAVE SCRIPT' (2) is visible, and a numerical indicator (1) points to the script editor.]

6. Add a name for the script, and then click 'Save'.

[Visual Description: A 'Create New Script' dialog box appears, with a 'Script Name' field labeled 'ADD_YOUR_SCRIPT_NAME_HERE'. A 'SAVE' button is present.]

7. Save the script and close the portal.

Repeat step 2.

Select 'Legacy' as the script type option.

[Visual Description: A screenshot of the 'SEND SCRIPT' dialog box, showing the 'Script Type' dropdown. 'Legacy' is selected.]

Select your saved script as 'Execute Saved Script' from the drop-down menu as shown below.

[Visual Description: A screenshot of the 'SEND SCRIPT' dialog box, showing the 'Execute Saved Script' dropdown menu. Various script names are listed, including 'Activate Connection', 'AutoLaunch', etc.]

11. Click 'Send Script' to deploy the script to all selected devices. This action launches the Zebra Services Agent application on the targeted group of devices.

Expected Behaviour After Auto-launching Zebra Services Agent

1. Auto-launching the ZSA application on your device. The ZSA home screen displays the appropriate entitlement.
2. If the ZSBH app is entitled, the ZSA app automatically launches it after a few seconds.
3. The ZSBH home screen displays both good and bad battery details, and if a 'bad battery' condition is detected, a notification will display.
4. After a few seconds, the ZSBH app will close, and shortly after, the ZSA app will also close.

[Visual Description: A series of mobile device screenshots showing the Zebra Services Agent interface, a 'Proactive battery replacement' notification, and battery status details. The screens indicate battery replacement is required due to expiration.]

Verifying App Installation and Connection to Zebra Servers

To verify if the app is installed with the correct permissions and is able to connect to Zebra servers:

1. Go to Settings > Apps > All apps and select Zebra Services Agent (1).

[Visual Description: A screenshot of a mobile device's 'App info' screen, listing various installed applications. 'Zebra Services Agent' is highlighted with a numerical indicator (1).]

2. The App Info page displays the Version (1).

[Visual Description: A screenshot of the 'App info' screen for Zebra Services Agent, showing details like 'App notifications', 'Permissions', 'Storage', 'Data usage', 'Battery', 'Open by default', and 'Memory'. The version number '1.0.0.2' is visible (1).]

3. For the ZSA Permissions, go to Settings > Apps > All apps > Zebra Services Agent > Permissions.

[Visual Description: A screenshot of the 'App info' screen for Zebra Services Agent, showing options like 'OPEN', 'UNINSTALL', 'FORCE STOP', 'Notifications', 'Permissions', 'Storage & cache', and 'Screen time'. The 'Permissions' section is indicated.]

4. To verify ZSA Network connectivity to the Zebra URL:
5. Launch ZSA and go to Settings (1) > Refresh (2).

[Visual Description: Two screenshots of a mobile device. The first shows the ZSA main menu with 'Settings' highlighted (1). The second shows the 'Settings' screen with 'Connectivity' details and a 'Refresh' button (2).]

Legal and Proprietary Information

Copyright

2024/08/01

ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners. ©2024 Zebra Technologies Corporation and/or its affiliates. All rights reserved.

Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements.

For further information regarding legal and proprietary statements, please go to:

• SOFTWARE: zebra.com/informationpolicy.
• COPYRIGHTS: zebra.com/copyright.
• PATENTS: ip.zebra.com.
• WARRANTY: zebra.com/warranty.
• END USER LICENSE AGREEMENT: zebra.com/eula.

Terms of Use

Proprietary Statement

This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the express, written permission of Zebra Technologies.

Product Improvements

Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are subject to change without notice.

Liability Disclaimer

Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.

Limitation of Liability

In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever (including, without limitation, consequential damages including loss of business profits, business interruption, or loss of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.