SSH LDAP

SSH LDAP Profile

This profile monitors a UNIX LDAP Server. LDAP services are monitored remotely. Monitoring scripts are installed on the remote server and called from the GroundWork server using the SSH protocol. Please reference SSH document under GroundWork Profiles>SSH Profiles when using this profile.

Services Configuration

SERVICE - Definitions in Monarch are stored under this name.
COMMAND LINE - Service command name with arguments to be passed to the plugin.
PLUGIN COMMAND LINE - Plugin script called by Nagios for this Service.

EXTENDED INFO - The Extended Service Info definition, typically used for generating graphs.

Command lines displayed below are intended to be single line commands.

Service	Command Line	Plugin Command Line	Extended Info
ssh_process_slapd	check_by_ssh_process_slapd! 1:10!1:15	$USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_procs -w $ARG1$ -c $ARG2$ -C slapd"	percent_graph
tcp_ldap	check_ldap!3!5! dc=groundworkopensource,dc=com	$USER1$/check_ldap -t 60 -H $HOSTADDRESS$ -w "$ARG1$" -c "$ARG2$" -b "$ARG3$" -3	number_graph

Profile Package

This package includes the following files:

Profile Definitions

service-profile-ssh-ldap.xml
perfconfig-ssh-ldap.xml

Plugins Scripts on the GroundWork Server

check_ldap
check_by_ssh

Plugins Scripts on the Remote Monitored Server

check_procs

Performance Graphing Programs

percent_graph.cgi
number_graph.cgi

Installation

GroundWork Monitor includes many monitoring profiles for a variety of devices, systems and applications. Profiles already imported on a new GroundWork installation include Service Ping, SNMP Network, and SSH UNIX. The GroundWork Monitor Configuration tool is used to import updated Profiles and Profiles that require additional setup; the Profile XML file and its companion Performance Configuration definition file. Services can also be imported in addition to Service Profiles in the Profile Importer. The import process is documented under GROUNDWORK PROFILES > How to import profiles.

Implementation

This section contains detail settings used by this Profile. These parameters can be altered with the Configuration tool.

Command Parameters

Command parameters are in the Configuration Services section with the following names and default values.

ssh_process_slapd

Check for the number of slapd processes running.
$ARG1$ - A warning alert will be generated if the number of processes is outside this range. The default is 1:10.
$ARG2$ - A critical alert will be generated if the number of processes is outside this range. The default is 1:15.

tcp_ldap

Attempts to bind anonymously to the specified DN.
The default LDAP version is 2. If you wish to change this to version 3, use Configuration to add "-3" to the check_ldap command.
The check_ldap plugin help indicates v2 is default: check_ldap -~~help-2 [~~-ver2]
use ldap protocol version 2
-3 [--ver3]
use ldap protocol version 3
$ARG1$ - Warning threshold response time in seconds (default is 3 seconds).
$ARG2$ - Critical threshold response time in seconds (default is 5 seconds).
$ARG3$ - LDAP base. (For example, ou=my unit, o=my org, c=at ; default is dc=groundworkopensource,dc=com)

Performance Graphing Parameters

The following parameters are used to generate performance charts. These parameters are set using the Configuration>Performance tool in GroundWork Monitor.