# $Id$

ReadMe for monitoring-tools (montools)


Introduction
============

The monitoring-tools are yet another script collection to help admins
monitor local resources.


Configuration
=============

To configure details, edit /etc/montools/montools.conf

See /etc/montools/montools.conf.template for reference infos.


To activate regular checks, edit /etc/cron.d/montools.template

See /etc/cron.d/montools.template for reference proposals.


Common command options
======================

  -d    sets verbosity to 3 (DEBUG)
  -q    sets verbosity to 0 (quiet)
  -v    raises verbosity by 1


Commands overview
=================

* mt-check-discspace
Checks if the usage of any disc partition is over the configured treshholds.
Treshholds are configured by changing  DISKUSAGE_* in montools.conf

* mt-check-3ware-raid
Uses tw_cli from 3Ware to check hardware RAID status.
Configurable number of DISKS_IN_RAID defaults to 2.

* mt-check-ipmi-sensors
Uses impi-sensors check power supply and hardware RAID status.
Configurable number of POWERSUPPLIES defaults to 2.
Configurable number of IPMISENSORS defaults to 0.
Setting a config value to 0 to disables the regarding check.

* mt-check-megaraid-storcli
Uses storcli from Avago (or LSI?) to check hardware RAID status.
Configurable number of DISKS_IN_RAID defaults to 2.

* mt-check-megaclisas-status
Uses megaclisas-status from http://hwraid.le-vert.net/wiki/DebianPackages
to check hardware RAID status.
Configurable number of DISKS_IN_RAID defaults to 2.

* mt-check-omsa-power
Uses omreport from Dell's OMSA suite to check power supply status.
Configurable number of POWERSUPPLIES defaults to 2.

* mt-check-omsa-raid
Uses omreport from Dell's OMSA suite to check hardware RAID status.
Configurable number of DISKS_IN_RAID defaults to 2.

* mt-check-ram
Read and edit 'RAM stuff' section of montools.conf before usage.

* mt-check-ro-mounts
Checks for unexpected readonly-mounts of important file systems.

* mt-check-swraid
Checks /proc/mdstat for bad signs about software RAID.

* mt-log-load
Logs load to /var/log/montools/YYYY-MM-DD.log
If log reaches configurable WARNINGLOAD, extensive infos are collected in
/var/log/montools/loadreasons/YYYY-MM-DD_hh:mm_$curload

