Our Agent package is distributed in our package repositories. If you haven’t already, configure our repository on your system.
Limitations and considerations
When working with the Signal Sciences agent, keep the following things in mind:
- Per our agent end-of-support policy, we support agent versions that are under two years old, and on a quarterly cadence, we deprecate and no longer support agent versions that are older than two years.
- Check the Agent Release Notes to see what’s new in the agent.
Working with the agent auto-update service
The agent auto-update 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.
Important: This information is part of a beta release. For additional details, read our product and feature lifecycle descriptions.
Limitations and considerations
When setting up the agent auto-update service, keep the following in mind:
- The agent auto-update service is only compatible with agents on Debian 8 or higher, Red Hat CentOS 7 or higher, and Ubuntu 18.04 or higher.
- The agent auto-update service updates an agent by uninstalling the old package version and installing the latest version. Due to the agent’s brief downtime during upgrade, we recommend scheduling the update when your website or web application receives low traffic.
Enable the agent auto-update service
Once the agent is installed, you can enable the agent auto-update service:
-
Enable the agent auto update service.
sudo systemctl enable --now sigsci-agent-update.timer
-
Optionally, customize the agent auto update timer. By default, the check for new versions is performed on the second Thursday of the month.
sudo systemctl edit sigsci-agent-update.timer [Timer] OnCalendar= OnCalendar=Thu *-*-08,09,10,11,12,13,14 03:00:00 RandomizedDelaySec=8h
Disable the agent auto-update service
To disable the agent auto-update service, run the following command:
sudo systemctl disable --now sigsci-agent-update.timer
Upgrading the Agent on Ubuntu-Debian systems
To manually upgrade agents on Ubuntu or Debian systems, follow these steps:
-
Upgrade the Agent package
sudo apt-get update
sudo apt-get install sigsci-agent
-
Restart the Agent After successfully upgrading the package, restart your agent:
Ubuntu 14.04 and lower:
sudo restart sigsci-agent
Ubuntu 15.04 or higher:
sudo systemctl start sigsci-agent
Upgrading the Agent on Red Hat-CentOS systems
To manually upgrade agents on a Red Hat CentOS systems, follow these steps:
-
Upgrade the Agent Package
yum -q makecache -y --disablerepo=* --enablerepo=sigsci_*
yum install sigsci-agent
-
Restart the Agent
RHEL 6/CENTOS 6
Under EL6, the Agent is managed via upstart. Restart the agent by running:
sudo restart sigsci-agent
RHEL 7/CENTOS 7
From EL7, Red Hat have migrated to SystemD as their default process supervisor. Restart the agent by running:
sudo systemctl restart sigsci-agent
Upgrading the Agent on Windows systems
To manually upgrade agents on Windows systems, follow these steps:
-
Upgrade the Agent Package
Download and install the latest agent MSI.
Download: Windows MSI
-
Restart the Agent Service
From the UI
- Open services.msc
- Select “Signal Sciences Agent”
- Right click and select restart
From the CLI
- Open up a dos prompt
- run
net stop sigsci-agent
- run
net start sigsci-agent