search close

Red Hat Agent Installation

access_time Updated Dec 6, 2022

IMPORTANT: Beginning January 31, 2023, the agent end-of-support policy will take effect. Per this policy, we will support agent versions that are under two years old. On a quarterly cadence, we will deprecate and no longer support agent versions that are older than two years. At the end of January, we will support Agent v4.16.0 and above. If you need help upgrading your agent to a supported version, contact securitysupport@fastly.com.

Add the package repository

Note: If you are installing a Red Hat Agent older than 4.4.0, set gpgcheck=0 in the following scripts.

Red Hat CentOS 8

Run the following script:

sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
[sigsci_release]
name=sigsci_release
baseurl=https://yum.signalsciences.net/release/el/8/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

Red Hat CentOS 7

Run the following script:

sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
[sigsci_release]
name=sigsci_release
baseurl=https://yum.signalsciences.net/release/el/7/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

Red Hat CentOS 6

Note: After Q2 2017, RHEL6 and CentOS 6 will exit “Production Phase 2” according to the Red Hat Enterprise Linux Life Cycle. Only limited “critical” security fixes will be issued. You will need to review the lifecycle document for details and plan appropriately.

Run the following script:

sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
[sigsci_release]
name=sigsci_release
baseurl=https://yum.signalsciences.net/release/el/6/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

Install the Signal Sciences Agent package

  1. Run the following command:

    sudo yum 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 &lsquo;View agent keys&rsquo; 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.

    • Red Hat CentOS 7 or higher

      sudo systemctl start sigsci-agent
      
    • Red Hat CentOS 6

      start sigsci-agent
      

Next Steps

Install the Signal Sciences Module: