search close

Ubuntu Agent Installation

access_time Updated Jun 20, 2021

Step 1 - Add the Package Repositories

We’ll first add in the Signal Sciences apt repositories as this simplifies the installation process.

Ubuntu 20.04 “focal”

Cut-and-paste the following script into a terminal:

sudo apt update
sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ focal main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Ubuntu 18.04 “bionic”

Cut-and-paste the following script into a terminal:

sudo apt update
sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ bionic main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Ubuntu 16.04 “xenial”

Cut-and-paste the following script into a terminal:

sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ xenial main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Ubuntu 14.04 “trusty”

Cut-and-paste the following script:

sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ trusty main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Ubuntu 12.04 “precise”

Cut-and-paste the following script:

sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ precise main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Step 2 - Install the Signal Sciences Agent Package

  1. To install the package, running the following command.

    sudo apt-get install sigsci-agent

  2. Create the file /etc/sigsci/agent.conf

  3. Configure the agent by inputting the Agent Access Key and Agent Secret Key into the /etc/sigsci/agent.conf.

    • The Agent Access Key and Agent Secret Key for your site are listed within the Signal Sciences console by going to Agents > View agent keys:

    • The Agent Access Key and Agent Secret Key will be visible within the modal window:

    Example /etc/sigsci/agent.conf

    accesskeyid = "AGENTACCESSKEYHERE"
    secretaccesskey = "AGENTSECRETACCESSKEYHERE"

    Additional configuration options are listed on the agent configuration page.

  4. Start the Signal Sciences Agent

    Ubuntu 14.04 and lower sudo start sigsci-agent

    Ubuntu 15.04 through 17.10 sudo systemctl start sigsci-agent

    Ubuntu 18.04 and higher sudo service sigsci-agent start

Next Steps

Install the Signal Sciences Module: