Deploying Reactive Agents

Installing Reactive Agents

LogSail Reactive Agents are compiled for many UNIX flavors. These agents configure themselves with our APIs using our protocol, Perspicacity.

Installing the Agent

CentOS

Install Repo File

sudo yum install -y yum-utils
sudo yum-config-manager \
    --add-repo \
    https://repo.logsail.com/linux/centos/logsail-ra.repo

Install Agent

sudo yum install lsagent

RedHat

Install Repo File

sudo yum install -y yum-utils
sudo yum-config-manager \
    --add-repo \
    https://repo.logsail.com/linux/rhel/logsail-ra.repo

Install Agent

sudo yum install lsagent

Fedora

Install Repo File

sudo yum install -y yum-utils
sudo yum-config-manager \
    --add-repo \
    https://repo.logsail.com/linux/fedora/logsail-ra.repo

Install Agent

sudo yum install lsagent

Debian

Install APT Package Index

sudo apt-get update && apt-get install ca-certificates curl gnupg lsb-release

Adding LogSail's GPG Key

curl -fsSL https://repo.logsail.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/logsail-keyring.gpg

Setup the Stable Repository

This command will detect the architecture and Debian release so the proper agent package is installed on the host.

echo \
 "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/logsail-keyring.gpg] https://repo.logsail.com/linux/debian \
 $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/logsail-ra.list > /dev/null

Install Agent

sudo apt update && apt install lsagent

OpenBSD

LogSail Reactive Agent for OpenBSD7.3

It is expected that both curl and python3 be pre-installed on the target system before attempting the agent install.

Adding Public Key for Signature Verification

curl https://repo.logsail.com/OpenBSD/logsail-obsd73-pkg-key.pub --output /etc/signify/logsail-obsd73-pkg-key.pub

Configuring Package Path

export PKG_PATH=https://repo.logsail.com/OpenBSD/7.3/packages/amd64/

Install Agent

pkg_add lsagent

Setting Token File

Create and copy a new agent token from the LogSail console and write the token to the token file.

echo -n '<AGENT TOKEN>' > /etc/lsagentd/token.rt

Start and Enable Reactive Agent for Linux

On Linux, reactive agents are managed by the systemd utility.

sudo systemctl enable lsagent && systemctl start lsagent

Start and Enable Reactive Agent for OpenBSD

On OpenBSD, reactive agents are managed by the rc utility.

rcctl start lsagentd && rcctl enable lsagentd