Installing the agent on Amazon Linux
Last updated 2023-05-23
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_release4baseurl=https://yum.signalsciences.net/release/amazon/2023/$basearch5repo_gpgcheck=16gpgcheck=17enabled=18gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key9sslverify=110sslcacert=/etc/pki/tls/certs/ca-bundle.crt11EOF
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_release4baseurl=https://yum.signalsciences.net/release/el/7/$basearch5repo_gpgcheck=16gpgcheck=17enabled=18gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key9sslverify=110sslcacert=/etc/pki/tls/certs/ca-bundle.crt11EOF
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_release4baseurl=https://yum.signalsciences.net/release/el/6/$basearch5repo_gpgcheck=16gpgcheck=17enabled=18gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key9sslverify=110sslcacert=/etc/pki/tls/certs/ca-bundle.crt11EOF
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:
Create an empty agent configuration file in the following directory:
/etc/sigsci/agent.conf
.Log in to the Signal Sciences console.
From the Sites menu, select the site that you want to give the agent access to.
Click the Agents link in the site navigation bar. The agents page appears.
Click the View agent keys button. The agent keys window appears.
Click the Copy button to copy the Agent Access Key and Agent Secret Key to your clipboard.
Navigate to the agent configuration file and paste the Agent Access Key and Agent Secret Key into the file.
accesskeyid = "AGENTACCESSKEYHERE"secretaccesskey = "AGENTSECRETACCESSKEYHERE"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.
Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.