Table of Contents

Raspberry Pi monitoring

Hardware Components

Raspberry

A Raspberry device is a reduced-plate computer, single-plate computer or low-cost single-plate computer (SBC). Its official operating system is an open source version adapted from Debian, called Raspbian.

Software

Pandora FMS image for Raspberry

The distributed image is based on the Raspbian operating system. It contains the agent, the satellite, the eHorus client, the packages to install a NetFlow probe and all their dependencies.

Installation

Flash image onto an SD card

Download Pandora FMS official image for Raspberry

The initial step for installing it is to download the official Pandora FMS image for raspberry from the official download page:

Once the .img file is downloaded, flash it onto your SD card of at least 4gb.

Download Etcher

To flash the image, use the Etcher software that can be downloaded at

It works similarly on both Windows® and Linux®.

Process for flashing the image on the SD card

Insert the SD card into your computer which should have a special port for those kinds of devices. Execute Etcher.

Click Select image. This will open the file explorer to select the previously downloaded Pandora FMS image.

Select the SD card inserted in the computer. If the SD card is the one that appears by default, leave it as it is and if not, click Change and select the desired SD card.

Click Flash! to mount the image on the card.

Then, remove the card securely according to your OS instructions.

Hardware connection

Thorough this step, all the components will be connected to power up the Raspberry:

Network configuration

The monitor will display how the device starts and an installer where you can select which interface you wish to configure.

DHCP

Select Eth0 to configure the wired network interface:

It will ask whether you want to change the Eth0 interface settings. Click Yes

Select DHCP if there is a DHCP server in the network

Then, a message will appear saying that the wired network has been correctly configured.

Static

Select IP STATIC if you wish to configure the wired interface manually.

Enter the Raspberry's static IP.

Enter the network's Gateway.

Enter the network mask.

Enter the public DNS.

You will get a message that the configuration has been successfully completed.

Wireless DHCP

Select Wlan0 to configure the wireless network interface

It will ask whether you wish to change the Wlan0 interface configuration. Click Yes.

Select DHCP if there is a DHCP server in the network.

Choose the name of the access point from the provided list. Enter the password of the access point.

You will get a message that the configuration was successful.

Wireless Static

Agent/Satellite Configuration

Agent

Satellite

Postinstallation

eHorus client Configuration

Edit the file with the nano text editor:

/etc/ehorus/ehorus.conf

Replace the eh_user token with your eHorus user. In line #password secret delete the number that indicates the biginning of the comment (uncomment the line) and replace the word “secret” by a password to access your agent from eHorus.

To see the graphical environment, install the x11vnc dependency:

apt-get install x11vnc

Start the service with:

/etc/init.d/ehorus_agent_daemon start

NetFlow Probe

Its operation is based on the use of several components:

Pandora FMS uses an OpenSource tool called nfcapd to process all NetFlow traffic. This daemon is automatically launched by Pandora FMS server. This system stores data in binary files, in a certain location. Install nfcapd on your system before working with NetFlow in Pandora FMS. The default nfcapd daemon listens on port 9995/UDP by default, so keep this in mind if you have firewalls to open this port and when configuring NetFlow probes.

NetFlow Probe by software

If you do not have a NetFlow router, but your traffic “goes” through a Linux system, you can install a software that works as a probe and sends NetFlow traffic information to the collector. In Linux, there is a program called fprobe that captures traffic and forwards it to a NetFlow server. With that you can generate NetFlow traffic, from all network traffic going through your interfaces.

First, install fprobe:

apt-get install fprobe

It will ask which interface must be monitored and to which ip:port the information must be sent to. In case it does not ask, run the following command:

/usr/sbin/fprobe -i <interface_moniteur> -fip <ip_collector>><port>

In the following example, all traffic from the eth0 interface will be sent to the NetFlow collector listening on port 9995 of IP 192.168.70.185:

/usr/sbin/fprobe -i eth0 -fip 192.168.70.185:9995

Once traffic is generated, you can see the statistics of this traffic on the NetFlow collector with this command:

nfdump -R /var/spool/pandora/data_in/netflow

NetFlow must be enabled to be accessible from the Operation and Administration menus: Enable NetFlow

Once NetFlow is configured, restart Pandora FMS server to boot the nfcapd server. It must be properly installed before attempting to start it. Check the server logs for any questions.

Netflow Probe with Port Mirroring

Explained in section: Netflow Port Mirroring

Go back to Pandora FMS documentation index