Before you get started with the UXI agent, please make sure the following steps have been completed.

  • Supported Devices: The UXI Agent for Zebra makes use of the Zebra Wireless Insights service on Android-based devices. Please review the supported device list and confirm your devices are running the appropriate OS and lifeguard version. The agent is supported only on these Zebra devices.

  • Ensure Communication with the UXI Cloud: The zebra device must be able to report results to our UXI cloud. Please make sure the required URLs are reachable on the network the zebra device is connected to.

  • Apply Zebra License and Activate Wireless Insights - The UXI Agent uses the Zebra Wireless Insights service. The Wireless Insights service is a licensed feature from Zebra and is not included in your Aruba UXI Agent for Zebra subscription. Please review these steps to make sure the Zebra Wireless Insights license is installed and the Wireless Insights feature is activated on the device.

Get the UXI Agent Provisioning Token / QR Code

When you are ready to start using the UXI Agent, the first step will be to get a Provisioning Token / QR Code from your UXI dashboard. This Provisioning Token / QR Code is used by the agent to know which UXI dashboard the device belongs to.

Provisioning Token / QR Code for Existing Dashboards

To get a Provisioning Token / QR Code for an existing dashboard, go to Settings and Select Add Sensor.

Enter the following options in the Add Sensor menu

  • Sensor Type: Zebra Sensor

  • Groups and Sensors: Select the group you want the sensors to appear in for the visual representation of the dashboard

  • Legacy Group: Select the group you want the sensors to appear in for the test configuration of the dashboard

    Note: Please use the same group selection for both options above unless your dashboard is using the Groups and Sensors Hierarchy Alpha feature.

    If you do not select a group, the Provisioning Token / QR Code will put the sensors at the top-level on your UXI dashboard and you will need to assign the sensors to groups and set the test configuration similar to a hardware sensor after the sensors report to the dashboard.

From this screen, you can scan the QR code or copy the provisioning token to your clipboard to be used in your MDM.

Provisioning Token / QR Code for New Dashboards

To get a Provisioning Token / QR Code for a new dashboard, you can follow the steps n the onboarding wizard.

If you have never logged in to UXI before, you can create a new account here - http://sensor.arubanetworks.com/activate

If you have logged in to UXI, you can create a new account from the Switch Account menu.

On the first step on the onboarding wizard, select the type of sensor to be a Zebra Sensor.

On the next page, the QR Code / Provisioning token is displayed.

From this screen, you can scan the QR code or copy the provisioning token to your clipboard to be used in your MDM.

Install, Configure and Start the Agent

The Aruba UXI Agent is available on Google Play.

It is recommended to install the agent from Google Play through your MDM and use Managed Configurations to apply the provisioning token, but it can also be installed from Google Play locally on the device.

Note: During the provisioning process the agent will attempt to derive a unique device identifier for the UXI dashboard. To derive a unique identifier, the agent uses a combination of device serial and device MAC address (if available). If you are provisioning a device for a second time, it's possible you will see duplicate device entries in your dashboard, especially if you changed what is being sent in the managed configuration or switched from QR code to the provisioning token. You can remove the old device entry from your dashboard.

MDM Installation and Configuration (Recommended)

The agent supports Managed Configurations in order to install and configure the agent on your Zebra devices quickly and easily. Each MDM has a slightly different workflow, but through your MDM you want to do the following:

  • Add the "Aruba UXI Agent” to your MDM from Google Play.

  • Ensure required permissions are set for the application.

    For example, in VMWare Workspace One this is set in your device profile

  • Install the agent to a select group of devices.

  • When installing the agent, send configuration as follows:

    • Enter your provisioning token provided by Aruba in the Aruba UXI Provisioning Token field.

    • Enter the variable for the device name in the Aruba UXI Device Name field.

    • Enter the variable for the device serial in the Aruba UXI Device Serial field.

    • Enter the variable for the device MAC Address in the Aruba UXI Mac Address field.

    By using these variables, the device will use the device specific properties from the MDM. For example, in VMWare Workspace One, the parameters will look like this - {DeviceFriendlyName}, {DeviceSerialNumber}, {DeviceWLANMac}

The agent must be started once. After that it will automatically start when the device reboots. The agent can be started manually (which is the easiest way) or started through the MDM.

Local Installation and Configuration

If you are not installing the agent through your MDM, you can install locally on the device from Google Play.

  • Install the "Aruba UXI Agent” from Google Play.

  • Start the agent on the device, grant requested permissions and scan a QR code provided by the UXI team.

  • The QR code will assign the agents to your respective UXI dashboard.

This method is now available for devices without a camera. To scan on these devices, use the built-in Zebra scanner function.

Android Doze Mode and Battery Optimization

Although we have optimized the agent to not have a large impact on the battery, Android 10 and Android 11 have become more aggressive in optimizing background apps to preserve battery life. In order to make sure the agent collects data in the background and prevent android from ending the process, you also need to set the UXI Agent application Battery Optimization Settings to “Do Not Optimize”.

You can do this manually on the device by going to Settings -> Apps and Notifications -> Advanced -> Special App Access. From the menu select Battery Optimization. Select All Apps from the dropdown, scroll down to locate the Aruba UXI Agent in the list. Select Aruba UXI Agent and select Don’t Optimize and click Done.

You can also scan the following barcode in stagenow after the agent is installed.

You can also do this via AppManager and apply through StageNow or Zebra OEMConfig. If you are building the configuration in StageNow, do the following:

  • Open StageNow on windows to create the configuration

  • Create New Profile

  • Select the MX version of the devices

  • Select Xpert Mode and click Create

  • Give the profile a friendly name and select Start

  • Select AppMgr and add it to Configure. Select Add

  • Under Application Action, Select Application for Battery Optimization

  • Under Remove Application for Battery Optimization enter com.aruba.uxi.android

  • Click Continue, then Complete Profile

  • On the device, scan the StageNow barcode or use the XML to provision via the MDM.

Post Installation Steps:

Once the agent is started, the agent will appear on your UXI dashboard and begin reporting test results in 10 to 15 minutes.

Next, set some tests for the agent to run by assigning agents to groups and assigning test to groups and networks. Since the agent runs in the background, the agent only runs simple tests like PINGs and HTTP GETs and also collects roaming and voice analysis data from the Zebra Wireless Insights service. It's recommended to have hardware sensors at the locations as well as the hardware sensors are dedicated testing devices that test multiple networks (wired and wireless) and do more complex tests. Together the hardware sensors and Zebra agents will give you a better view of how the user experience is at a location.

Did this answer your question?