Skip to main content
All CollectionsAgent for Windows and MacOS
UXI Agent For Windows & MacOS
UXI Agent For Windows & MacOS

Visibility into how users perceive the network—specifically, their digital experience.

Updated this week

UXI Agent for Windows and macOS

The UXI Agent for Windows and macOS is a software application that runs on end-user devices, providing network administrators with real-time insights into user experience and network performance. It captures key performance metrics to help troubleshoot and optimize network connectivity.

Useful information provided by the agent

  • Wi-Fi Experience:

    • Collects key Wi-Fi performance metrics:

      • Signal Strength (RSSI)

      • Transmission Rate (Tx Rate)

      • BSSID, Band, and Channel

    • Wi-Fi Visualization Chart: Displays channel overlap, SSIDs, channel width, and nearby AP signal strength to help admins assess interference and coverage.

  • App Experience: Test critical apps, both internal and external to your environment. Provides valuable information like

    • DNS lookup time, HTTP GET elapsed time, packet loss, latency, jitter, and gateway reachability.

  • Device Information:

    • Captures device model, OS version, network adapter details.

    • Monitors resource utilization (CPU, memory, battery percentage) to assess potential device-level performance issues.

  • Roaming Indication:

    • Tracks BSSID transitions, band swaps, and channel swaps.

    • Future enhancement: Tracking successful and failed roaming events reported by the OS.

  • Back-in-Time Troubleshooting:

    • Stores network metrics over time for root-cause analysis.

    • Enables admins to validate network changes retrospectively.

  • Data Push Destinations:

    • Integrates with other IT monitoring tools to correlate client-side data with network-wide analytics.

  • User Self-Service Portal:

    • Displays network services status (Red = Issue, Green = Normal).

    • Shows applications tested and key device information (OS, ISP, PHY mode).

Coming Soon -

  • Upcoming feature: Network admins will soon be able to remotely enable or disable the UXI Agent directly from the UXI dashboard

Future Considerations

Currently, the agent only tests networks added to the UXI dashboard for monitoring. The agent does not test any network outside the defined list. In the future, we plan to introduce features that will allow network admins to opt to test specific applications or all applications on all networks the user connects to.

Availability:

MacOS & Windows Agent: available for General Availability (GA).

Please reach out to auxi@hpe.com for any questions, suggestions and enhancement requests. Your feedback helps us shape the product.

Installation, Configuration & Subscription

The UXI Agent for Windows and macOS is available in the HPE Networking Support Portal (NSP): - https://networkingsupport.hpe.com/home.

Latest Version for Windows and MacOS agent - 1.24.1

Steps to follow:

  • Click on Software and Document Search.

  • Apply filter under product and select "User Experience Insight".

  • Click on the download button.

Windows:

  • You will see the file HPE_Aruba_Networking_UXI_Agent_version_number.msi. e.g.
    HPE_Aruba_Networking_UXI_Agent_1.24.1.msi in NSP.

  • Locate the downloaded file.

  • Double click the file to open the installation wizard.

    The following window will open; click "Next" and then "Install."

  • After installation:

    • If you didn’t run it from the wizard, search for "UXI Agent" in the Start menu and launch it.

    • The agent will appear in the system tray (taskbar).

  • Proceed to Provisioning Section.

macOS:

  • You will see the file HPE_Aruba_Networking_UXI_Agent_version_number.pkg e.g.
    HPE_Aruba_Networking_UXI_Agent_1.24.1.pkg.

  • Click on the download icon to download.

  • Locate the downloaded file.

  • Double click the file to open the installation wizard. A window will open as shown below.

  • Click "Continue" and then "Install." You will either need to provide the password or use your fingerprint, depending on your system.

  • Grant location Permissions: Upon installation, you will be asked to grant location access. This is required by Apple’s WLANCore API to allow the UXI Agent to detect your network’s SSID and BSSID, ensuring accurate Wi-Fi experience data collection. Rest assured, we do not track your location or use this data for any other purpose. Furthermore, no personal information is collected that could identify you or reveal your activities on your devices.

  • Once installed, you will see a prompt to provide the password one more time. Please enter the password and click "Install Helper."

Provisioning

This is the primary URL for all sensor/agent communication with our backend systems
https://device-gateway.capenetworks.io. If you have any of SASE agents running on your device please include this URL in SSL exclusions.

  • After you have successfully run the agent application, you will see a small smiley in the menu bar. Click on it. A small popup will appear as shown below.

  • Go to the UXI dashboard and perform the following steps:

    If you do not have new Hierarchy and Group based configuration enabled please follow below steps:

    • Settings > Select "Sensors and Agents" under Locations > Click "Add."

    • A popup will appear. In the popup, select "Agent" > Proceed

    else

    • Settings > Select "Agents" > Click "Add Agent"

    • Select a group if you would like > Click "Copy token to clipboard."

    • On your device, paste this in the test box and click "Save."

  • If you do not have the new hierarchy enabled, the agent will start testing immediately if it is connected to one of the networks defined under "Wireless Network" on the UXI dashboard else you would also need to assign the network to the group agent is in.

Expected platform support: Windows 10 & above, MacOS 12 and above.

Subscription

A UXI subscription is required to access the dashboard and manage agents.

  • Agents do not enforce subscriptions—subscription validation happens at the dashboard level.

Request this via support or email at auxi@hpe.com.

Note: UXI is a vendor-neutral platform and works with any infrastructure provider.

Agent in Action

Once Installed and Provisioned

✅ Test results appear on the UXI dashboard within 5-10 minutes after setup.

✅ The agent runs in the background with minimal impact on device performance.

✅ It performs low-impact synthetic tests every 2-5 minutes to measure network experience.

Synthetic Tests

The test cycle runs every 2-5 minutes and performs the following tests:

  • AP Scan

  • Gateway reachability

  • DNS check (a check to see if the agent can resolve cdn.capenetworks.io)

  • HTTP GET

  • PING

The agent can only test the network it is connected to. You cannot change the network settings as you would for a hardware sensor.

You can assign the agents to groups and then assign tests and networks to groups.

If the agent doesn't support an assigned test, it will skip it.

IPV6 support -

  1. Agent is able to test if the machine has IPV6 address assigned to it,

  2. It can also test services and applications with IPV6 addresses

Resource Utilization for Agent

Please Note: These metrics are an average over 10 minutes running 5 tests

Resource

Windows (10 and above)/ macOS (12 and above)

Memory Usage

<100 MB

CPU Usage

~1-3%

Disk Space Required

  • macOS - 200MB

  • Windows - 100MB

Open List of Bugs

This is a high-level list of feature enhancements. If you have any other requirements please email us at auxi@hpe.com

  1. Proxy Support - Agent is not able to provision itself if there is an explicit proxy defined on the user's device.

Known Limitations

  • No Ethernet Support: The agent does not test wired network connections.

  • No PCAP Data: Packet captures are not included in issue triage.

  • No MDM Support for macOS: The agent cannot be installed via MDM for macOS at this time.

  • No Path Analysis: The agent does not support UXI path analysis

  • VPN Limitations: The agent does not tag test results as VPN traffic, even if tests are conducted over a VPN.

  • Limited Test Support - Agent does not support VOIP MOS, Throughput & WAT test

  • Agent does not support any of the settings under Advanced settings ( like roam analysis, voice analysis) under edit section

  • Frequency and Rate Limit - Agent does not support frequency and service rate limit settings

Did this answer your question?