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 a UXI Agent Provisioning Token / QR Code

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

To get a Provisioning Token / QR Code, you can open the support chat box in the dashboard or send a request to support@capenetworks.com. Please include your dashboard name.

For trials, the Provisioning Token / QR Code will only be valid for 20 devices. If you have purchased a subscription, the Provisioning Token / QR Code will be valid for the number of subscriptions you have purchased.

By default, 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. If you want a specific Provisioning Token / QR Code that assigns agents to existing groups, please include that information in your support request.

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 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 only available for devices with a camera.

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 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 5 to 10 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?