Endpoint Agent Installation Reference

This article provides more in-depth information regarding the opt-in/out configuration options within the Endpoint Agent installer.

Browser Extensions

The Endpoint Agent browser extensions can be installed either at the end of the GUI installation process, or as part of the Windows command line installation.

If the browser settings for either Microsoft Edge or Google Chrome are managed by a separate mechanism (for example, Windows Group Policy or Google Chrome Browser Cloud Management), then the extensions should not be enabled during the installation process. This is due to the Endpoint Agent installer modifying registry keys as part of the process, which may cause conflicts.

This issue does not affect the Internet Explorer extension, which can only be enabled during installation.

If you opt not to install the extensions as part of the Endpoint Agent installer process, you can still install them separately. See Install the Browser Extension.

Windows Command-Line

To install the extensions via the command-line, add the relevant flags shown in the examples below:

  • Do not install any extensions:

    msiexec.exe /i <path_to_msi> /quiet /norestart

  • Install all extensions:

    msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="IeExtension,ChromeExtension,EdgeExtension"

  • Install only Internet Explorer:

    msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="IeExtension"

  • Install all extensions except Internet Explorer:

    msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="ChromeExtension,EdgeExtension"

TCP Support for Windows

The ThousandEyes Endpoint Agent allows users to enable support for TCP network tests for Windows via the command line installation. As part of enabling support, the Endpoint Agent installer automatically extracts and invokes the standard Npcap OEM installer for Windows.

Updating Existing Agents: Existing Endpoint Agents that have the TcpNetworkTestsSupport feature turned off (or older versions of the agent that do not support this feature) will need to be reinstalled to enable TCP network tests. These agents can be updated by following the same process as new agents, outlined below. Updating the agent without uninstalling the previous installation should have no impact on existing data.

However, if the previous installation is uninstalled first, the new data will be assigned to a completely new agent that will have the same name as the original. ThousandEyes recommends running the installer without uninstalling the existing agent.

To enable support via the command line, use the installation command flag as outlined in the examples below:

  • Invoke the installer interactively:

    msiexec.exe /i <path_to_msi> ADDLOCAL="TcpNetworkTestsSupport"

  • Invoke the installer silently:

When running the installer silently, all features installed are replaced. Browser extensions must be explicitly mentioned when running the installer silently.

Install only TCP and no extensions: msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="TcpNetworkTestsSupport" Install TCP and all extensions: msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="TcpNetworkTestsSupport,IeExtension,ChromeExtension,EdgeExtension" Install TCP and the Google Chrome extension only: msiexec.exe /i <path_to_msi> /quiet /norestart ADDLOCAL="TcpNetworkTestsSupport,ChromeExtension"

After a successful installation, both the ThousandEyes Endpoint Agent and the Npcap OEM should be listed under the Apps & Features program on Windows. The installation directory for Npcap OEM is:

  • C:\Program Files (x86)\ThousandEyes\Npcap (64-bit Windows)

  • C:\Program Files\ThousandEyes\Npcap (32-bit Windows)

Uninstalling the Npcap OEM entry individually from the Apps & Features list is not supported and should be avoided. Uninstalling the Endpoint Agent also uninstalls Npcap OEM and removes it completely from the Apps & Features list.