INSTALL 2.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  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. - Decide if you want to monitor disk usage. Define KVM as an environment
  23. variable before you run make if you do.
  24. - Run make && make install
  25. - Create an '/etc/mon.conf'. Note that there is an example configuration in
  26. $PREFIX/$SHRDIR.
  27. - Create a monmux.conf on the gatherer host. You can specify alternative
  28. locations than '/etc/monmux.conf' using 'monmux -f <monmux.conf>'.
  29. - Create the rrd files where the incoming mon data is to be
  30. stored. $PREFIX/$SHRDIR/c_monrrds.sh is your friend. Note that 'mon2web'
  31. expects an '.../machine/*.rrd' style directory structure.
  32. - Fire up mon, monmux. Check system logs for any failures.
  33. - only if you need the webinterface: mon2web is not installed anywhere by
  34. default. Copy the files to a convenient apache directory and modify the
  35. mon2web/datasources.inc to reflect your filelocations. Note that it uses php,
  36. so you may need to (cd /usr/ports/www/php4; make install).
  37. Installing mon on many machines
  38. ===============================
  39. - Copy the mon-version.tar.gz to /usr/ports/distfiles/
  40. - Use the ports directory to create a mon package.
  41. cd ~mon/ports/mon
  42. make package
  43. - The binary package can be found at
  44. /usr/ports/packages/<arch>/All/mon-version.tgz
  45. - You can transfer the resulting package to many machines and install it by
  46. pkg_add it.
  47. This package is an OpenBSD application. You might be able to make monmux and
  48. mon2web run on POSIX compliant unixes, but the monitoring application itself
  49. (mon) is OpenBSD specific.
  50. Willem Dijkstra <wpd@xs4all.nl>
  51. $Id: INSTALL,v 1.3 2002/08/31 15:54:57 dijkstra Exp $