Ubuntu Install Guide

  • 1 minute(s) read
Prev Next

This was tested on a fresh VM running Ubuntu 22.04.4, using the minimal server package. No additional packages were installed as part of the setup process.

The server will require an active internet connection that can reach https://proddebrepo.catchpoint.net/repo, as well as the default Debian repos. Note that most of these commands will need to be run as root.

Installation Instructions

  1. Get the repo list file from the Catchpoint repo and add it to the apt sources:
    ~# wget https://proddebrepo.catchpoint.net/repo/proddebrepo.list -O /etc/apt/sources.list.d/proddebrepo.list
  2. Get the public key for the Catchpoint repo and add it to the apt trusted store:
    ~# wget https://proddebrepo.catchpoint.net/repo/prod-key.asc -O /etc/apt/trusted.gpg.d/catchpoint_prod.asc
  3. Update the local apt and confirm it can access the Catchpoint repo:
    ~# apt-get update
  4. (Optional) Search for the Catchpoint Agent to confirm the version you are looking for is available:
    ~# apt search syntheticagent
    Sorting... Done
    Full Text Search... Done
    syntheticagent/stable 1.15.5.538 amd64
    Synthetic Node Service from CatchPoint (Release name: tiger / Configuration: release)
  5. The Agent can be installed with the following command:
    ~# apt install -y syntheticagent
  6. The regular Catchpoint commands can be used to configure the Agent at this point. You can confirm the services are installed and running as expected:
    ~# catchpoint status
    SELinux: Disabled
    commeng: running
    deployeng: running
    testeng: running
    txeng: running
    xvfb: running
    pacprocessor: running
    cpadmin: running
    cpsns: running
    cprapi: running

Running Chrome Versions Older than 93

Add this Chrome flag:

--disable-seccomp-filter-sandbox

In addition Ubuntu requires the below flag to be set for chrome older than 93 to function properly. Please use the below steps to set the flags.

  1. ~# sudo echo "ADD --disable-seccomp-filter-sandbox=1" >/etc/catchpoint.d/chrome_custom_launch_switches.config
  2. ~# sudo chown serveruser:cp /etc/catchpoint.d/chrome_custom_launch_switches.config
  3. ~# sudo chmod 0400 /etc/catchpoint.d/chrome_custom_launch_switches.config
  4. ~# sudo catchpoint restart

You can learn more about Chrome flags for Enterprise nodes here:
https://docs.catchpoint.com/docs/enable-chrome-flags-for-linux-enterprise-nodes.

More details about the security implications of settings this flag can be found here:https://chromium.googlesource.com/chromium/src/+/0e94f26e8/docs/linux_sandboxing.md#the-sandbox-1