search close

Ubuntu Agent Installation

access_time Updated Mar 27, 2023

Add the package repository

Add the version of the Ubuntu package repository that you want to use.

Ubuntu 22.04 - Jammy

Run the following script:

sudo apt-get update
sudo apt-get install -y apt-transport-https wget gnupg
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/sigsci.gpg
sudo echo "deb [signed-by=/usr/share/keyrings/sigsci.gpg] https://apt.signalsciences.net/release/ubuntu/ jammy main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list 
sudo apt-get update

Ubuntu 20.04 - Focal

Run the following script:

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

Run the following script:

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

Run 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/ xenial main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Ubuntu 14.04 - Trusty

Run 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

Run 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

Install the Signal Sciences Agent package

  1. Run the following command:

    sudo apt-get install sigsci-agent
    
  2. Create an empty agent configuration file at /etc/sigsci/agent.conf.

  3. Add the Agent Access Key and Agent Secret Key into the agent configuration file at /etc/sigsci/agent.conf.

    1. Log in to the Signal Sciences console.

    2. Select a site if you have more than one site.

    3. Click Agents in the navigation bar. The agents page appears.

    4. Click View agent keys. The agent keys window appears.

      The ‘View agent keys’ button.

    5. Copy the Agent Access Key and Agent Secret Key.

      The agent keys window.

    6. Enter the Agent Access Key and Agent Secret Key into /etc/sigsci/agent.conf.

      accesskeyid = "AGENTACCESSKEYHERE"
      secretaccesskey = "AGENTSECRETACCESSKEYHERE"
      
  4. Start the Signal Sciences Agent.

    • Ubuntu 18.04 or higher

      sudo service sigsci-agent start
      
    • Ubuntu 15.04 through 17.10

      sudo systemctl start sigsci-agent
      
    • Ubuntu 14.04 and lower

      sudo start sigsci-agent
      
  5. Optionally, enable the agent auto-update service. The service checks the Signal Sciences package downloads site for a new version of the agent and updates the agent when a new version is available.

Next Steps

Explore our module options and install the Signal Sciences module.