Skip to content

Housekeeping

Peering Manager performs a set of nightly housekeeping tasks:

  • Clearing expired authentication sessions from the database
  • Deleting changelog records older than the configured retention time
  • Deleting job result records older than the configured retention time
  • Checking for new Peering Manager releases (if RELEASE_CHECK_URL is set)

Tip

Housekeeping is scheduled automatically by the rqworker process as a system job. The instructions below only apply if you prefer to drive it from an external scheduler.

The same logic is also available as the housekeeping management command for ad-hoc invocation, or via the shell script provided in the contrib repository.

Scheduling (Legacy)

Using Cron

This script can be linked from your cron scheduler's daily jobs directory (e.g. /etc/cron.daily) or referenced directly within the cron configuration file.

sudo curl -s -o /etc/cron.daily/peering-manager_housekeeping 'https://raw.githubusercontent.com/peering-manager/contrib/main/cron/peering-manager_housekeeping.sh'
sudo chmod a+x /etc/cron.daily/peering-manager_housekeeping

Note

On Debian-based systems, be sure to omit the .sh file extension when linking to the script from within a cron directory. Otherwise, the task may not run.

Using Systemd

First, download the systemd service and timer files in the /etc/systemd/system/ directory:

sudo curl -s -o /etc/systemd/system/peering-manager_housekeeping.service 'https://raw.githubusercontent.com/peering-manager/contrib/main/systemd/peering-manager_housekeeping.service'
sudo curl -s -o /etc/systemd/system/peering-manager_housekeeping.timer 'https://raw.githubusercontent.com/peering-manager/contrib/main/systemd/peering-manager_housekeeping.timer'

You can also download them in another directory and use symbolic links.

Then, reload the systemd configuration and enable the timer to start automatically at boot:

sudo systemctl daemon-reload
sudo systemctl enable --now peering-manager_housekeeping.timer

Check the status of your timer by running:

sudo systemctl list-timers --all

This command will show a list of all timers, including your peering-manager_housekeeping.timer. Make sure the timer is active and properly scheduled.