en-US
en-US

Mobile Agent - Self Installation


In this article

User roles for this deployment

None. Service Experience insights user credentials are not required for Mobile agent download and activation.


Overview

A variety of agent software is provided to support deployment in heterogeneous network environments. Mobile agents that run as native applications on Windows and macOS are easy to deploy and provide metrics from the end user’s PC though the network to the monitored service.

The Mobile Agent for Desktop can be installed and activated on Windows and macOS environments remotely through a mobile device manager (MDM) like Microsoft Intune JAMF or downloaded and self-installed.

  • Mobile agent for Windows is available for download from our downloads page or the MicroSoft Store.
  • Download Mobile agent for macOs from our downloads page.

Once downloaded and installed, mobile agents are activated by a single-use individual token that is automatically emailed to the installer or provided through thier IT department.

Following are step-by-step instructions for self-installing mobile agents to Windows and MacOS desktops.

Learn more about agents in the Agents article.


Confirm host environment

Windows or macOS device

  • Confirm that the device has available storage.
    • Available storage: 250 mb
  • Confirm that the devices has inbound and outbound internet access.
    • If the agent is behind a firewall, configure the firewall to support the protocols for synthetic probing traffic these agents are expected to send.
    • It is recommended to configure all firewall settings listed below. Failing to do so may result in users configuring agents and probing policies that will be blocked by the firewall.
  • Confirm that agent’s outbound access to Speed Test targets.
    • Speed Test uses HTTP CONNECT requests to upgrade the HTTP connection to WebSocket, and some HTTP proxy servers reject HTTP CONNECT ports to non-SSL ports by default.
    • If the HTTP proxy server is configured on the host OS or SEI agent AND the Speed test server is not SSL enabled, Confirm that your HTTP Proxy server allows HTTP CONNECT requests to non-SSL ports.


Firewall Requirements
Protocol Ports Destination Direction Purpose
Required for Agent to connect to Service Experience Insights
TCP 443 *.edgelq.com Outbound Access to SEI controllers (HTTP2 must be supported when an HTTP proxy is configured)
UDP 53 DNS Server IP Outbound DNS Lookups
UDP 3478, 19302 * Outbound Stun server - used to determine public IP Address
Required for Agents to complete probing sessions with targets outside of the firewall
TCP 80/443 Configured HTTP(S) targets Outbound HTTP(S) Target Addresses
ICMP NA Configured ICMP targets Outbound ICMP Probes to default and custom targets
ICMP Time exceeded messages from external servers should not be blocked by firewall for path tracing
UDP Configured UDP Port (Default 5001) Configured UDP targets Outbound UDP target addresses
UDP Configured UDP Port (Default 5001) for managed UDP targets and UDP port 33434 for other targets UDP/ICMP Targets for which hop trace is enabled Outbound Hop tracing on Linux and Mac OS (only ICMP is used on Windows OS where the agent just executes tracert command)


Mobile Agent for Windows Self Installation

Step 1: Receive the Service Experience Insights Agent Activation email

  • Check your email for the Service Experience Insights Agent activation email.
  • The email containing a link to download the Agent and a one-time activation token.
  • Contact your Service Experience Insights project admin if you expected, but did not receive this email.


Step 2: Click the Download Agent link

  • The link redirects to the Service Experience Insights download page that will detect the OS version required for download

 

  • Click the download button to be redirected to the Service Experience Insights Page of the Microsoft Store

  • Note the publisher is listed as NTT America Network Innovations, Inc.
  • Clck the “Get” button bo begin the download
  • Dismiss any security warning - this apllication is approved for download from Microsoft, but local security settings may trigger warnings.

Step 3: Activation Token

  • Fetch the activation token From the Agent Activation email. It is found in the gray box containing the agent’s name.

Step 4: Activate the agent

  • Launch the Service Experience Insights agent from the applications directory.
  • Enter it into the Agent Activation Token text box and click Next

  • Confirm the PC’s primary location and click the Start button
    • Location is used to understand internet quality across all agents in the project by geography.
    • Depending on the configuration of your agent, the location is discovered by IP lookup, the location manually entered for the agent in the dashboard, or a combination of the two methods.
    • The Agent will anonymize your location to the nearest city or county. You can check the found location later in settings and change the location at any time.
    • The gathering of location information is not optional and cannot be turned off.

Mobile agent for macOS Self Installation

Step 1: Receive the Service Experience Insights Agent Activation email

  • Check your email for the Service Experience Insights Agent activation email.
  • The email containing a link to download the Agent and a one-time activation token.
  • Contact your Service Experience Insights project admin if you expected, but did not receive this email.


Step 2: Click the Download Agent link

  • The link redirects to the Service Experience Insights download page that will detect the OS version required for download

 

  • Click the download button to downlaod the .DMG file
  • Drag the app into the applications folder

  • Launch the Service Experience Insights Mobile Agent.app from the applications folder


Step 3: Activation Token

  • Fetch the activation token From the Agent Activation email. It is found in the gray box containing the agent’s name.


Step 4: Activate the agent

  • Launch the Service Experience Insights agent from the applications directory.
  • Enter it into the Agent Activation Token text box and click Next
  • Confirm the PC’s primary location and click the Start button
  • Location is used to understand internet quality across all agents in the project by geography.

  • Depending on the configuration of your agent, the location is discovered by IP lookup, the location manually entered for the agent in the dashboard, or a combination of the two methods.
  • The Agent anonymizes location to the nearest city or county. You can check the found location later in settings and change the location at any time.
  • The gathering of location information is not optional and cannot be turned off.

Updating mobile agents

Mobile agents are updated on a continual basis. Updating installed agents to the lastest verion ensures optimal peformance and access to the latest SEI features.

Mobile Agent for Windows updates
  • Mobile Agents for Windows are downloaded from the Microsoft Store and update automatically when new versions are released.
  • When a new update is available for an application on the Microsoft Store, the time before that update is automatically installed on your PC can vary due to a few different factors:
    • Update settings: If automatic updates are enabled in your Microsoft Store settings, updates should be downloaded and installed as soon as they are available, provided your device is connected to the internet. However, it might take a few hours before the updates start downloading due to how often the Microsoft Store checks for updates.
    • Network connection: If your PC’s internet connection is slow or unstable, app updates may take longer to download and install.
    • PC usage: If your PC is turned off or in sleep mode when the update becomes available, the update will only begin to download and install once the PC is turned on and connected to the internet.
    • Server load: Sometimes, when a popular application releases a new update, many users will try to download the update at once. This can cause some delay in the availability of the update.

Typically, the update should be installed on your PC within a day after its release on the Microsoft Store.

  • If the agent is not updated automatically:

    • Check for updates through Microsoft Store.

    • Turn on automatic app updates in the Microsoft Store.

    • Ask your IT admin to enable automatic updates from the Microsoft Store per your company’s IT policies.


Mobile Agent for macOS updates

  • Mobile Agents for MacOS are automatically updated if “Automatic Updates” is checked in the agent interface.

  • Click the “Check for Update” button in the agent interface at any time to check for updates.

Service Experience Insights - Updated: 2023-06-07 22:38-UTC