Guidance for Windows Software Deployment Teams
The ThousandEyes Endpoint Agent for Windows is provided as an MSI package. Each ThousandEyes customer is issued a customized MSI. The customized MSI includes configuration information to direct the agent to the correct tenant and region. No further configuration is needed. Your organization’s MSI can be generated in the ThousdandEyes portal by one of your administrators. Instructions for this can be found here
Your organization has likely tested using browser extensions and TCP Network Tests. Please use the following MSIEXEC switches to customize the installation for your environmental needs. If no switches are provided, the installer will install the base installation without TCP network tests and will not install browser extensions.

Guidance On Browser Extensions

If your organization is managing browser extensions centrally, it is recommended that you do not install the browser extensions during the MSI deployment. ThousandEyes recommends that you deploy the browser extension(s) using your extension management processes.

Command-Line Options for Msiexec / Msiexec Switches.

The following table documents the Msiexec switches:
Switch
Description
Action
TcpNetworkTestsSupport
TCP Network Tests Support
Install Windows driver and enable support for TCP tests.
EdgeExtension
Microsoft Edge Browser Extension
Enable support for collecting network metrics for approved pages in Microsoft Edge.
ChromeExtension
Google Chrome Browser Extension
Enable support for collecting network metrics for approved pages in Google Chrome.
IeExtension
Internet Explorer Bowrser Extension
Enable support for collecting network metrics for approved pages in Internet Explore.
If no Switches are Passed, no TCP tests and no Browser Extensions are installed.
To install the extensions via the command-line, add the relevant flags shown in the examples below:
  • Base install with no extensions: msiexec.exe /i <path_to_msi> /quiet /norestart
  • Base Install with all extensions: msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="IeExtension,ChromeExtension,EdgeExtension"
  • Base Install with only Internet Explorer extension: msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="IeExtension"
  • Base Install with all extensions except Internet Explorer: msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="ChromeExtension,EdgeExtension"
To view more options, including how to modify existing installs, please view the Endpoint Agent Installation Reference documentation.

Agent Reinstallation

To re-install the agent on the same machine, refer the instructions here.
The following table documents the switches for agent reinstallation:
Switch
Description
Action
ENDPOINT_REINSTALLATION_METHOD
Defines the mode for the reinstallation process.
The MERGE_BY_HOSTNAME answer will prevent duplicate hostnames and tie hostname records together.
ENDPOINT_REINSTALLATION_KEY
Key to authorize the reinstallation process.
This key is generated by the account group and ensures only authorized installers are executing the reinstallation process.
Base reinstallation with no extensions: msiexec.exe /i <path_to_msi> /quiet /norestart ENDPOINT_REINSTALLATION_METHOD=MERGE_BY_HOSTNAME ENDPOINT_REINSTALLATION_KEY=<KEY_GOES_HERE>
Base Install with TCP Network Tests and all browser extensions: msiexec.exe /i <path_to_msi> /quiet /norestart ENDPOINT_REINSTALLATION_METHOD=MERGE_BY_HOSTNAME ENDPOINT_REINSTALLATION_KEY=<KEY_GOES_HERE> ADDLOCAL="TcpNetworkTestsSupport,IeExtension,ChromeExtension,EdgeExtension"
For example, msiexec.exe /i "C:\Download\Endpoint Agent for Endpoint Agent-x64-1.123.0.msi" /quiet /norestart ENDPOINT_REINSTALLATION_METHOD=MERGE_BY_HOSTNAME ENDPOINT_REINSTALLATION_KEY="1b61d55b-a0fe-4f52-ae18-1d49a8eb0c02" ADDLOCAL="TcpNetworkTestsSupport,IeExtension,ChromeExtension,EdgeExtension"

Software Updates

The ThousandEyes Endpoint Agent automatically updates. The update schedule is controlled in your ThousandEyes portal. To control this setting, refer here.
Copy link
Outline
Guidance On Browser Extensions
Command-Line Options for Msiexec / Msiexec Switches.
Agent Reinstallation
Software Updates