Endpoint Installation Guide

  • 4 minute(s) read
Prev Next
Notice

On April 15th, 2025, Catchpoint updated its Endpoint logging domain. This change may require customers to update policies and allow the new domain to pass through firewalls.

The domain name change will apply for new versions going forward.

The new Endpoint domain going forward is e.3gl.net. We suggest allowing/whitelisting the domain with a wildcard for script: *.3gl.net. You can continue using the Endpoint software which utilizes our previous domain: r.3gl.net.

Please reach out to your CSM and VE if you have any questions.

Endpoint Software Requirements

Following are the system requirements for the Endpoint Agent (locally installed Endpoint software.)

Supported Operating Systems

The following operating systems are currently supported for Endpoint Monitoring:

  1. Windows Windows 10 or higher (partial support for Windows Server 2012+)
  2. MAC OS
    macOS 10.15

Browser

We support all the Chrome versions above Chrome 43+

(No other browsers supported at this time)

Network Connectivity

Endpoint devices must have unrestricted access to the following:

  • Domains
    e.3gl.net
    updates.catchpoint.com

  • IP Addresses
    63.251.235.39, 63.251.235.40, 63.251.235.41, 63.251.235.42, 63.251.235.43, 107.6.115.150, 107.6.115.151, 107.6.115.152, 107.6.115.153, 107.6.115.154, 63.251.112.74, 63.251.112.73, 63.251.112.75, 63.251.112.76, 63.251.112.77, 107.6.74.56, 107.6.74.58, 107.6.74.59, 107.6.74.60, 107.6.74.55, 173.231.186.87, 173.231.186.89, 173.231.186.88, 173.231.186.91, 173.231.186.90, 47.95.213.124, 101.132.166.251

  • IP Ports:
    The Endpoint client requires port 80 and 443 for Object tests. Traceroute and Ping tests use ICMP.

Proxy Configuration:

Catchpoint Endpoint User Experience supports proxies with and without authentication. Authentication support requires credentials to be present in the OS's Credential Manager.

System requirements

  • 64-bit CPU. Only a single core is required.
  • 50MB of available RAM and up to 500 MB of available disk space.

Manual installation:

The following steps will install the Endpoint agent application and, if Chrome is present on the device, the Catchpoint User Experience browser extension.

  1. Log into https://portal.catchpoint.com and navigate to Control Center > Endpoint mceclip3.png

  2. Click on Install Endpoint Monitoring on the right top to download the Endpoint installer

  3. Choose your OS type
    You will be prompted to choose the OS type of your device. select the type to download the application on your local machine. Before downloading the installer, be sure to capture the License Key from this screen, which will be needed during the installation process.
    mceclip4.png

  4. Launch the downloaded installer application
    mceclip5.png

  5. Input the license key captured previously
    mceclip6.png

  6. Choose the update mode for future releases, then click Next to complete the installation
    mceclip7.png

  7. (Windows) Select whether you want the Catchpoint User Experience Chrome Extension enabled by default via a registry setting
    image.png

  8. Select whether you want the UI installed (as opposed to only performing silent monitoring)
    image.png

  9. Select whether you want to install PCap

When you install the software, it asks you to point the installer at the npcap folder. If you don't do that, the TCP Traceroute doesn't work.
That is the screen that appear during the installation. So if you dont install it, it wont work.
Image
Image
image.png

Extension

If you install Google Chrome on the device after installing the Endpoint Application, you can add the Catchpoint User Experience extension from the Google Play Store by following these steps:

  1. Navigate to the Catchpoint User Experience application in the Google Play store: https://chrome.google.com/webstore/detail/sonar/dibilcjfahbokhiodajibcajcabfjein
  2. Click Add to Chrome.
  3. Review the security dialog and click Add extension.
  4. Once the installation is complete. restart the browser.

Silent installation on Windows:

  1. Download the latest Endpoint installer from the Catchpoint Portal (steps above)
  2. Open the command prompt and navigate to the folder where our Agent is downloaded
  3. Run the below command for silent installation.
    cpue_latest.exe --mode unattended --update_mode 0 --cpue_license <Licence key>

Replace <license key> with your key.

Select a value for the update_mode parameter to define how updates should be managed:

0 = Auto Update
1 = No Auto Update
2 = Prompted Update

To install Call Quality Monitoring add the following parameter to the command:
--enable_nprobe_component 1
For example:
cpue_latest.exe --mode unattended --update_mode 0 --cpue_license <Licence key> --enable_nprobe_component 1

macOS:

To perform silent Endpoint Agent installation on a macOS device:

  1. On the device, download our latest agent from our portal(steps above)
  2. Open the terminal and navigate to the folder where our Agent is downloaded
  3. Run the below command for silent installation.
    sudo /Volumes/ CatchpointUserExperience.6.0.0.3/ CatchpointUserExperience_osx.6.0.0.3.app/ Contents/MacOS/installbuilder.sh --mode unattended --update_mode O --cpue_license <licence key> --enable_nprobe_component 1 --unattendedmodeui none

Replace <license key> with your key.

Replace 6.0.0.3 with the version you're installing.

--
Select a value for the update_mode parameter to define how updates should be managed:

0 = Auto Update
1 = No Auto Update
2 = Prompted Update

To install Call Quality Monitoring add the following parameter to the command:
--enable_nprobe_component 1
For example:
sudo /Volumes/ CatchpointUserExperience.6.0.0.3/ CatchpointUserExperience_osx.6.0.0.3.app/ Contents/MacOS/installbuilder.sh --mode unattended --update_mode O --cpue_license <licence key> --enable_nprobe_component 1 --unattendedmodeui none enable_nprobe_component 1

The Endpoint app also can be installed via Group Policy Objects, remote management like LogMeIn, or by adding registry items.

Uninstalling Endpoint Monitoring

Windows

  1. Close Google Chrome
  2. Open Add/Remove Programs.
  3. Find the Catchpoint Endpoint Monitoring entry on the list and click Uninstall.
  4. Acknowledge that you are uninstalling Endpoint.

To uninstall via command line use the following command from within the CPUE directory:
uninstall.exe --args --mode unattended

Once the Endpoint Agent has been removed, no more data will be collected.

macOS

  1. On the device, open the Applications folder.
  2. Drag the Catchpoint application to the trash, or right-click on the application and select Move to Trash.
  3. Remove the extension from Google Chrome:
    1. In the Google Chrome browser, locate Catchpoint User Experience in the browser toolbar.
    2. Right-click on it and select Remove from Chrome

To uninstall via command line use the following command:
sudo open /Applications/Catchpoint/UserExperience/uninstall.app --args --mode unattended

Once the Endpoint Agent has been removed, no more data will be collected.