RIPE Atlas is a global network of probes that measure Internet connectivity and reachability, providing an unprecedented understanding of the state of the Internet in real time.
This project contains the probe code that powers software probes.
We release binary packages for the amd64 variants of Debian 11 & 12, (Oracle) Enterprise Linux 8 & 9, and arm64 variant of Raspberry Pi OS 12.
The source code also allows for building of an OpenWRT 22.03 package.
# Download: Debian 11 & Debian 12 & Raspberry Pi OS 12
ARCH=$(dpkg --print-architecture)
CODENAME=$(. /etc/os-release && echo "$VERSION_CODENAME")
REPO_PKG=ripe-atlas-repo_1.5-3_all.deb
wget https://ftp.ripe.net/ripe/atlas/software-probe/debian/dists/"$CODENAME"/main/binary-"$ARCH"/"$REPO_PKG" https://github.com/RIPE-NCC/ripe-atlas-software-probe/releases/latest/download/CHECKSUMS
grep -q "$(sha256sum "$REPO_PKG")" CHECKSUMS && echo "Success: checksum matches" || ( printf "\n\033[1;31mError: checksum does not match\033[0m\n\n"; rm "$REPO_PKG" )
# Install: Debian 11 & Debian 12 & Raspberry Pi OS 12
sudo dpkg -i "$REPO_PKG"
sudo apt update
sudo apt-get install ripe-atlas-probe# Download: Enterprise Linux 8 & Enterprise Linux 9
EL_VER=$(. /etc/os-release && echo $PLATFORM_ID | cut -d':' -f2)
REPO_PKG=ripe-atlas-repo-1.5-3."$EL_VER".noarch.rpm
curl -fO -LfO https://ftp.ripe.net/ripe/atlas/software-probe/"$EL_VER"/noarch/"$REPO_PKG" https://github.com/RIPE-NCC/ripe-atlas-software-probe/releases/latest/download/CHECKSUMS
grep -q "$(sha256sum "$REPO_PKG")" CHECKSUMS && echo "Success: checksum matches" || ( printf "\n\033[1;31mError: checksum does not match\033[0m\n\n"; rm "$REPO_PKG" )
# Install: Enterprise Linux 8 & Enterprise Linux 9
sudo rpm -Uvh "$REPO_PKG"
sudo dnf install ripe-atlas-probeFor other platforms, please refer to the building instructions.
Currently there are three runtime configuration options available.
To use them, create the file /etc/ripe-atlas/config.txt and add a line per desired configuration setting.
| Configuration | Description | Default |
|---|---|---|
RXTXRPT |
Sending interface traffic statistics as Atlas measurement results | RXTXRPT=no |
TELNETD_PORT |
TCP port used for telnetd | TELNETD_PORT=2023 |
HTTP_POST_PORT |
TCP port used for httppost | HTTPD_PORT=8080 |
For officially supported and provided packages, use your system's package manager to upgrade the package:
- Debian:
apt update && apt upgrade - Enterprise Linux:
dnf upgrade
Follow the standard installation instructions to upgrade to the latest version.
See the FAQ for more information about the upgrade process and changes.
Note
We have tested the upgrade process thoroughly, but still recommend backing up your probe key and configuration files before upgrading.
The public key is stored in /etc/ripe-atlas/probe_key.pub. Use it to register your probe at https://atlas.ripe.net/apply/swprobe/.
The software probe uses TCP ports 2023 and 8080 internally. If another service is using these ports then the probe will not function correctly. To avoid conflicts, runtime configuration options can be used to make the probe use different port numbers.
Starting with release 5080 (September 2022), the package will no longer automatically update.
The intent of this decision is to conform to operational practices and to make deployment and maintenance easier on hosts (and the Atlas team). If you wish to keep automatically updating your software probe, please install the automatic update package of your choice.
Suggested solutions available are yum-cron, dnf-automatic or unattended-upgrades.
To upgrade from 5080 on Debian, or on older non-repo Enterprise Linux versions, you can follow the standard installation instructions.
Upgrading from atlasswprobe will attempt to migrate existing probe keys and configuration, while existing state in /var/altas-probe/ will be removed, as the big change in 5090 was towards a more FHS compliant structure, moving away from /var/atlas-probe/.
Due to the changes, even though we have tested the upgrade process thoroughly, we still recommend backing up your probe key and configuration files before upgrading.
Caution
Removing atlasswprobe will remove data within /var/atlas-probe, including your key and configuration
As such, install the new version instead of removing the old one and installing the new one. The old version will automatically be removed.
Tip
If you did remove the old version, your original key has been deleted and a new one has been generated.
Your new key will have been printed during the installation, but you can also find it in /etc/ripe-atlas/probe_key.pub.
To update your key, go to your probes page on atlas.ripe.net, click on the respective probe ID, and click on "Manage". On this page, you can update the SSH key of your probe.