Installing Riemann on Debian

Riemann is an event processing system that makes it easy to monitor distributed systems. In this tutorial, we will learn how to install Riemann on Debian.

Prerequisites

Before we begin, you will need the following:

• A Debian system with root access
• Terminal access

Step 1: Update the system

Ensure that your Debian system is up to date by running the command below:

sudo apt update && sudo apt upgrade -y

Step 2: Install OpenJDK

Riemann is written in the Clojure programming language, which in turn runs on the Java Virtual Machine (JVM). Therefore, we need to install an appropriate version of the JVM on our system. In this tutorial, we will install OpenJDK version 8, which is the recommended version for Riemann:

sudo apt install openjdk-8-jdk -y

Step 3: Download Riemann

Next, we will download the latest version of the Riemann from their official website:

wget https://github.com/riemann/riemann/releases/download/0.3.7/riemann-0.3.7.tar.bz2

Step 4: Extract Riemann archive

Once the download is completed, we need to extract the archive:

tar xjf riemann-0.3.7.tar.bz2

Step 5: Configure Riemann

After extracting the archive, we need to modify the riemann.config file to match our requirements. You can edit the file using a text editor of your choice, consider using nano or vi.

nano riemann-0.3.7/etc/riemann.config

By default, Riemann logs messages to the console. If you want to save the messages in a file, you can uncomment and modify the line:

;logfile "/var/log/riemann.log"

Step 6: Start Riemann

With the configuration complete, we can start the Riemann service using the following command:

./riemann-0.3.7/bin/riemann

By default, Riemann listens on port 5555 for incoming connections.

Conclusion

Congratulations! We have successfully installed and started Riemann on a Debian system. You can now use Riemann to monitor distributed systems, and you can automate the start-up process of Riemann by creating a systemd service.