Skip to content

Installing the Amplet2 Client

Brendon Jones edited this page Apr 13, 2021 · 13 revisions

The amplet2 client is currently packaged for Debian (Jessie, Stretch, Buster), Ubuntu (16.04 Xenial, 18.04 Bionic, 20.04 Focal) and CentOS 7. These packages are hosted at https://cloudsmith.io/~wand/repos/amp/packages/. Other Linux distributions will need to install from source.

Install Local RabbitMQ Broker (optional)

Using a local broker helps improve reliability when reporting results, and ensures that measurements are not lost if the central collector is unavailable or unreachable. Results are sent to a RabbitMQ broker running on the local machine where they are stored in a (RAM and disk backed) queue before attempting to send them to the central collector. Without the local broker the AMP client will discard results if it fails to contact the central collector.

Your distribution may package erlang and the RabbitMQ server and you are free to use those, though depending on your distribution they are probably rather outdated. You are encouraged to use up to date versions.

On Debian you can install erlang and rabbitmq-server using the official RabbitMQ instructions. The default configuration should be fine for our purposes, though you may wish to review what ports the server is listening on externally.

Install amplet2 Client

Debian / Ubuntu

The quickest way to install the amplet2-client:

sudo apt-get install curl apt-transport-https gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/wand/amp/setup.deb.sh' | sudo -E bash
sudo apt-get install amplet2-client

Or see https://cloudsmith.io/~wand/repos/amp/setup/#formats-deb for other ways to add the repository.

CentOS 7

sudo yum -y install curl
curl -1sLf 'https://dl.cloudsmith.io/public/wand/amp/setup.rpm.sh' | sudo -E bash
sudo yum install amplet2-client

Or see https://cloudsmith.io/~wand/repos/amp/setup/#formats-rpm for other ways to add the repository.

Next Steps

The client will need SSL certificates and configuration before it will run. It also has no tests scheduled to be performed.