MN-005037-01EN Zebra Services Agent for SOTI Mobi Control Installation Guide
- September 14, 2024
- ZEBRA
Table of Contents
Zebra Services Agent for SOTI MobiControl
Installation Guide
MN-005037-01EN Rev A
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.
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.
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 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 you
make the selection, a Create App Policy dialog box displays.
5. Go to Android option > Android Enterprise.
6. On the General tab, fill in the details. The App Policy Name
is mandatory.
7. Select Apps.
8. Select Add App from the top-right corner.
9. Select Enterprise (1) as the App Source.
10. Select Import under the Source field.
11. Click Browse File (1) to upload the APK file.
12. After uploading the APK file, scroll down, and select
Configure :
a) Keep the App Details and Installation Options as they are, or
modify them as required.
b) To display a store-specific notification message for a faulty battery
instead of a generic message, enable Managed App Config (1).
c) Provide a Custom Message (1) as required.
d) Select Save > Add.
The Zebra Service Battery Health (1) app is added.
13. Click Save and Assign (2).
14. Assign (1) to a group device or single device.
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 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 you
make the selection, a Create App Policy dialog box displays.
5. Go to Android option > Android Enterprise.
6. On the General tab, fill in the details. The App Policy Name
is mandatory.
7. Select Apps.
8. Select Add App from the top-right corner.
9. Select Enterprise (1) as App Source.
10. Select Import under the Source field.
11. Click Browse File (1) to upload the APK file
12. After uploading the APK file, scroll down, and select
Configure :
a) Keep the App Details and Installation Options as they are, or
modify them as required.
b) Keep Managed App Config (1) as disabled.
c) Select Save > Add.
The Zebra Services Agent app is added.
13. Click Save and Assign (1).
14. Assign (1) to a group device or single device.
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.
3. Select Manage Scripts (1).
4. Select Add New Script (1).
5. Add the command below to the script (1) and then click Save Script (2).
6. Add a name for the script, and then click Save.
7. Save the script and close the portal.
8. Repeat step 2.
9. Select Legacy as the script type option.
10. Select your saved script as Execute Saved Script from the drop- down menu as shown below.
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.
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).
2. The App Info page displays the Version (1).
3. For the ZSA Permissions, go to Settings > Apps > All apps
Zebra Services Agent > Permissions.
4. To verify ZSA Network connectivity to the Zebra URL:
- Launch ZSA and go to Settings (1) > Refresh (2).