Install PirlApp Monitoring Agent on Linux Server

Install PirlApp Monitoring Agent on Linux Server

Overview

The PirlApp Monitoring Agent does provide system metrics like CPU usage, RAM utilization and HDD storage in use. You add your server to PirlApp 2.0 and the metrics are displayed on a monitoring dashboard.

This is not dedicated to Pirl Masternodes, you can monitor every Linux server you want. Supported Linux platform is currently:

  • Linux amd64

Besides Linux we also have builds for:

  • Windows 64-bit
  • macOS 64-bit

Most of the CentOS and Ubuntu based servers are Linux amd64 ones and this article focus on this build. The latest builds can be found on Github. https://github.com/pirl/PirlApp-Monitoring-Agent/releases

Which actions we will take?

Login to your server as root via SSH.

  1. Ensure there is the Pirl configuration folder under /etc
  2. Download the PirlApp Agent Monitoring configuration file
  3. Download the agent
  4. Make the agent executable
  5. Download service file for systemd
  6. Activate and start the PirlApp2.0 Monitoring Agent service
  7. Verify the status
  8. Modify your firewall settings

Installation

1. Make Pirl config directory if not exists. It does not override something if it´s already there.

mkdir -p /etc/pirl/

2. Download the PirlApp Agent Monitoring configuration file

wget -O /etc/pirl/pirlapp-agent.conf https://raw.githubusercontent.com/pirl/PirlApp-Monitoring-Agent/master/setup/linux/pirlapp-agent.conf

3. Download the agent

wget -O /usr/bin/pirlapp-agent https://github.com/pirl/PirlApp-Monitoring-Agent/releases/download/1.0/pirlapp-agent-linux

4. Make the agent executable

chmod +x /usr/bin/pirlapp-agent

5. Download the service file for systemd, that takes care of that the daemon is running and started after a reboot.

wget -O /lib/systemd/system/pirlapp-monitoring-agent.service https://raw.githubusercontent.com/pirl/PirlApp-Monitoring-Agent/master/setup/linux/pirlapp-monitoring-agent.service

6. Activate and start the PirlApp2.0 Monitoring Agent service

systemctl daemon-reload
systemctl enable pirlapp-monitoring-agent
systemctl start pirlapp-monitoring-agent

7. Verify the status

systemctl status pirlapp-monitoring-agent

Example output

[[email protected]](https://helpdesk.pirl.io/cdn-cgi/l/email-protection) ~ # systemctl status pirlapp-monitoring-agent
● pirlapp-monitoring-agent.service - PirlApp Monitoring Agent
Loaded: loaded (/lib/systemd/system/pirlapp-monitoring-agent.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2020-05-13 20:51:25 UTC; 30min ago
Main PID: 3486 (pirlapp-agent)
Tasks: 4 (limit: 4915)
CGroup: /system.slice/pirlapp-monitoring-agent.service
└─3486 /usr/bin/pirlapp-agent

May 13 20:51:25 pirl-dev systemd[1]: Started PirlApp Monitoring Agent.
May 13 20:51:25 pirl-dev pirlapp-agent[3486]: Starting PirlApp Agent on port :8081

[[email protected]](https://helpdesk.pirl.io/cdn-cgi/l/email-protection) ~ #

8. Modify your firewall settings

For CentOS and firewalld use:

firewall-cmd --zone=public --permanent --add-port=8081/tcp

For Ubuntu and ufw use:

ufw allow 8081

If you decide to use another tcp port via the /etc/pirl/pirlapp-agent.conf file, please keep in mind to change your firewall also.

Summary

We have the following files:

/usr/bin/pirlapp-agent # Monitoring Agent Binary
/etc/pirl/pirlapp-agent.conf # Configuration File
/lib/systemd/system/pirlapp-monitoring-agent.service # Systemd Service File

The default port is tcp/8081.

In case you need help, visit us in Discord and post your request under #support or #PirlApp-2_0 .