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.
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:
You can install the Endpoint Agent interactively by following these instructions:
- 1.Launch the installer. You will be guided by the wizard through the installation steps. Click the Next button.
- 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 Extended Network Tests 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.
- 3.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\
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.
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:
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.
The installation can be done in either of the following ways:
You can install the Endpoint Agent interactively by following these instructions:
- 1.Download the .zip file and and unzip it.It contains the .pkg file and the installation configuration file, named installation-config.te-endpoint-agent.
- 2.Install the .pkg file on the target machine.
- 3.Double-click (open) installation-config.te-endpoint-agent to set the account token and register the agent.
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.Download the .zip file and unzip it.It contains the .pkg file and the installation configuration file, named installation-config.te-endpoint-agent.
- 2.Install the .pkg:
installer -pkg <path_to_pkg> -target / - 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.
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:
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:
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.
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:
ddnennmeinlkhkmajmmfaojcnpddnpgbLast modified 1mo ago