Red Hat Agent Installation

This guide explains how to install the Signal Sciences agent on Red Hat.

Prerequisites

Before you begin, determine the version of Red Hat/CentOS you want to use.

Add the package repository

Begin the agent installation by adding the version of the Red Hat/CentOS package repository that you want to use.

Red Hat/CentOS 8

To add the Red Hat/CentOS 8 package, 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

To add the Red Hat/CentOS 7 package, 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.

To add the Red Hat/CentOS 6 package, 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 and configure the Signal Sciences Agent package

Now that you’ve downloaded the Red Hat/CentOS package repository, you can install the Signal Sciences Agent package.

Run the following command to install the Signal Sciences Agent package:

sudo yum install sigsci-agent

Once the agent package is installed, you must create an agent configuration file and add the Agent Access Key and Agent Secret Key:

1. Create an empty agent configuration file in the following location: /etc/sigsci/agent.conf.

2. Log in to the Signal Sciences console.

3. From the Sites menu, select the site that you want to give the agent access to.

4. Click the Agents link in the site navigation bar. The agents page appears.

5. Click the View agent keys button. The agent keys window appears.

6. Click the Copy button to copy the Agent Access Key and Agent Secret Key to your clipboard.

   

7. Navigate to the agent configuration file and paste the Agent Access Key and Agent Secret Key into the file.

   accesskeyid = "AGENTACCESSKEYHERE"
   secretaccesskey = "AGENTSECRETACCESSKEYHERE"
   

8. Save the agent configuration file.

Start the Signal Sciences Agent

Now that you’ve installed and configured the agent package, you can start the Signal Sciences agent.

For Red Hat/CentOS versions 7 and above, run the following command to start the Signal Sciences agent:

sudo systemctl start sigsci-agent

For Red Hat/CentOS 6, run the following command to start the Signal Sciences agent:

start sigsci-agent

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.