All Collections
Onboarding/Getting Started
UXI App for Sensor Onboarding
UXI App for Sensor Onboarding

A usability guide.

sabine avatar
Written by sabine
Updated over a week ago

Introduction

Use the UXI App to troubleshoot any issues which may be preventing sensors from connecting to the UXI cloud service. Onboard sensors quickly and easily on Ethernet networks with 802.1X authentication or proxies using the UXI App hands-free auto configuration via Bluetooth.

You can download the app from Google Play.

Getting started

To get started, the following requirements need to be met:

  1. Valid UXI dashboard sign-in credentials.

  2. A Bluetooth enabled Aruba UXI G-series sensor. Visit the install website for more information.

  3. A supported Android device with Android Marshmallow (Android 6) or better.

  4. Bluetooth enabled on the device.

  5. Download the UXI App from Google Play.

Sign in

To start the sign-in process, tap the newly installed UXI App icon on your device when the download has completed.

Launching the UXI App

When launching the UXI App for the first time, a welcome tutorial will be presented which will display an introductory guide on the UXI App's main features. Swipe through the screens and tap the Get Started button to present the sign-in screen.

Welcome tutorial

On every other subsequent launch of the UXI App, the welcome tutorial will not be presented and instead, the sign-in screen will be presented containing an email text field input. Fill in the email address associated with the UXI dashboard sign-in and tap continue to proceed.

If the email address is associated with an SSO (Single Sign-On) provider, you will be directed to your SSO provider's sign-in screen.

SSO provider sign-in

If the email address is not associated with an SSO provider, the UXI App will present a password text field on validation of the email address.

Password sign-in

Once you are successfully signed in and authenticated, the UXI App will present the sensor list.

Select account

Accepting Bluetooth permissions

At this point, a permission alert will be presented, asking for Bluetooth access. This is to search for available G-series sensors that are within range. Aruba UXI has the highest security standards and practices and at no point will the UXI App maliciously use Bluetooth access. If Bluetooth permissions are denied, only limited features will be available to use.

Before searching for available G-series sensors within Bluetooth range, an account for which to search for sensors must be selected from the list. If a customer is not selected, a default account will be allocated.

Please make sure the correct customer is selected to search for the correct sensors.

Sensor list

Once an account has been selected or the screen has been dismissed, the sensor list screen will be presented.

Searching for a sensor via Bluetooth

The UXI App will present a Bluetooth loading indicator, which indicates that the UXI App is searching via Bluetooth for nearby G-series sensors that are within Bluetooth signal range.

When the UXI App detects available sensors via Bluetooth, the UXI App will authenticate these sensors and present a representation of the sensors on the screen in the form of a list of sensors.

Searching for nearby sensors

If the UXI App cannot ascertain the authenticity or identify nearby sensors via Bluetooth, the no sensors located message will be displayed. Tap search again or pull the screen down to refresh and scan for sensors.

No nearby sensors found

The list of sensors will provide information that can help troubleshoot the sensor and supply updated real-time feedback on the progress of the configuration transfer from the UXI App to the sensor. Below is a detailed explanation of the particulars that are defined in the sensor list.

  • The sensor serial number and name (Only the serial number will appear if a name for a sensor has not been set on the dashboard).

  • The Ethernet status icon. These icons will indicate the state of Ethernet on the sensor.

  • The Ethernet status label.

  • The configuration feedback label.

  • UX-G5E G series-sensors do not display mobile information.

Sensor list (Sensor serial and Ethernet states)

Sensor list (Sensor name and mobile states).

Ethernet and mobile states

The UXI App gives indicators of the state of Ethernet and mobile connectivity of a G-series sensor. The states will either indicate a green, red, or gray icon, depending on the state the sensor is in. A corresponding label in which more detail about the state accompanies each of the Ethernet and mobile state icons.


A green Ethernet or mobile icon indicates that the sensor is connected to the dashboard and is testing.


The following listed Ethernet states may provide a better indication of the state that the sensor is currently in. (For an expanded view, detail and recommendations for the following issues please see the sensor detail screen section of the user guide):

  • Connected

  • Disconnected

  • Sensor problem

  • Transport failure

  • No carrier

  • Authentication failure

  • DHCP failure

  • Portal / proxy failure

  • Incorrect captive portal or proxy

  • Server unreachable

The following listed mobile states may provide a better indication of the state that the sensor is currently in. (For detail and recommendations for the following issues please see the sensor detail screen section of the user guide):

  • Connected

  • Disconnected

  • Sensor problem

  • Transport failure

  • No carrier

  • No data connection

  • Authentication failure

  • DHCP failure

if the sensor in the list on the screen that has not been added to the dashboard the UXI App will detect this and the information screen will be presented.

Missing config for the sensor

The UXI App to sensor configuration transfer process

The UXI App works in conjunction with the Aruba UXI dashboard. It is important to make note that the sensor needs to be onboarded on the settings page of the Aruba UXI dashboard before a configuration can be transferred from the UXI App to the sensor. Please see this article for more information.

The UXI App may be open or closed when adding a sensor to the dashboard. The dashboard will display all available sensors that the Aruba UXI has detected within Bluetooth range.

Adding a sensor on the UXI dashboard

The UXI App will automatically detect when a configuration has been added to the dashboard and will immediately commence the UXI App to the sensor configuration transfer process.

Sensor configuration transfer process

Sensor configuration states

At each step of the configuration transfer process, the UXI App will display information about the progress of the configuration transfer process with both a progress bar and sensor configuration status label.

The following states will be displayed in the UXI App dependent on the stage and state of the sensor:

  • The device is not connected on Bluetooth

  • Checking for new config...

  • Downloading config

  • Transferring config to the sensor

  • Updating config on the sensor

  • Config updated

  • Online

  • Online with backhaul issues

  • Config interrupted

Sensor configuration states

Celebration view

When the configuration transfer has been completed the celebration view will be shown and the sensor list item will transition itself from the Ready for config section to Configured section. The dashboard will subsequently display the sensor is online.

The configuration has been successfully updated on the sensor

Sensor online after successfully transferring a configuration from the UXI App to the sensor

The dashboard indicating that the sensor is online and testing

Update process

In some cases, the sensor may need to be updated to the latest release of the sensor software after the UXI App has successfully transferred a configuration to the sensor. In this case, the sensor will disconnect the UXI App from Bluetooth and the UXI App will display the status of the sensor update on the screen.

The software update is installing on the sensor

Sensor configuration update process

Identify me

Pre-provisioning multiple sensors? Identify a specific sensor from the UXI App. From the from a sensor list item, swipe the item left and tap the identity button icon to change the sensor’s status LED color. This may be performed on multiple sensors.

The identify me button revealed after swiping the sensor list item left

The identify me feature in the UXI App

The sensor LED after being identified by the UXI App

Sensor detail

The UXI App gives detailed insight and additional and supporting information for the sensor, which can be accessed and viewed on the sensor detail screen.

The sensor detail screen will display the following information about the sensor:

  • Model name

  • Serial number

  • WiFi mac address

  • Ethernet mac address

  • Sensor configuration status (Please see sensor configuration states for additional information)

sensor detail model, serial, WiFi and Mac address

The sensor detail screens provide additional information that supplements the Ethernet and mobile states previously described in this document.

Ethernet and mobile state, description, and recommendation information are displayed to help diagnose and troubleshoot issues on the sensor.

sensor detail state, description and recommendation

The following listed Ethernet states may provide a better indication of the state that the sensor is currently in:

  • Connected to Aruba services

  • Ethernet is not connected

  • Problem with Sensor Ethernet adapter

  • Transport layer failing

  • Ethernet is not connected

  • Ethernet authentication failure

  • Unable to obtain an IP address

  • Incorrect portal/proxy

  • Configured captive portal failing

  • Https get failure

A detailed description of the Ethernet can be displayed as one of the following:

  • Ethernet is connected.

  • The Ethernet cable is disconnected or the port has no connectivity.

  • A problem was detected with the Sensor.

  • The transport layer for the Ethernet connection on this sensor is failing

  • No carrier detected—the Ethernet cable is disconnected or the port has no connectivity.

  • Ethernet 802.1X authentication failure detected.

  • The server was not able to obtain an IP address over DHCP.

  • The sensor has been presented with a captive portal on the Ethernet interface. The sensor is trying the captive portal configuration for this network but it is not currently working.

  • This usually indicates the sensor has encountered a proxy server or a captive portal is present. Verify your sensor's network proxy settings.

  • Cannot connect to Aruba services.

A recommendation will be given on how to rectify or resolve the issue the UXI App detects on Ethernet. One of the following will be displayed accordingly:

  • The Ethernet cable is connected and the port has connectivity.

  • Please plug in an Ethernet cable and ensure that the Ethernet port is correctly configured.

  • Please contact support and provide the sensor serial number and sensor status light indication color.

  • Transport failure.

  • Please double check your Ethernet network settings and verify the authentication details are correct.

  • Verify a DHCP server is available on the configured Ethernet network or Ethernet APN.

  • Please update the captive portal configuration by recording a new Captive Portal authentication flow using the Chrome Fside recording extension and provide it to our support teams.

The following listed mobile states may provide a better indication of the state that the sensor is currently in:

  • Connected to Aruba services

  • Mobile is not connected

  • Problem with sensor cellular module

  • Transport layer failing

  • Mobile is not connected

  • No data connection

  • Mobile authentication failure

A detailed description of the mobile can be displayed as one of the following:

  • Mobile is connected

  • Mobile is disconnected

  • A problem was detected with the sensor

  • The transport layer for the mobile connection on this sensor is failing

  • No carrier detected

  • Mobile 802.1X authentication failure detected

  • The server was not able to obtain an IP address over DHCP

A recommendation will be given on how to rectify or resolve the issue the UXI App detects on mobile. One of the following will be displayed accordingly:

  • Mobile is connected and the sensor is online

  • Mobile is disconnected and the sensor is offline

  • Please contact support and provide the sensor serial number and sensor status light indication color

  • Please contact support to investigate further

  • Please double check your mobile network settings and verify the authentication details are correct

  • Verify a DHCP server is available on the configured mobile network or mobile APN

Sensor detail screen

Identify me

Tap the identify me button icon to change the sensor’s status LED color. This may be performed on multiple sensors.

The sensor led after being identified by the UXI App

More

Tapping on the ellipse icon on the sensor list and sensor detail screens will navigate and display the more screen. The more screen will display the following tappable options:

  • How it works

  • Troubleshooting

  • Switch account

  • Sign out

More screen

How it works

How it works describes a brief introduction to the UXI App.

How it works

Troubleshoot shooting

If the UXI App is unable to detect a sensor via Bluetooth that is physically within range or if there were any errors or problems with the sensor configuration transfer and if the sensor does not go online after transferring the sensor configuration, the troubleshooting screen will assist to resolve issues.

Refer to the following for guidance of the meaning of the LED states:

Troubleshoot sensors

Switch customer

This searchable list allows the customer to be changed in order to search for the sensors under that customer via Bluetooth. Simply start typing the name of the customer and select it from the list.

Terms and conditions

This screen displays the privacy policy, terms and conditions, and other legal resources that might be needed for reference.

Sign out

Signing out will transition the UXI App to the sign-in screen and invalidate or expire the sign-in credentials for the UXI App. The UXI App will disconnect from any connected sensor (s).

Support

If you experience any issues with your sensor or dashboard, use the speech bubble icon at the bottom right of your dashboard to chat with someone from Aruba User Experience Insight. Go to dashboard

Read our handy articles about frequently asked questions we get on our support channel.

Did this answer your question?