Skip to main content
All CollectionsGetting Started
Onboard Sensors Using UXI App
Onboard Sensors Using UXI App

How to onboard sensors to the UXI dashboard using the UXI App.

Updated over 3 months ago

UXI is now available for new customers on the Greenlake Cloud Platform (GLP). Check out the article Getting Started with User Experience Insight on the HPE Greenlake Cloud Platform and the Frequently Asked Questions for more information.

For new dashboards on the Greenlake Cloud Platform, we are working on a new update for the Android Onboarding App, but it has not yet been released. Currently, the Onboarding App only works for existing non-GLP dashboards.

Introduction

Use the UXI App to troubleshoot any issues that 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's hands-free auto configuration via Bluetooth.

Getting Started

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

Sign in

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

Launching the UXI App

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

Welcome Tutorial

On every subsequent launch of the UXI App, the welcome tutorial will not be presented. Instead, the sign-in screen will be displayed, containing an email text field input. Fill in the email address associated with your 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.

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

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 necessary to search for available G-series sensors within range. HPE Aruba Networking adheres to 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.

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

Please ensure the correct customer is selected to search for the appropriate 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 display a Bluetooth loading indicator, signaling that it is searching for nearby G-series sensors within Bluetooth signal range.

When the UXI App detects available sensors via Bluetooth, it will authenticate these sensors and display them on the screen as a list of sensors.

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

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 defined in the sensor list:

  • Sensor Serial Number and Name: The serial number and name of the sensor will be displayed. If a name has not been set for the sensor on the dashboard, only the serial number will appear.

  • Ethernet Status Icon: These icons indicate the current Ethernet status on the sensor.

  • Ethernet Status Label: Displays the Ethernet connection status.

  • Configuration Feedback Label: Provides real-time feedback on the configuration process.

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

Ethernet and Mobile States

The UXI App provides indicators for the state of Ethernet and mobile connectivity on a G-series sensor. The states are represented by green, red, or gray icons, depending on the sensor's current status. Each Ethernet and mobile state icon is accompanied by a corresponding label that provides more detailed information about the state.

Green Ethernet or Mobile Icon: Indicates that the sensor is connected to the dashboard and is actively testing.

The following listed Ethernet states may provide a better indication of the current state of the sensor. (For an expanded view, details, 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 current state of the sensor. (For details 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 has not been added to the dashboard, the UXI App will detect this, and an information screen will be presented.

The UXI App to sensor configuration transfer process

The UXI App works in conjunction with the HPE Aruba Networking UXI dashboard. It is important to make note that the sensor needs to be onboarded on the settings page of the 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 UXI App has detected within Bluetooth range.

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

Sensor Configuration States

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

The following states may be displayed in the UXI App, depending 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

Celebration view

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

Sensors are indicated as 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 scenario, the sensor will disconnect the UXI App from Bluetooth, and the UXI App will display the status of the sensor update on the screen.

Identify Me

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

Sensor Detail

The UXI App provides detailed insights and additional 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

  • Wi-Fi MAC Address

  • Ethernet MAC Address

  • Sensor Configuration Status

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

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

Ethernet States

The following listed Ethernet states may provide a better indication of the current state of the sensor:

  • Connected to HPE Aruba Networking services

  • Ethernet is not connected

  • Problem with Sensor Ethernet adapter

  • Transport layer failing

  • Ethernet authentication failure

  • Unable to obtain an IP address

  • Incorrect portal/proxy

  • Configured captive portal failing

  • HTTPS GET failure

Detailed Descriptions of Ethernet States:

  • Ethernet is connected: The Ethernet connection is active and functioning.

  • The Ethernet cable is disconnected or the port has no connectivity: The sensor is not detecting a connection on the Ethernet port.

  • A problem was detected with the sensor: The sensor has encountered an issue with its Ethernet adapter.

  • The transport layer for the Ethernet connection on this sensor is failing: The underlying network transport layer is not functioning correctly.

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

  • Ethernet 802.1X authentication failure detected: The sensor failed to authenticate on the Ethernet network.

  • The server was not able to obtain an IP address over DHCP: The DHCP server did not assign an IP address to the sensor.

  • The sensor has been presented with a captive portal on the Ethernet interface: The sensor is attempting to authenticate through the captive portal but is failing.

  • 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 HPE Aruba Networking services: The sensor is unable to establish a connection to the service.

Recommendations for Ethernet Issues:

  • Ethernet is connected and the port has connectivity: No action needed.

  • Please plug in an Ethernet cable and ensure that the Ethernet port is correctly configured: Verify the physical connection and network port configuration.

  • Please contact support and provide the sensor serial number and sensor status light indication color: Contact support for further assistance.

  • Transport failure: Check the transport layer configuration and ensure it's functioning properly.

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

  • Verify a DHCP server is available on the configured Ethernet network or Ethernet APN: Confirm that a DHCP server is operational and accessible.

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

Mobile States

The following listed mobile states may provide a better indication of the current state of the sensor:

  • Connected to HPE Aruba Networking services

  • Mobile is not connected

  • Problem with sensor cellular module

  • Transport layer failing

  • No data connection

  • Mobile authentication failure

Detailed Descriptions of Mobile States:

  • Mobile is connected: The mobile connection is active and the sensor is online.

  • Mobile is disconnected: The sensor has lost its mobile connection and is offline.

  • A problem was detected with the sensor: The sensor has encountered an issue with its cellular module.

  • The transport layer for the mobile connection on this sensor is failing: The underlying network transport layer is not functioning correctly.

  • No carrier detected: The sensor is not detecting a mobile network carrier.

  • Mobile 802.1X authentication failure detected: The sensor failed to authenticate on the mobile network.

  • The server was not able to obtain an IP address over DHCP: The DHCP server did not assign an IP address to the sensor.

Recommendations for Mobile Issues:

  • Mobile is connected and the sensor is online: No action needed.

  • Mobile is disconnected and the sensor is offline: Verify the mobile connection and settings.

  • Please contact support and provide the sensor serial number and sensor status light indication color: Contact support for further assistance.

  • Please contact support to investigate further: Support may need to look into more complex issues.

  • Please double check your mobile network settings and verify the authentication details are correct: Ensure that network authentication settings are accurate.

  • Verify a DHCP server is available on the configured mobile network or mobile APN: Confirm that a DHCP server is operational and accessible.

Identify Me

Tap the Identify Me button icon to change the sensor’s status LED color. This action can be performed on multiple sensors.

More

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

  • How it works

  • Troubleshooting

  • Switch account

  • Sign out

How It Works

The How It Works section provides a brief introduction to the UXI App.

Troubleshooting

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

The meaning of different LED colors are as follows:



Switch Customer

This searchable list allows you to change the customer in order to search for 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 Intercom bubble icon at the bottom right of your dashboard to chat with someone from HPE Aruba Networking User Experience Insight. Go to dashboard

Read our articles about frequently asked questions: View articles

Did this answer your question?