pingpanel/README.md

PingPanel

PingPanel monitors devices in the network using ICMP echo requests and gives you a compact and graphical overview of the current accessibility of all these hosts in real time. Unlike other network monitoring tools, PingPanel is neither a service monitoring tool nor does it record any data for analysis. Instead, it merely provides an overview of the current availability of the devices to be monitored and their RTT (Round-Trip Time).

Website:

[https://pingpanel.zweiernet.ch/](https://pingpanel.zweiernet.ch/)

Download:
- tar-archive: https://pingpanel.zweiernet.ch/pingpanel_0.9.8.tar.gz
- Debian installer: https://pingpanel.zweiernet.ch/pingpanel_0.9.8_all.deb

Requirements:

python3-tornado >= 6.0 (https://www.tornadoweb.org/en/stable/)
fping >= 5.0 (https://fping.org/)

Installation

On Debian/Ubuntu related systems install with:
dpkg -i pingpanel_<version>_all.deb

Check the dependencies with:
apt-get check

and install the dependencies with:
apt --fix-broken install

Afterwards the pingpanel package ist fully instsalled under /opt/PingPanel/.

On other systems using the tar-archive:

cd /opt
tar xvfz pingpanel_<version>.tar.gz

Usage

The directory etc.example/ contains startup file in init.d/ and a default pingpanel file under default/.
If you want to use a different installation directory, you must adjust the default file and/or the init.d startup script to the appropriate pathes and names.

The daemon start file pingpanel in the init.d/ directory is in standard LSB format for SysV systems. So, on systemd related systems at least use:
systemctl daemon-reload

After all, start the PingPanel Daemon:
service pingpanel start

Configuration

The configuration is made in the config.cfg file located in the installation directory. All parameters are documented in this file.
If you want to use a name other than config.cfg, you can specify this in the /etc/default/pingpanel file or using the -c <filename> parameter to the PingPanel script.

All Messages are written to the file /var/log/pingpanel.log, unless you define a different name in /etc/default/pingpanel.

Upgrade

On Debian/Ubuntu related systems upgrade with:

dpkg -i pingpanel_<version>_all.deb

The configuration files config.cfg and /etc/default/pingpanel will be preserved. New files will be given the prefix .dpkg-NEW. Adjust your config.cfg file with the new paramameters from .dpkg-NEW.

Restart the PingPanel Daemon.

On other systems using the tar-archive:

Unpack the tar-file in a new empty directory and then copy the relevant files to your active install-dir.