en-US

Mobile Agent - Self Installation


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 through 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.

Once downloaded and installed, mobile agents are activated by a single-use individual token that is automatically emailed to the installer or provided through their 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 Overview article.


Confirm host environment

Windows or macOS PC

  • Confirm PC OS and storage:
    • OS: Windows 10 or newer, macOS 12 Monterey or newer
    • Available Storage: 250MB
  • If PC is behind a firewall, allow outbound internet access:
    • Configure outbound firewall settings listed in the Firewall Settings article
    • Allow the agent’s full probing functionality by adding all outbound protocols listed to the firewall policy.
  • Route HTTP/HTTPS traffic through a proxy server if required:
    • Enable proxy by configuring the Docker environment settings listed in the Proxy Settings article.
    • Outbound ICMP, UDP traffic, and inbound agent-to-agent probing cannot be routed through the proxy.
  • Confirm 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.

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.
Click to expand

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 to expand

 

  • Click the download button to be redirected to the Service Experience Insights Page of the Microsoft Store
Click to expand
  • 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.
Click to expand

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
Click to expand
  • 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.
Click to expand

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 to expand

 

  • Click the download button to downlaod the .DMG file
  • Drag the app into the applications folder
Click to expand
  • Launch the Service Experience Insights Mobile Agent.app from the applications folder
Click to expand

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.
Click to expand

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.
Click to expand
  • 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.

Microsoft Store app, select Account > App settings

Click to expand

Microsoft Store app, select Library > Apps

Click to expand


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.
Click to expand


In This Article