search close

Upgrading the Agent

access_time Updated Mar 24, 2023

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:

  1. Enable the agent auto update service.

    sudo systemctl enable --now sigsci-agent-update.timer
    
  2. 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:

  1. Upgrade the Agent package

    sudo apt-get update

    sudo apt-get install sigsci-agent

  2. 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:

  1. Upgrade the Agent Package

    yum -q makecache -y --disablerepo=* --enablerepo=sigsci_*

    yum install sigsci-agent

  2. 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:

  1. Upgrade the Agent Package

    Download and install the latest agent MSI.

    Download: Windows MSI

  2. Restart the Agent Service

    From the UI

    1. Open services.msc
    2. Select “Signal Sciences Agent”
    3. Right click and select restart

    From the CLI

    1. Open up a dos prompt
    2. run net stop sigsci-agent
    3. run net start sigsci-agent