INSTALL 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. Installation notes
  2. ==================
  3. Real quick
  4. ==========
  5. make && make install && vi /etc/monmux.conf /etc/mon.conf &&
  6. ~mon/monmux/c_monrrds.sh all &&
  7. /usr/local/libexec/monmux &&
  8. /usr/local/libexec/mon
  9. Slightly less quick but with pretty pictures
  10. ============================================
  11. - Install rrdtool. cd /usr/ports/net/rrdtool && make install should do the
  12. trick.
  13. - Check Makefile.inc for settings. Things to watch out for are
  14. + PREFIX = Where does the installation tree start. Defaults to
  15. '/usr/local'.
  16. + BINDIR = Where should the daemons be put, relative to $PREFIX. Defaults
  17. to 'libexec'.
  18. + MANDIR = Where should the manuals be installed, relative to
  19. $PREFIX. Defaults to 'man'.
  20. + SHRDIR = Where are the example configurations to be installed. Defaults
  21. to 'share/mon'.
  22. - Run make && make install
  23. - Create an '/etc/mon.conf'. Note that there is an example configuration in
  24. $PREFIX/$SHRDIR.
  25. - Create a monmux.conf on the gatherer host. You can specify alternative
  26. locations than '/etc/monmux.conf' using 'monmux -f <monmux.conf>'.
  27. - Create the rrd files where the incoming mon data is to be
  28. stored. $PREFIX/$SHRDIR/c_monrrds.sh is your friend. Note that 'mon2web'
  29. expects an '.../machine/*.rrd' style directory structure.
  30. - Fire up mon, monmux. Check system logs for any failures.
  31. - only if you need the webinterface: mon2web is not installed anywhere by
  32. default. Copy the files to a convenient apache directory and modify the
  33. mon2web/datasources.inc to reflect your filelocations. Note that it uses php,
  34. so you may need to (cd /usr/ports/www/php4; make install).
  35. Installing mon on many machines
  36. ===============================
  37. - Copy the mon-version.tar.gz to /usr/ports/distfiles/
  38. - Use the ports directory to create a mon package.
  39. cd ~mon/ports/mon
  40. make package
  41. - The binary package can be found at
  42. /usr/ports/packages/<arch>/All/mon-2.0.tgz
  43. - You can transfer the resulting package to many machines and install it by
  44. pkg_add it.
  45. This package is an OpenBSD application. You might be able to make monmux and
  46. mon2web run on POSIX compliant unixes, but the monitoring application itself
  47. (mon) is OpenBSD specific.
  48. Willem Dijkstra <wpd@xs4all.nl>
  49. $Id: INSTALL,v 1.1 2002/08/16 13:55:42 dijkstra Exp $