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.
For information on additional configuration options, including browser extension installation and TCP support, see Endpoint Agent Installation Reference before continuing.
Once the installation is complete, review the summary, and click Close.
The new Endpoint Agent will be listed under Endpoint Agents > Agent Settings.
  • For Endpoint Agent Pulse Users: The installation process is now complete.
  • For Endpoint Agent Users: Clicking Close will launch Google Chrome (if installed). See Install the Browser Extension for the next steps.
For Mac OS Catalina Users: Starting with Mac OS Catalina, 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.
Effective January 11, 2022, as a first step towards resolving this issue; the Endpoint Agent Settings Page will be modified to serve a zip archive (instead of PKG). This zip archive will bundle the installation configs ( .te-endpoint-agent or .te-endpoint-agent-pulse files) separately and the installer package ( .pkg files) for MacOS.
The installation process, in this case, changes as follows:
Interactive installations
  1. 1.
    Download and unzip the downloaded zip file (it contains PKG and installation config, named as <ThousandEyes Account Name>.te-endpoint-agent).
  2. 2.
    Install PKG file on the target machine (Ignore the warning from the Mac Gatekeeper).
  3. 3.
    Double-click (open) the <ThousandEyes Account Name>.te-endpoint-agent to set the account token and register the agent.
Silent installations
  1. 1.
    Download and unzip the downloaded zip file (it contains PKG and installation config, named as <ThousandEyes Account Name>.te-endpoint-agent).
  2. 2.
    Install 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 you are installing the Endpoint Agent before January 11, 2022, either approve opening the installer from the local machine’s System Preferences -> Security & Privacy -> General configuration page, or use the command line instructions below:
  1. 1.
    On the local machine, open a terminal window.
  2. 2.
    Run the following command, replacing the example filename/path:
    sudo installer -pkg "~/Downloads/Endpoint\ Agent\ for\ exampleorg-x64-1.3.0.pkg " -target /
After running the command and confirming sudo permissions, the agent will install. If you are using the browser extension, you can now review the Install the Browser Extension instructions.
Last modified 49m ago
Copy link