check_dxml_drvstate [-s hostname|ip-address] -u username, -p password -d driver-dn [-i] [--br]
[-tw warnsize -tc criticalsize [-tree treename]] [--hbw warntime --hbc criticaltime [--hbattr attr-name]]
Usage: check_dxml_drvstate [-h | --help]
Novell DirXML 1.1 and Identity Manager 2.x/3.x/4.x driver state detector plugin for Nagios and Icinga
The latest version can now be found on MonitoringExchange (see download URL). This article will NOT be updated with new versions/features anymore!
-s, --server dirxml/idm server ip or hostname, e.g. 127.0.0.1 or myserver.mydomain.org.
Leave out this option to check drivers running on the same machine as nrpe
-u, --username account used to check driver state, ldap typed syntax, e.g. cn=admin,o=novell
-p, --password passwort in cleartext (good reason to use a restriced account :-)
-d, --driver driver to check, ldap typed syntax, cn=drv_test,cn=my_driverset,o=system
-i, --invert invert return codes to monitor inactive backup servers in a driverset.
A running driver will return STATE_CRITICAL (2), a stopped one STATE_OK (0)
--tw max TAO file size before STATE_WARNING (1) will be reported
--tc max TAO file size before STATE_CRITICAL (2) will be reported.
If neither --tw and --tc are set, TAO file size checking will be disabled
--hbw max time in seconds since last heartbeat before STATE_WARNING (1) will be reported
--hbc max time in seconds since last heartbeat before STATE_CRITICAL (2) will be reported.
If neither --hbw and --hbc are set, heartbeat checking will be disabled
Please note that a schema extension and a special event transform policy on the
driver are necessary to support heartbeat checking
--hbattr ldap name of the attr that stores the heartbeat timestamp if a non-default
schema extension is used
--tree treename of the driver to be checked. only needed with TAO file size monitoring
on edir 8.8 running multiple instances (developement feature - not tested!)
tags to output for better readability in HTML display
-h, --help help screen
v1.0, 2006-04-10, initial release
v1.1, 2007-05-21, added support for IDM 3.5 and more detailed return messages
v1.2, 2007-08-01, added support for Edir 8.8
new command line option "-i" to invert return codes of running and
stopped drivers. This is meant to help monitoring usually inactive
backup servers associated to a driver set.
all changes in v1.2 based on enhancements by Rainer Brunold, many thanks!
v1.3, 2007-12-05, added TAO file size monitoring
username and driverdn must now be ldap typed (for TAO file size monitoring),
still works with nds dotted username/driverdn, but only without TAO size checks
take driver startup mode into consideration when driver is not running:
disabled -> STATE_OK,
manual -> STATE_WARNING
auto -> STATE_CRITICAL
added long command line options
v1.4, 2008-01-22, added heartbeat monitoring, requires a schema extension (aux class), driver
heartbeat and a special policy on the driver
new command line option --br to add html line breaks to text output
text output now shows warning/critical values for TAO file size and
Newer versions can be found on MonitoringExchange (see download URL) and will not be emntioned here anymore!
Howto enable heartbeat monitoring:
- extend the tree schema from nagiosHelper.ldif
- add an event transform policy to monitored driver from Heartbeat4Nagios.xml
- enable publisher heartbeat as shown in publisher-heartbeat.xml
- restart driver
- add --hbc and/or --hbw parameters for the driver to nrpe.cfg
- (optional) add the --br option for better readability in HTML display
- wait for or reschedule next service check for the driver
Schema extension example:
ice -lice.log -SLDIF -fP:\ath\to\nagiosHelper.ldif -v -DLDAP -s10.0.0.111 -p389 -dcn=admin,o=novell -w********* -B
nrpe.cfg config example:
command[dxml_srv_pwnotify]=/path/to/check_dxml_drvstate -u cn=dxcmd,o=novell -p ***** --tw 500000 --tc 1000000
--hbw 360 --hbc 900 --br -d cn=srv_pwnotify,cn=dirxml_drvset,o=novell
If you want to use a different attribute to store the heartbeat timestamp:
- edit the Heartbeat4Nagios policy to
- reflect the new attribute name
- make sure the timestamp is UTC and
- has LDAP format (e.g. 20080122123345Z = 2008-01-22 12:33:45 UTC)
- edit the line starting with "HBATTR_LDAPNAME=" in check_dxml_drvstate to match the new attribute name
- add the command line option --hbattr to nrpe.cfg
- test extensively ;-)
download url: https://www.monitoringexchange.org/inventory/Check-Plugins/Operating-Systems/Novell/check_dxml_drvstate
Disclaimer: As with everything else at Cool Solutions, this content is definitely not supported by Novell (so don't even think of calling Support if you try something and it blows up).
It was contributed by a community member and is published "as is." It seems to have worked for at least one person, and might work for you. But please be sure to test, test, test before you do anything drastic with it.