Install the Endpoint Agent
This article describes how to install the Endpoint Agent on the various supported operating systems.
To install the Endpoint Agent, run the graphical installer (for download instructions, see Download the Endpoint Agent). The installer requires the user to agree to the software license, and to confirm or configure the installation location.

Installation on Windows

The Windows installer package (MSI) installs all the components necessary for the Endpoint Agent to function. The Windows MSI installer, like any other Windows software package, can be invoked interactively by a user that has administrative privileges on the target machine.
The installation can be done in either of the following ways:

Interactive Installation

You can install the Endpoint Agent interactively by following these instructions:
  1. 1.
    Launch the installer. You will be guided by the wizard through the installation steps. Click the Next button.
  2. 2.
    Follow the instructions in the installation wizard and continue to the next steps.
For information on additional configuration options, including browser extension installation and TCP support, see Endpoint Agent Installation Reference before continuing.
Although, browser extensions are an opt-in feature during installation, ThousandEyes does not recommend installing the Google Chrome and Microsoft Edge browser extensions via the installer as it might conflict with the existing Group Policy settings.
You can refer the Install the Endpoint Agent Browser Extension article for alternate methods to install the browser extension.
  1. 1.
    Upon successful installation, the Endpoint Agent doesn’t create any entries under the “Applications Menu”. All the Endpoint Agent products are installed at: C:\Program Files (x86)\ThousandEyes\

Silent Installation

You can install the Endpoint Agent silently, or schedule silent installation as part of an installation script. In such cases, use the following instructions via the command-line:
msiexec.exe /i <path_to_msi> /quiet /norestart /qn /l*vx <path_to_log>
For example, the following command will install the Endpoint Agent via the MSI located at C:\Endpoint Agent-x86-1.2.0.msi and will save the installation output to the file C:\ThousandEyesInstall.log:
msiexec.exe /i "C:\Endpoint Agent-x86-1.2.0.msi" /quiet /norestart /qn /l*vx "C:\ThousandEyesInstall.log"
For information on additional configuration options, including browser extension installation and TCP support, see Endpoint Agent Installation Reference before continuing.
The Endpoint Agent does not require a machine restart upon installation. But there may be a case where Windows OS requires a reboot, and this can be part of your company’s internal IT policy too. ThousandEyes recommends you to use the /norestart flag in the installation command line. If the silent installation fails, the output log file will contain the necessary information to pinpoint the root cause of the failure.

Verifying Your Installation

Upon successful installation, all the installed files can be seen in the folder - C:\Program Files (x86)\ThousandEyes\Endpoint Agent
The Endpoint Agent can be uninstalled from the Add/Remove Programs in the Control Panel or Apps & Features interface in the Setings:

Installation on MacOS

The macOS installer (.pkg file) installs all the components necessary for the Endpoint Agent to function except the Chrome extension (for details see Chrome Extension). The macOS .pkg installer, like any other macOS software package, can be invoked interactively by a user who has administrator privileges on the target machine.
Starting with macOS Catalina, however, Mac Gatekeeper no longer allows applications that are not notarized by Apple to be installed via graphical installers. The following error is displayed in this scenario:
“Endpoint Agent for exampleorg-x64-1.23.0.pkg” can’t be opened because Apple cannot check it for malicious software.
As a first step towards resolving this issue, the Endpoint Agent Settings page now serves a .zip archive. This .zip archive bundles the installation configuration files (.te-endpoint-agent or .te-endpoint-agent-pulse files) separately, plus the installer package (.pkg) for macOS.
The installation can be done in either of the following ways:

Interactive Installation

You can install the Endpoint Agent interactively by following these instructions:
  1. 1.
    Download the .zip file and and unzip it.
    It contains the .pkg file and the installation configuration file, named .te-endpoint-agent.
  2. 2.
    Install the .pkg file on the target machine.
    Ignore the warning from Mac Gatekeeper.
  3. 3.
    Double-click (open) .te-endpoint-agent to set the account token and register the agent.

Silent Installation

You can install the Endpoint Agent silently, or schedule silent installation as part of an installation script. In such cases, use the following instructions:
  1. 1.
    Download the .zip file and unzip it.
    It contains the .pkg file and the installation configuration file, named .te-endpoint-agent.
  2. 2.
    Install the .pkg: installer -pkg <path_to_pkg> -target /
  3. 3.
    Execute: /Applications/ThousandEyes\ Endpoint\ Agent.app/Contents/MacOS/te-agent --applyconfig <path_to_te-endpoint-agent_file>
If the silent installation fails, the output log file will contain the necessary information to pinpoint the root cause of the failure. The installation output log file, which is managed by the system, is /var/log/install.log.

Verifying Your Installation

Upon successful installation, the Endpoint Agent appears in the system’s Applications folder:
The Endpoint Agent can be uninstalled by either dragging-and-dropping the application icon into the Trash or by right-clicking the icon and selecting Move to Trash:

Adding the ThousandEyes Chrome Extension

If you used the .pkg installer interactively, when installation completes, Chrome opens and displays the ThousandEyes browser extension in the Chrome Web Store.
To install the extension to your Chrome profile, click the Add to Chrome button:

Verifying Your Installation

After installation, the extension will be visible in Chrome’s extension page under More Tools” > “Extensions:
If all the components are installed correctly and are running on the target machine, the Chrome extension will appear on the Chrome browser toolbar:
However, if the Endpoint Agent is not installed or if there’s a problem in any of its components, the extension’s icon will appear grayed-out.

Updating the Chrome Extension

The ThousandEyes Chrome extension needs to be installed only once, when you install the Endpoint Agent on the target machine for the first time. After the initial installation, the extension will be automatically updated whenever a new extension is published in the Chrome Web Store.
It can take up to four hours for the ThousandEyes Chrome extension to automatically update from the time it was published.
Alternatively, you can set up automatic installation of the Chrome extension on users' computers. This can be done by following the instructions recommended by Google. If you use this automated method, use the following as the extension's ID: ddnennmeinlkhkmajmmfaojcnpddnpgb
Copy link
Outline
Installation on Windows
Verifying Your Installation
Installation on MacOS
Verifying Your Installation
Adding the ThousandEyes Chrome Extension
Verifying Your Installation
Updating the Chrome Extension