Deploying Zebra Services Agent

Deploying Zebra Services Agent

Install the ZSA app on the devices.
Download the
Zebra_Services_Agent_V5.0.0.x.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
    .
  4. Select
    New App Policy
    from the top-right corner. After you make the selection, a
    Create App Policy
    dialog box displays.
    New App Policy
  5. Go to
    Android option
    Android Enterprise
    .
    General
  6. In
    General
    tab, provide
    App Policy Name
    .
    App Policy Name
  7. Go to
    Apps
    tab, click on
    Add new app
    .
    Add new app
  8. Select
    Enterprise apps
    as
    App Source
    and click
    Next
    .
    Enterprise apps
  9. Click
    + Upload new apk
    and select
    Import
    under the
    Source
    field.
  10. Click
    Browse File
    to upload the
    APK
    file.
    Upload APK File
  11. Click
    Next
    .
    It will redirect to
    Configuration
    step.
    App Details Configuration
    1. Go to
      Installation Options
      and enable
      Launch App After Installation
      .
      Installation Option Configuration
    2. Go to
      Managed App Config
      , enable the
      Enable Managed App Config
      option and
      Import
      .
      Enable Managed App Config
      Import Managed App Config
      The configuration app list display.
      System Configuration App List
    3. 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
    4. Enable
      Start Collecting a logs in file
      to capture ZSA logs.
      Start Collecting a logs in file
    5. 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.
    6. 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 upload configuration
    7. 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.
    8. Mandatory setup for non-Zebra devices:
      To view data on the VisibilityIQ portal, you must enter the
      Account ID
      provided by your Zebra onboarding team during the
      ZSA installation
      .
      This step is mandatory for all non-Zebra devices to enable data visibility.
      Account No
    9. Go to
      PBR Configuration
      , turn on
      Enable/Disable PBR Configuration
      , and provide a
      Custom Message
      as required.
      PBR Configuration
    10. Set the
      In case of bad battery alert the user through a notification or dialog box
      with the following values:
      • Notification
      • Alert Dialog (default)
      • Alert Dialogue with Assist
    11. The
      Block device usage
      option is disabled by default. If enabled by the administrator, it prevents device access when a bad battery is detected.
    12. Go to
      Drop Detection
      , toggle the
      Enable/Disable of drop detection
      option as required.
    13. Set the
      Drop sensitivity level
      with the following values:
      • High
      • Medium (default)
      • Low
      Drop Sensitivity
    14. Set the
      In case of device drop alert the user through a notification or dialog box
      with the following values:
      • Notification (default)
      • Alert Dialog
      • Alert Dialogue with Assist
    15. 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.
    16. The
      Collect location data with drop
      allows capturing location (latitude-longitude) data of the device when the device drops.
    17. 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
        • Screen Brightness
        • WLAN Stats
        • Device Usage
        • Feature Usage
        • Doze Mode
        • Scanner Info
        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
        .
        WLAN and Low RAM
      • 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
        .
        GPS Location
      • 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
        Geofence Name
        Geofence Details
      • Storage Stats
        : Enable the
        Enable/Disable of Storage Stats
        option and add a value in the
        Interval of Storage Stats data collection in minutes
        .
        • Storage Stats Parameters
          : Configure the package names for monitoring.
      • WLAN Events
        : Enabled by default and cannot be disabled. The admin can adjust the threshold value (in minutes).
        • WLAN
          event data is collected based on the configured threshold value.
          WLAN Events
      • Network Stats
        : Enabled by default and cannot be disabled. The admin can adjust the top no of app counts.
      • Network Latency
        : Disabled by default, if enabled, it records network performance details for configured host URLs, including the target host, measured latency, network type, signal strength, connection information, and request result stats as an error message.
        Network Latency
      Data is uploaded based on the configured
      Data Upload URL
      and interval settings in the
      System Configuration
      .
    18. 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.
      • In
        Schedule tests on specific time
        , enter the test time in HH:MM 24-hour format for executing one-time or periodic tests.
      • Run test when device is connected to charge
        : Disable by default, when enabled, the scheduled test runs only when the device is connected to charge.
      • Click
        Add
        in the
        Test Plan
        section.
      DDT Configuration
    19. 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)
      Test Plan Values
    20. Select
      Bluetooth
      as the
      System to Test
      option.
    21. Under the
      Delivery
      section, select the
      Protocol
      as
      FTP
      , enter a valid
      IP Address
      ,
      User Name
      , and
      Password
      , then click
      Save
      .
    22. Select the
      Test-log Retention
      as required.
      Test-log Retention
    23. Select the
      Upload Preference
      as required.
      Upload Preference
    24. 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.
          Configuration ID for Wireless Insight
        • Custom Configuration
          : Add the custom Wireless Insight configuration as a value.
      • ZDS
        : Configured through VIQ with a custom ZDS configuration.
    25. Go to the
      Proactive Device Monitoring
      option and enable the following settings.
      • Frequent Wi-Fi Disconnections
        Enable the
        Enable/Disable Frequent Wi-Fi Disconnections
        and set the
        In case of Frequent Wi-Fi disconnection, alert the user through a notification or dialog box
        with the following options:
        • Notification
        • Dialog (Default)
      • Frequent Bluetooth Disconnections
        Enable the
        Enable/Disable Frequent Bluetooth Disconnections
        and set the
        In case of Frequent Bluetooth disconnection, alert the user through a notification or dialog box
        with the following options:
        • Notification
        • Dialog (Default)
        Bluetooth or Wi-Fi Disconnection
      • Frequent Device Reboots
        Enable the
        Enable/Disable Frequent Device Reboot
        and set the
        In case of Frequent device reboot, alert the user through a notification or dialog box
        with the following options:
        • Notification
        • Dialog (Default)
      • Alert on Severe Drop Detection
        Disabled by default. When enabled by an administrator, it allows the device to receive commands from ZDS upon detecting a severe drop.
      • Alert on Device Overheat
        Disabled by default. When enabled by an administrator, it allows the device to receive commands from ZDS upon detecting an overheat event.
      • Alert on Device Over cold
        Disabled by default. When enabled by an administrator, it allows the device to receive commands from ZDS upon detecting an under-temperature or overcooling event.
        Advance Troubleshooting
    26. Click on
      Save
      .
    27. From the left panel of
      Configuration Options
      , select
      App Permissions
      .
      • Select
        Allow
        from the drop-down of
        Default Permission Policy
        .
        App Permissions
      • Click on
        + Add
        and select all permissions one by one from the
        Permission
        drop-down.
        Add Permissions
        Save Permissions
      • Select
        Save
        .
    28. From the left panel, go to
      Scripts
      Manage Scripts
      .
      Scripts
    29. Select
      Create New Script
      and add the script below in the
      Script Editor
      .
      sendintent -b "intent:#Intent;action=com.zebra.servicesagent.action.FETCH_DEVICE_IDENTIFIERS; S.serialNumber=%SERIALNUM%; component=com.zebra.servicesagent/com.zebra.utility.deviceIdentifier.SOTIReceiver; end;"
      Create New Script
    30. Click on
      Save Script
      and add
      Script name - ZSA Serial Number
      and click
      Save
      .
      Save Script Name
    31. Select
      ZSA Access Serial Number
      script from
      Execute Saved Script
      drop down and click
      Save
      .
      Execute Saved Script
      • The
        Zebra Services Agent
        app is added. Click
        Save and Assign
        .
        ZSA Save and Assign
    32. Assign
      to a group device or a single device.
      Assign ZSA to a device
      The application is now installed on the device.
      ZSA app Homescreen