|
|
@@ -0,0 +1,83 @@
|
|
|
+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](https://pingpanel.zweiernet.ch/pingpanel_0.9.8.tar.gz)
|
|
|
+\- Debian installer: [https://pingpanel.zweiernet.ch/pingpanel_0.9.8_all.deb](https://pingpanel.zweiernet.ch/pingpanel_0.9.8_all.deb)
|
|
|
+
|
|
|
+
|
|
|
+**_Requirements_**:
|
|
|
+> python3-tornado >= 6.0 ([https://www.tornadoweb.org/en/stable/](https://www.tornadoweb.org/en/stable/))
|
|
|
+> fping >= 5.0 ([https://fping.org/](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.
|
|
|
+
|
|
|
+
|
