Wireless Insights Agent

Wireless Insights

Overview

Wireless Insights (WI) Agent captures wireless data from the Wireless Insights service and transmits it to Zebra DNA Cloud for dashboard visualization to help administrators ensure optimal wireless network performance. This guide provides instructions to install and configure the Wireless Insights Agent, tailored to the specific Enterprise Mobility Management (EMM) system in use or using Zebra DNA Cloud for deployment.

Requirements

  • Supported Devices and Operating System: Refer to the Zebra support portal for supported devices, Android versions, and OS versions.
    • Ensure the device is upgraded to the supported OS version. Older OS version software may result in suboptimal feature performance and requires the installation of the Delegation Scope Configuration file. For instructions, see Setup - EMMs Without Auto Options.
  • Mobility DNA (MDNA) Enterprise license: For Zebra Professional-series devices, an MDNA license is required. Without it, the Voice Analysis feature will not operate and will display the message "Feature not running."
  • Wi-Fi VoIP Analysis Support: Supports the SIP-RTP protocol.
    • Using Non-Standard Ports: If the SIP port in use is different than the standard port 5060, configuration steps are required:
      1. Install the Wireless Insights Agent by following the steps outlined in the Setup section of this guide, based on the EMM in use.
      2. Send the intent to stop Voice Analysis.
      3. Send the intent to start Voice Analysis using the updated SIP port.
  • Unsupported Wi-FI VoIP Analysis Protocols and Apps:
    • Protocol: WebRTC
    • VoIP Apps: Zebra Work Cloud Sync, Microsoft Teams, Zoom Phone

Prerequisites

Prerequisites for deploying Wireless Insights:

  • Download Agent: The Wireless Insights .APK is available for download from the Zebra support portal or the Google Play Store.
  • Configure Wi-Fi: Apply the necessary Wi-Fi settings to the device to ensure that Wi-Fi is enabled and the device can connect to the local network.

Limitations

Wireless Insights Agent is not compatible with devices using Android Enterprise Work Profile, previously known as Corporate-Owned, Personally Enabled (COPE) Mode. This mode allows a single device to serve both professional and personal needs by creating separate profiles for work and personal use.

Setup - ZDNA Cloud

This section offers guidance for the installation and configuration of the Wireless Insights Agent using Zebra DNA Cloud.

I. Enable Wireless Insights Service

Activate the Wireless Insights service to allow the agent to collect wireless data. This configuration is required only once. In the Zebra DNA Cloud console, enable Wireless Insights.

After enabling the service, from the My Service screen, copy the Wireless Insights Enrollment Configuration for use in a later step.

II. Install and Configure Agent

Create and apply a policy to install the Wireless Insights Agent and configure it through Managed Configurations.

  1. In the ZDNA Cloud web portal, go to My Apps > Zebra Collection. Locate Wireless Insights, select the version to install, and click Setup. image

  2. Click Next. image

  3. If desired, enter a description. Click Next. image

  4. If desired, edit the App Setup Name. Click Apply Now. image

  5. Select the target device(s). Click Apply. image

  6. Apply Delegation Scope: If the device is not updated to the latest LifeGuard Update (per the Requirements) or if the Wireless Insights Agent screen indicates that the device is unsupported, the Delegation Scope .XML file must be applied. This file authorizes the agent to operate with the Wireless Insights stack on the device. Follow these steps:
         a. Navigate to My Devices from the left menu. Select the target device(s), click Bulk Actions, and then click Submit XML.
    image      b. Enter the .XML content below, then click Submit:

    <wap-provisioningdoc> 
  <characteristic version="11.5" type="AccessMgr"> 
    <parm name="ServiceAccessAction" value="4" /> 
    <parm name="ServiceIdentifier" value="delegation-zebra-wirelessinsight-api-service" /> 
    <parm name="CallerPackageName" value="com.zebra.wirelessinsights.agent" /> 
    <parm name="CallerSignature" value="MIIFhTCCA20CCSMxNhM5AtLvpzANBgkqhkiG9w0BAQsFADB/MQswCQYDVQQGEwJVUzERMA8GA1UECAwITmV3IFlvcmsxEzARBgNVBAcMCkhvbHRzdmlsbGUxIDAeBgNVBAoMF1plYnJhIFRlY2hub2xvZ2llcyBJbmMuMSYwJAYDVQQDDB1BbmRyb2lkIFVucHJpdmlsZWdlZCBLZXkgUm9vdDAeFw0yMzEwMjcxOTM1MTNaFw00ODExMjkxOTM1MTNaMIGJMQswCQYDVQQGEwJVUzELMAkGA1UECAwCTlkxEzARBgNVBAcMCkhvbHRzdmlsbGUxHzAdBgNVBAoMFlplYnJhIFRlY2hub2xvZ2llcyBJbmMxDDAKBgNVBAsMA0VNQzEpMCcGA1UEAwwgY29tLnplYnJhLndpcmVsZXNzaW5zaWdodHMuYWdlbnQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDX9Ae0Q0gd/rvdq2AYyHwcehsFyuU/x7L5IWhb4deD8O0NN6Tf0pj7ckrAfAylJCgNB8Uq+//f6VUTGQIcuFdinZLgQu5CQfqhD4Znt1lxs7eaXLOu5sVSJBZPdW0p9rl7ti+sqS9zDXa/NAOQjXaBIXQ7PJRJpUSOmSKDlN0ciPioB32ayr5v8aR6oMRQdrYW9AhS2UfYiCt0nWSY05poWvvKHzq4LKq6Agy817EZklOSn18buIo8ujGMxT/O2++XNAOfuRKQmv8+R8GVDCMkh1e1Lb8tHxh9+011AdG93EqxCm/4D6Sz69PGTbSlY1Bn0/H46uulamY8DzeChArsKJVQyxzqAl7h838ZuMPXbkCT+z1XONue5rpOluM6nBJe00Z+97YT0SlaNvJG/g7r/YQddLB/VBQwh8NPIeHufO/gEhukkVzvq49ieU/NZj7CHjz+UXcmnDgGz6hhvfqOVsYmjEAzE8LRmOuelClm8jc7RnmF2g8Q+iApwuy5PA75xjAibeUbEqP6aCJy9XkyVt7JujzZd7G+KH4BVSKoj/it51X3N4JvXwCKe9Fpn8SPFcKOUuCehYFGO4+9DvAGbjbCwx9Q4G8iNpbSMoNd5CsHQFHzc6XsV/dh8Y7KzdcuEm0pahRdVYEBsTrMRl3dwxU28eRQnDMA6OH2bEql0QIDAQABMA0GCSqGSIb3DQEBCwUAA4ICAQBiop746XWulTB7kRBTQL34VvMUUTmrI5sw5wFC2WShu2T63+x0HNfDkW2gNhHcBUN5PW4QIY72CZ01ZA4lHII3Cx5OV0D3nCqsI7kf1JcJdKca3lMQhpjR+RNaPkl6cGwb2ySSMsu74qkFFHt338+NZCvxu/NkErV1M1K2cHJTdXaCvLuHTcSYRbR34dvfL7K0y340NCbIRRZOPWqhble84YBQ8SSSBWNTsR/VyXE/oXuuBIos4kX33DR+s5jEJB44qEWZrzhzPWScwkiPKqVcAaIimpcH1swO9xVbXZF6u9cWVB5iepC0J0gnbKrU4zIRqXNQs9TgYuNxwCNj/dvPzZNVITf33gzO2ePaycvV04cwJLc8bAexpEJJ8nvec9L3ewbunHfywVxT8wUqiXWLWaTjXASvkYxQGsRjFqWwGhgDar37+QYTUN4J7bgrYg/sKDdbdJyIr1tbdKepvh47QJ1aCFj77T1yWxdIu5cukfu6xgGCTK53UTxVdEz5s9ci3Ji/aQJQLH4ceQjV09gcmOj1IQ1QcKtwJBYaOg7yajJl4qo3THYeOJz6ae9okN6C2ECMFESj+f6txgImXZunzT6twiPYLweN+llJVRPZ09Z3FNgNcYWINzuYTn+YZxfgyQA4F9pEaCVA0HcGLUNyHvfRD3F/JXzx9TcD7ztWgA==" /> 
  </characteristic> 
</wap-provisioningdoc>

    image

III. Apply License

Follow these steps to apply Wireless Insight licenses:

  1. Follow steps to Generate a License XML.
  2. In the ZDNA Cloud web console, go to My Devices in the left menu and choose one of the following actions:
         • Locate the target device from the list, click the options menu at the end of the row, and select Submit XML.
         • For multiple devices(s), select the target device(s), click Bulk Actions, and then click Submit XML.
    image
  3. Paste the License .XML file content from step 1, then click Submit. image

IV. Check Agent Connection

To verify the successful deployment and operation of the Wireless Insights Agent, follow these steps to check its connection status on both the device and within the ZDNA Cloud platform.

Device

Ensure that the Wireless Insights Agent is connected to the ZDNA Cloud server by checking the following statuses in the Wireless Insights Agent:

  • Feature Running: Voice is Running

  • ZDNA Connection (under External Connections):

    • Connected - Indicates the Wireless Insights Agent is successfully deployed
    • Activated - Indicates the Wireless Insights license is applied

    image

ZDNA Cloud

In the ZDNA Cloud web console, go to Support Tools > Wireless Insights from the left menu. Verify that the device status, whether in its assigned group or unassigned group, shows "Active." This confirms successful enrollment.

image

Setup - SOTI MobiControl

This section offers guidance for installing and configuring the Wireless Insights Agent with SOTI MobiControl.

If your EMM version does not support Managed Configurations or auto options, or if the devices are operating on an older OS version, refer to the Setup - EMMs Without Auto Options guide.

Screen Variations Note: The screen UI may vary depending on the EMM version in use. Refer to your EMM user guide for additional guidance.

I. Enable Wireless Insights Service

Activate the Wireless Insights service to allow the agent to collect wireless data. This configuration is required only once. In the Zebra DNA Cloud console, enable Wireless Insights.

After enabling the service, from the My Service screen, copy the Wireless Insights Enrollment Configuration for use in a later step.

II. Install and Configure Agent

Create and apply a policy to install the Wireless Insights Agent and configure it through Managed Configurations.

  1. In the SOTI MobiControl web console, go to APPS > ADD APP > Android > Android Enterprise. image
  2. Enter a name for the app policy, then click the APPS tab. image
  3. Click +. image
  4. For the App Source dropdown, select Enterprise. image
  5. By default, Import is selected for the Source. Click Browse File and select the Wireless Insights .APK file. image
  6. After the file is uploaded, click Configure. image
  7. Click Installation Options. Deployment Type is set to Mandatory by default. Toggle to enable Launch App After Installation and click Managed App Config. image
  8. Toggle on Enable Managed App Config. For WI API Request, paste the Wireless Insights Enrollment Configuration copied from ZDNA Cloud in step I. Click Save. image
  9. Click Add. image
  10. The policy is created. Click Save and Assign. image
  11. Search for the enrolled device and select it. Click Assign. image

The Wireless Insights Agent is installed to all devices in the group and the Managed Configuration is applied to enroll the device to the ZDNA Cloud.

III. Apply License

To activate the Wireless Insights license in production environments (not required for trials), use one of the following methods:

  • StageNow - Use StageNow to generate a barcode or XML that activates the license through the Cloud License Server (CLS). The XML can be deployed to devices through your EMM. For instructions, see Generate License XML.
  • OemConfig with EMM - Use Zebra OEMConfig to obtain the license from CLS and deploy it to devices using your EMM. For instructions, see Activate CLS License via OEMConfig.

IV. Check Agent Connection

To verify the successful deployment and operation of the Wireless Insights Agent, follow these steps to check its connection status on both the device and within the ZDNA Cloud platform.

Device

Ensure that the Wireless Insights Agent is connected to the ZDNA Cloud server by checking the following statuses in the Wireless Insights Agent:

  • Feature Running: Voice is Running

  • ZDNA Connection (under External Connections):

    • Connected - Indicates the Wireless Insights Agent is successfully deployed
    • Activated - Indicates the Wireless Insights license is applied

    image

ZDNA Cloud

In the ZDNA Cloud web console, go to Support Tools > Wireless Insights from the left menu. Verify that the device status, whether in its assigned group or unassigned group, shows "Active." This confirms successful enrollment.

image

Setup - Workspace ONE UEM

This section offers guidance for installing and configuring the Wireless Insights Agent with Workspace ONE Unified Endpoint Management (UEM), formerly known as AirWatch.

If your EMM version does not support Managed Configurations or auto options, or if the devices are operating on an older OS version, refer to the Setup - EMMs Without Auto Options guide.

Screen Variations Note: The screen UI may vary depending on the EMM version in use. Refer to your EMM user guide for additional guidance.

I. Enable Wireless Insights Service

Activate the Wireless Insights service to allow the agent to collect wireless data. This configuration is required only once. In the Zebra DNA Cloud console, enable Wireless Insights.

After enabling the service, from the My Service screen, copy the Wireless Insights Enrollment Configuration for use in a later step.

II. Install and Configure Agent

Create and apply a policy to install the Wireless Insights Agent and configure it through Managed Configurations.

  1. In the Workspace ONE UEM web console, go to Resources > Native. Click Internal, then Add, and select Application File. image
  2. Click Upload. image
  3. Click Choose File. Select the Device Guardian .APK file to upload, then click Save. image
  4. The Application File is populated with the file name. Click Continue. image
  5. Enter the application name and version. Click Save and Assign. image
  6. In the Assignment screen, enter or select the following under Distribution:
    • Name: [Enter an assignment name]
    • Assignment Groups: [Enter group to assign the app]
    • App Delivery Method: Auto image
  7. Click Application Configuration. Enable Managed Access and Send Configuration. For WI API Request, paste the Wireless Insights Enrollment Configuration copied from ZDNA Cloud in step I. Click Save. image

III. Apply License

To activate the Wireless Insights license in production environments (not required for trials), use one of the following methods:

  • StageNow - Use StageNow to generate a barcode or XML that activates the license through the Cloud License Server (CLS). The XML can be deployed to devices through your EMM. For instructions, see Generate License XML.
  • OemConfig with EMM - Use Zebra OEMConfig to obtain the license from CLS and deploy it to devices using your EMM. For instructions, see Activate CLS License via OEMConfig.

IV. Check Agent Connection

To verify the successful deployment and operation of the Wireless Insights Agent, follow these steps to check its connection status on both the device and within the ZDNA Cloud platform.

Device

Ensure that the Wireless Insights Agent is connected to the ZDNA Cloud server by checking the following statuses in the Wireless Insights Agent:

  • Feature Running: Voice is Running

  • ZDNA Connection (under External Connections):

    • Connected - Indicates the Wireless Insights Agent is successfully deployed
    • Activated - Indicates the Wireless Insights license is applied

    image

ZDNA Cloud

In the ZDNA Cloud web console, go to Support Tools > Wireless Insights from the left menu. Verify that the device status, whether in its assigned group or unassigned group, shows "Active." This confirms successful enrollment.

image

Setup - EMMs Without Auto Options

Typically, EMMs offer Auto App Launch, Auto Grant Permissions, and Managed Configurations. If your EMM does not support these features or if the device is running an older OS version, follow this guide to install and configure Wireless Insights Agent.

I. Enable Wireless Insights Service

Activate the Wireless Insights service to allow the agent to collect wireless data. This configuration is required only once. In the Zebra DNA Cloud console, enable Wireless Insights.

After enabling the service, from the My Service screen, copy the Wireless Insights Enrollment Configuration for use in a later step.

II. (Optional) Deploy Delegation Scope XML

If the device has not been updated to the latest OS version (as specified in the Requirements), the Delegation Scope .XML file to authorize the agent to operate with the Wireless Insights stack must be applied on the device. Make sure the MXMF App is installed on the device prior to pushing .XML file. Create the .XML file with the XML content shown below and push it to the device(s). For instructions, see the guide to Deploy XML via EMM.

    <wap-provisioningdoc>
    <characteristic version="13.1" type="AccessMgr">
        <parm name="ServiceAccessAction" value="4" />
        <parm name="ServiceIdentifier" value="delegation-zebra-wirelessinsight-api-service" />
        <parm name="CallerPackageName" value="com.zebra.wirelessinsights.agent" />
        <parm name="CallerSignature" value="MIIFhTCCA20CCSMxNhM5AtLvpzANBgkqhkiG9w0BAQsFADB/MQswCQYDVQQGEwJVUzERMA8GA1UECAwITmV3IFlvcmsxEzARBgNVBAcMCkhvbHRzdmlsbGUxIDAeBgNVBAoMF1plYnJhIFRlY2hub2xvZ2llcyBJbmMuMSYwJAYDVQQDDB1BbmRyb2lkIFVucHJpdmlsZWdlZCBLZXkgUm9vdDAeFw0yMzEwMjcxOTM1MTNaFw00ODExMjkxOTM1MTNaMIGJMQswCQYDVQQGEwJVUzELMAkGA1UECAwCTlkxEzARBgNVBAcMCkhvbHRzdmlsbGUxHzAdBgNVBAoMFlplYnJhIFRlY2hub2xvZ2llcyBJbmMxDDAKBgNVBAsMA0VNQzEpMCcGA1UEAwwgY29tLnplYnJhLndpcmVsZXNzaW5zaWdodHMuYWdlbnQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDX9Ae0Q0gd/rvdq2AYyHwcehsFyuU/x7L5IWhb4deD8O0NN6Tf0pj7ckrAfAylJCgNB8Uq+//f6VUTGQIcuFdinZLgQu5CQfqhD4Znt1lxs7eaXLOu5sVSJBZPdW0p9rl7ti+sqS9zDXa/NAOQjXaBIXQ7PJRJpUSOmSKDlN0ciPioB32ayr5v8aR6oMRQdrYW9AhS2UfYiCt0nWSY05poWvvKHzq4LKq6Agy817EZklOSn18buIo8ujGMxT/O2++XNAOfuRKQmv8+R8GVDCMkh1e1Lb8tHxh9+011AdG93EqxCm/4D6Sz69PGTbSlY1Bn0/H46uulamY8DzeChArsKJVQyxzqAl7h838ZuMPXbkCT+z1XONue5rpOluM6nBJe00Z+97YT0SlaNvJG/g7r/YQddLB/VBQwh8NPIeHufO/gEhukkVzvq49ieU/NZj7CHjz+UXcmnDgGz6hhvfqOVsYmjEAzE8LRmOuelClm8jc7RnmF2g8Q+iApwuy5PA75xjAibeUbEqP6aCJy9XkyVt7JujzZd7G+KH4BVSKoj/it51X3N4JvXwCKe9Fpn8SPFcKOUuCehYFGO4+9DvAGbjbCwx9Q4G8iNpbSMoNd5CsHQFHzc6XsV/dh8Y7KzdcuEm0pahRdVYEBsTrMRl3dwxU28eRQnDMA6OH2bEql0QIDAQABMA0GCSqGSIb3DQEBCwUAA4ICAQBiop746XWulTB7kRBTQL34VvMUUTmrI5sw5wFC2WShu2T63+x0HNfDkW2gNhHcBUN5PW4QIY72CZ01ZA4lHII3Cx5OV0D3nCqsI7kf1JcJdKca3lMQhpjR+RNaPkl6cGwb2ySSMsu74qkFFHt338+NZCvxu/NkErV1M1K2cHJTdXaCvLuHTcSYRbR34dvfL7K0y340NCbIRRZOPWqhble84YBQ8SSSBWNTsR/VyXE/oXuuBIos4kX33DR+s5jEJB44qEWZrzhzPWScwkiPKqVcAaIimpcH1swO9xVbXZF6u9cWVB5iepC0J0gnbKrU4zIRqXNQs9TgYuNxwCNj/dvPzZNVITf33gzO2ePaycvV04cwJLc8bAexpEJJ8nvec9L3ewbunHfywVxT8wUqiXWLWaTjXASvkYxQGsRjFqWwGhgDar37+QYTUN4J7bgrYg/sKDdbdJyIr1tbdKepvh47QJ1aCFj77T1yWxdIu5cukfu6xgGCTK53UTxVdEz5s9ci3Ji/aQJQLH4ceQjV09gcmOj1IQ1QcKtwJBYaOg7yajJl4qo3THYeOJz6ae9okN6C2ECMFESj+f6txgImXZunzT6twiPYLweN+llJVRPZ09Z3FNgNcYWINzuYTn+YZxfgyQA4F9pEaCVA0HcGLUNyHvfRD3F/JXzx9TcD7ztWgA==" />
    </characteristic>
    </wap-provisioningdoc>

III. Install and Configure Agent

Create and apply a policy to install the Wireless Insights Agent. Use one of the following guides:

IV. (Optional) Deploy Permissions and Launch XML

If Auto App Launch or Auto Grant Permissions is not available in your EMM, push the .XML containing the content shown below to launch the Wireless Insights Agent and grant the appropriate permissions. For instructions, see the guide to Deploy XML via EMM.

    <wap-provisioningdoc>
    <characteristic version="13.1" type="AccessMgr">
        <parm name="PermissionAccessAction" value="1" />
        <parm name="PermissionAccessPermissionName" value="ALL_DANGEROUS_PERMISSIONS" />
        <parm name="PermissionAccessPackageName" value="com.zebra.wirelessinsights.agent" />
        <parm name="PermissionAccessSignature" value="MIIFhTCCA20CCSMxNhM5AtLvpzANBgkqhkiG9w0BAQsFADB/MQswCQYDVQQGEwJVUzERMA8GA1UECAwITmV3IFlvcmsxEzARBgNVBAcMCkhvbHRzdmlsbGUxIDAeBgNVBAoMF1plYnJhIFRlY2hub2xvZ2llcyBJbmMuMSYwJAYDVQQDDB1BbmRyb2lkIFVucHJpdmlsZWdlZCBLZXkgUm9vdDAeFw0yMzEwMjcxOTM1MTNaFw00ODExMjkxOTM1MTNaMIGJMQswCQYDVQQGEwJVUzELMAkGA1UECAwCTlkxEzARBgNVBAcMCkhvbHRzdmlsbGUxHzAdBgNVBAoMFlplYnJhIFRlY2hub2xvZ2llcyBJbmMxDDAKBgNVBAsMA0VNQzEpMCcGA1UEAwwgY29tLnplYnJhLndpcmVsZXNzaW5zaWdodHMuYWdlbnQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDX9Ae0Q0gd/rvdq2AYyHwcehsFyuU/x7L5IWhb4deD8O0NN6Tf0pj7ckrAfAylJCgNB8Uq+//f6VUTGQIcuFdinZLgQu5CQfqhD4Znt1lxs7eaXLOu5sVSJBZPdW0p9rl7ti+sqS9zDXa/NAOQjXaBIXQ7PJRJpUSOmSKDlN0ciPioB32ayr5v8aR6oMRQdrYW9AhS2UfYiCt0nWSY05poWvvKHzq4LKq6Agy817EZklOSn18buIo8ujGMxT/O2++XNAOfuRKQmv8+R8GVDCMkh1e1Lb8tHxh9+011AdG93EqxCm/4D6Sz69PGTbSlY1Bn0/H46uulamY8DzeChArsKJVQyxzqAl7h838ZuMPXbkCT+z1XONue5rpOluM6nBJe00Z+97YT0SlaNvJG/g7r/YQddLB/VBQwh8NPIeHufO/gEhukkVzvq49ieU/NZj7CHjz+UXcmnDgGz6hhvfqOVsYmjEAzE8LRmOuelClm8jc7RnmF2g8Q+iApwuy5PA75xjAibeUbEqP6aCJy9XkyVt7JujzZd7G+KH4BVSKoj/it51X3N4JvXwCKe9Fpn8SPFcKOUuCehYFGO4+9DvAGbjbCwx9Q4G8iNpbSMoNd5CsHQFHzc6XsV/dh8Y7KzdcuEm0pahRdVYEBsTrMRl3dwxU28eRQnDMA6OH2bEql0QIDAQABMA0GCSqGSIb3DQEBCwUAA4ICAQBiop746XWulTB7kRBTQL34VvMUUTmrI5sw5wFC2WShu2T63+x0HNfDkW2gNhHcBUN5PW4QIY72CZ01ZA4lHII3Cx5OV0D3nCqsI7kf1JcJdKca3lMQhpjR+RNaPkl6cGwb2ySSMsu74qkFFHt338+NZCvxu/NkErV1M1K2cHJTdXaCvLuHTcSYRbR34dvfL7K0y340NCbIRRZOPWqhble84YBQ8SSSBWNTsR/VyXE/oXuuBIos4kX33DR+s5jEJB44qEWZrzhzPWScwkiPKqVcAaIimpcH1swO9xVbXZF6u9cWVB5iepC0J0gnbKrU4zIRqXNQs9TgYuNxwCNj/dvPzZNVITf33gzO2ePaycvV04cwJLc8bAexpEJJ8nvec9L3ewbunHfywVxT8wUqiXWLWaTjXASvkYxQGsRjFqWwGhgDar37+QYTUN4J7bgrYg/sKDdbdJyIr1tbdKepvh47QJ1aCFj77T1yWxdIu5cukfu6xgGCTK53UTxVdEz5s9ci3Ji/aQJQLH4ceQjV09gcmOj1IQ1QcKtwJBYaOg7yajJl4qo3THYeOJz6ae9okN6C2ECMFESj+f6txgImXZunzT6twiPYLweN+llJVRPZ09Z3FNgNcYWINzuYTn+YZxfgyQA4F9pEaCVA0HcGLUNyHvfRD3F/JXzx9TcD7ztWgA==" />
    </characteristic>
    <characteristic version="13.5" type="AppMgr">
        <parm name="Action" value="LaunchApplication" />
        <parm name="ApplicationName" value="WI Agent" />
    </characteristic>
    </wap-provisioningdoc>

V. (Optional) Apply Managed Config through Intent

If Managed Configurations are not supported by your EMM, after launching the Wireless Insights Agent, use the following intent to send the managed configuration:

    “am broadcast -a 'com.zebra.wirelessinsights.agent.ACTION_CONFIGURE_EXTERNAL_CONNECTION' --es 'message' '<Wireless Insights Enrollment Configuration>’”

For <Wireless Insights Enrollment Configuration>, paste the encrypted Wireless Insights Enrollment Configuration copied from step I.

VI. Apply License

To activate the Wireless Insights license in production environments (not required for trials), use one of the following methods:

  • StageNow - Use StageNow to generate a barcode or XML that activates the license through the Cloud License Server (CLS). The XML can be deployed to devices through your EMM. For instructions, see Generate License XML.
  • OemConfig with EMM - Use Zebra OEMConfig to obtain the license from CLS and deploy it to devices using your EMM. For instructions, see Activate CLS License via OEMConfig.

VII. Check Agent Connection

To verify the successful deployment and operation of the Wireless Insights Agent, follow these steps to check its connection status on both the device and within the ZDNA Cloud platform.

Device

Ensure that the Wireless Insights Agent is connected to the ZDNA Cloud server by checking the following statuses in the Wireless Insights Agent:

  • Feature Running: Voice is Running

  • ZDNA Connection (under External Connections):

    • Connected - Indicates the Wireless Insights Agent is successfully deployed
    • Activated - Indicates the Wireless Insights license is applied

    image

ZDNA Cloud

In the ZDNA Cloud web console, go to Support Tools > Wireless Insights from the left menu. Verify that the device status, whether in its assigned group or unassigned group, shows "Active." This confirms successful enrollment.

image

Guide: Deploy XML via EMM

This section provides guidance on submitting .XML file content outlined in Setup instructions for EMMs Without Auto Options subsections that required XML submission, specific to the EMM in use - SOTI MobiControl or Workspace ONE UEM. XML content submissions include:

  • Delegation Scope
  • Permissions and Launch Agent

SOTI MobiControl

Follow the instructions below to push an .XML file using SOTI MobiControl:

  1. In the SOTI MobiControl web console, go to Policies > File Sync and click File Manager. image
  2. Click Browse, select the desired .XML file to submit, click Import, then click OK. image
  3. Click New File Sync Policy. image
  4. Click Android. image
  5. Enter a name for the policy and click Next. image
  6. Click Download from Server, select the .XML file, select the appropriate folder, and click Next. image
  7. Enter/select the following, then click Next:
    • Enable Post-Sync Script: [toggle on]
    • Script Type: Custom
    • Script Editor: mxconfig sdcard/WI_Agent_Launch_permissions.xml
    • Execute Script Only if Files Transmitted: [toggle on] image
  8. Click Device Update and then click Save and Assign. image
  9. Select the group or device(s) to apply the .XML file. Click the file sync icon from the bottom menu. image
  10. Click Sync Files Now to initiate the file synchronization. image

Workspace ONE UEM

Follow the instructions below to push an .XML file using Workspace ONE UEM:

  1. In the Workspace ONE UEM web console, go to Orchestration > File Actions. Click Add Files/Actions. image
  2. Select Android. image
  3. Enter a name for the File/Action and click the Files tab. image
  4. Click Add Files. image
  5. Choose the .xml and click Save. image
  6. Enter /sdcard for the Download Path, and enter the version if needed. Click Save. image
  7. The file is added. Click the Manifest tab. Under Installation Manifest, click Add Action. image
  8. Select the following, then click Save.
    • Action(s) To Perform: Apply Custom Settings
    • File: [Choose the .XML file] image
  9. Create a product using the file/action just created. Go to Orchestration > Products and click Add Product. image
  10. Select Android. image
  11. Enter a name, assign a Smart Group, and click on the Manifest tab. image
  12. Click Add. image
  13. Select the following and click Save.
    • Action(s) To Perform: File/Action - Install
    • Files/Actions: [Select the File/Action created from step 9.] image
  14. Click Save. image
  15. Deploy the product created. Go to Orchestration > Products (under Product Provisioning). Search for the product created. Select the product, click More Actions, and select Reprocess.
    Note: If the product is in the deactivated state, it must be activated before reprocessing. image

Generate License XML

Zebra's StageNow tool allows the creation of staging profiles that can generate a barcode for scanning with StageNow or generate an XML file for deployment through your Enterprise Mobility Management (EMM) system to distribute Wireless Insight licenses. When procuring the license, a confirmation email is sent containing the Cloud Licensing Service (CLS) URL, which is required for license activation.

To create a StageNow profile:

  1. Open StageNow.

  2. Click Create new Profile from the left-hand menu.

  3. Select MX version 10.2 or higher to match the MX version on the device. Select Xpert Mode and click Create.

  4. Enter a profile name and click Start.

  5. Scroll down and click LicenseMgr. It will appear on the right side. Click Add.

  6. Under LicenseMgr, fill in the following and click Continue:

    • License action type: Perform Zebra license action
    • Zebra license action: Activate Feature
    • Feature Name: wfw-feature-api
    • License Source URL: [Paste the CLS URL supplied by Zebra's confirmation email]
    • License Source Friendly Name: [Enter a name identifier]

  7. Click Complete Profile to finish creating the StageNow profile.

Deployment options:

  • StageNow: Generate a barcode from the StageNow profile. Open StageNow client on the device and scan the generated barcode(s).
  • EMM: Export the XML from the StageNow profile. Do not modify the XML file to prevent unexpected behavior. Push the XML profile to the device via EMM (consult the EMM guide) or Zebra DNA Cloud.

Intents

Stop Voice Analysis

Use the following intent to stop voice analysis:

    "am broadcast -a 'com.zebra.wirelessinsights.agent.ACTION_EXTERNAL_COMMANDS' --es 'message' '{ \"message_type\": \"command\", \"message\": { \"action\": \"stop\", \"feature\": \"voice\"}}'"

Start Voice Analysis

Use the following intent to start voice analysis, replacing both instances of 5060 values with your desired port number:

    "am broadcast -a 'com.zebra.wirelessinsights.agent.ACTION_EXTERNAL_COMMANDS' --es 'message' '{ \"message_type\": \"command\", \"message\": { \"action\": \"start\", \"feature\": \"voice\", \"filter\": [\"warning\", \"error\"], \"configuration\": [ { \"key\": \"activityMode\", \"value\": \"PASSIVE_MODE\" }, { \"key\": \"sessionName\", \"value\": \"wi\" }, { \"key\": \"reportLevel\", \"value\": \"INFO\" }, { \"key\": \"voicePktFilterRule\", \"value\": \"TCP:5060,UDP:5060\" }, { \"key\": \"dynamicCodec\", \"value\": true }, { \"key\": \"port\", \"value\": 4556 } ] } }'"

Assign Group Name

Assigning a group name to devices helps organize them when displayed in the Wireless Insights dashboard within ZDNA Cloud. Use the intent below to assign a group name to the device, replacing Zebra_group with your desired group name. This intent should be sent after the Wireless Insights Agent is installed and configured.

    "am broadcast -a 'com.zebra.wirelessinsights.agent.ACTION_EXTERNAL_COMMANDS' --es 'message''{\"message_type\":\"command\",\"message\":{\"action\":\"set\",\"feature\":\"server_config\",\"configuration\":[{\"key\":\"groupName\",\"value\":\"Zebra_group\"}]}}'"

See Also