INSTALL.txt 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. * PingPanel INSTALL.txt (C) 2024 by Siegrist(SystemLösungen) <pingpanel@zweiernet.ch>
  2. INSTALL
  3. ========
  4. On Debian/Ubuntu related systems install with:
  5. ----------------------------------------------
  6. - #dpkg -i pingpanel_<version>_all.deb
  7. You may encounter problems like:
  8. dpkg: dependency problems prevent configuration of pingpanel:
  9. pingpanel depends on python3-tornado (>= 6.0); however:
  10. Package python3-tornado is not installed.
  11. pingpanel depends on fping (>= 5.0); however:
  12. Package fping is not installed.
  13. Then, check the dependencies with:
  14. - #apt-get check
  15. and install the dependencies with:
  16. - #apt --fix-broken install
  17. Afterwards the pingpanel package ist fully instsalled under /opt/PingPanel/.
  18. The daemon start file pingpanel in the init.d/ directory is in the standard LSB format for SysV systems.
  19. So, on systemd related systems at least use:
  20. - #systemctl daemon-reload
  21. After all, start the PingPanel Daemon:
  22. - #service pingpanel start
  23. On other systems using the tar-archive:
  24. ---------------------------------------
  25. - #cd /opt
  26. - #tar xvfz pingpanel_<version>.tar.gz
  27. Requirements:
  28. - python3-tornado >= 6.0 (https://www.tornadoweb.org/en/stable/)
  29. - fping >= 5.0 (https://fping.org/)
  30. The directory ./etc.example contains startup file in ./init.d and a default pingpanel file under ./default.
  31. If you want to use a different installation directory, you must adjust the default file
  32. and/or the init.d startup script to the appropriate pathes and names.
  33. After all, start the PingPanel Daemon:
  34. - #/etc/init.d/pingpanel start
  35. Configuration
  36. -------------
  37. The configuration is made in the config.cfg file located in the installation directory.
  38. All parameters are documented in this file.
  39. If you want to use a name other than config.cfg, you can specify this in the /etc/default/pingpanel file
  40. or with the -c <filename> param to the PingPanel.py script.
  41. All Messages are written to the file /var/log/pingpanel.log, unless
  42. you define a different name in /etc/default/pingpanel.
  43. Upgrade
  44. ========
  45. On Debian/Ubuntu related systems upgrade with:
  46. ----------------------------------------------
  47. - #dpkg -i pingpanel_<version>_all.deb
  48. The configuration files (config.cfg and /etc/default/pingpanel) will be preserved.
  49. New files will be given the prefix .dpkg-NEW.
  50. Adjust your config.cfg file with the new paramameters from .dpkg-NEW.
  51. Restart the PingPanel Daemon.
  52. On other systems using the tar-archive:
  53. ---------------------------------------
  54. Install the tar-file in a new empty directory and then copy the relevant files to your active install-dir.
  55. sigi