Installing the agent on Amazon Linux

This guide explains how to install the Signal Sciences agent on Amazon Linux.

Prerequisites

Before you begin, determine the version of Amazon Linux you want to use: Amazon Linux 2023, Amazon Linux 2, or Amazon Linux 2015.09.01. Amazon Linux 2 is most similar to CentOS 7 and reuses the same configuration. Amazon Linux 2015.09.01 is most similar to CentOS 6 and reuses the same configuration. Amazon Linux 2023 does not mirror CentOS as closely as it did in the past. It is a combination of multiple versions of Fedora and CentOS Stream 9. See Relationship to Fedora. As a result, the baseurl of the yum repository will use amazon/2023 as the distribution name and version number for Amazon Linux 2023.

Add the package repository

Begin the agent installation by adding the version of the Amazon Linux package repository that you want to use. Add the version of the Amazon Linux package repository that you want to use.

Amazon Linux 2023

To add the Amazon Linux 2023 package, run the following script:

1$ sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
2[sigsci_release]
3name=sigsci_release
4baseurl=https://yum.signalsciences.net/release/amazon/2023/$basearch
5repo_gpgcheck=1
6gpgcheck=1
7enabled=1
8gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key
9sslverify=1
10sslcacert=/etc/pki/tls/certs/ca-bundle.crt
11EOF

Amazon Linux 2

To add the Amazon Linux 2 package, run the following script:

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

Amazon Linux 2015.09.01

To add the Amazon Linux 2015.09.01 package, run the following script:

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

Install and configure the Signal Sciences Agent package

Now that you've downloaded the Amazon Linux 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 directory: /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.

If you added the Amazon Linux 2 package, run the following command to start the Signal Sciences agent:

$ sudo systemctl start sigsci-agent

If you added the Amazon Linux 2015.09.01 package, run the following command to start the Signal Sciences agent:

$ start sigsci-agent

Next steps

Explore our module options and install the Signal Sciences module.