Installing the agent on Alpine Linux

This guide explains how to install the Signal Sciences agent on Alpine Linux. This guide includes instructions for Alpine running in a Docker container, virtual machine (VM), or bare-metal server.

Prerequisites

• If Alpine is being run in a Docker container, you must start the container before following these instructions.
• You must have permission to view agent keys in the Signal Sciences web interface.

Add the package repository

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

If you are running Alpine in a Docker container, run the following script to add the package repository:

1$ apk update
2$ apk add wget
3$ wget -q https://apk.signalsciences.net/sigsci_apk.pub ; mv sigsci_apk.pub /etc/apk/keys/
4$ echo https://apk.signalsciences.net/3.17/main | tee -a /etc/apk/repositories && apk update

If you are running Alpine in a VM or on a bare-metal server, run the following script to add the package repository:

1$ sudo apk update
2$ sudo apk add wget
3$ sudo wget -q https://apk.signalsciences.net/sigsci_apk.pub ; sudo mv sigsci_apk.pub /etc/apk/keys/
4$ sudo echo https://apk.signalsciences.net/3.17/main | sudo tee -a /etc/apk/repositories && sudo apk update

Verify the downloaded key

After you've installed the Alpine package repository, verify the downloaded key contains the proper key by running the following command:

$ openssl rsa -pubin -in /etc/apk/keys/sigsci_apk.pub -text -noout

If the downloaded key contains the proper key, the expected output looks like the following:

1Public-Key: (2048 bit)
2Modulus:
3    00:bb:23:1a:ef:0d:61:8f:8d:55:aa:ad:01:84:43:
4    6c:46:42:42:ab:5b:ec:4e:4b:e2:e6:b6:e7:3d:45:
5    b7:96:70:fe:16:95:aa:09:f1:90:82:40:e4:30:2b:
6    9e:2a:03:e9:74:63:55:66:f0:db:8c:b9:5b:f8:45:
7    5f:ad:4e:7a:14:da:02:83:c2:36:a0:84:74:a0:bb:
8    f9:3f:03:c8:fe:80:6a:95:0c:17:22:55:40:30:18:
9    51:d9:30:db:7c:1b:d0:06:4e:a9:51:1a:31:0e:33:
10    f0:6e:ad:53:98:31:a5:ac:a3:a1:44:83:72:a1:ca:
11    78:e3:24:70:ab:7a:0e:66:32:3b:f6:c9:90:16:dc:
12    89:d0:52:7a:50:a8:f8:59:0a:34:12:2e:85:11:f5:
13    80:0d:d4:7d:a7:7b:3b:d7:d9:1e:28:ed:bb:f7:08:
14    2e:9f:73:a5:23:d8:53:b4:7e:21:dd:ae:92:4a:d0:
15    5b:86:21:9c:82:05:21:29:eb:c1:ab:91:cd:1a:7b:
16    95:6d:43:d3:1a:a9:62:2b:b0:95:9e:cf:18:82:64:
17    02:f9:38:7e:7f:47:9f:d9:f3:ac:fd:2c:30:ff:75:
18    b1:11:27:1c:7a:d6:ca:04:19:f8:31:80:42:e9:4a:
19    0d:ab:d5:b8:ad:f2:35:31:a5:3f:98:19:99:fc:29:
20    e8:4f
21Exponent: 65537 (0x10001)

Install and configure the Signal Sciences Agent package

Now that you've downloaded the Alpine package repository and verified that you have the proper key, you can install the Signal Sciences Agent package.

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

$ sudo apk add 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 are running Alpine in a Docker container, run the following command to start the Signal Sciences agent:

$ /usr/sbin/sigsci-agent

If you are running Alpine in a VM or on a bare-metal server, run the following command to allow the agent to start on reboot:

$ sudo rc-update add sigsci-agent default

Then, start the agent by running any of the following commands:

1$ sudo service sigsci-agent start
2$ sudo rc-service sigsci-agent start
3$ sudo /etc/init.d/sigsci-agent start

Next steps

Explore our module options and install the Signal Sciences module.