INSTALL.txt 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. Installing the Drupal Munin server
  2. ----------------------------------
  3. 1 Install Munin and the module
  4. ------------------------------
  5. The module is designed for Munin 1.4.4 and above. Use the normal Munin deployment for your platform.
  6. It is known to work, albeit with some warnings and limitations, on Munin 1.2.6 (Ubuntu 9.04/Karmic).
  7. On Debian/Ubuntu, you will find configuration in /etc/munin
  8. Install the module on Drupal, and enable the submodules you wish to use.
  9. Default submodules are provided to monitor Drupal core (content, users), and the
  10. PHP APC opcode cache.
  11. 2 Declare the plugin to Munin
  12. -----------------------------
  13. A sample plugin is provided with the module as plugins/munin-drupal_, which you
  14. can either use as such or customize as needed. The sample plugin uses CURL to
  15. contact your Drupal site to obtain its data.
  16. You will usually copy it to a directory in your $PATH, like /usr/local/bin, or
  17. createa link to it from that directory, like:
  18. ln -s <drupal>/sites/all/modules/munin_api/plugins/munin-drupal_ /usr/local/bin/munin-drupal_
  19. 3 Configure the plugin in Munin
  20. -------------------------------
  21. Edit the /etc/munin/plugin-conf/munin-node file to declare the plugin
  22. Add a section for your plugin. If you are using the sample plugin provided with
  23. the module, it needs to know the hostname of the site to monitor, which is not
  24. always the same site as your Munin instance.
  25. [drupal_*]
  26. env.HOST mysitename.mydomain.tld
  27. 4 Check
  28. -------
  29. Once declaration and configuration are done, you need to force munin-node to
  30. update its configuration. On Ubuntu 10.10, for instance, use:
  31. sudo service munin-node reload
  32. Assuming you enabled Drupal core and APC monitoring. You can then check the module configuration:
  33. munin-run drupal_core config
  34. munin-run drupal_apc config
  35. Then check their data:
  36. munin-run drupal_core
  37. munin-run drupal_apc
  38. 5 Modify configuration
  39. ----------------------
  40. Any time you enable/disable a Munin submodule or modify its settings, you will
  41. need to force a munin-node configuration reload so that the server knows what to
  42. plot.