Probes

A probe is a script or binary that tests whether a host fulfills prerequisites for successful completion of a job.

If a probe returns zero, the next tasks of the job are carried out. This ensures that only hosts that currently meet your requirements will run jobs.

If a probe returns 1, the job fails on the host. The probe name is displayed in the Status window as the point of failure. Now you can easily troubleshoot the host.

Example 5–4 Creating a Probe

You create a probe that tests disk space. It returns zero if there is more than the minimum defined in the script.

#!/bin/csh -f
set minimum_space=10000000000
set actual_space=\Qdf -k | awk ’{print $4}’ | tail -1\Q
if ( $actual_space > $minimum_space ) then
  echo $actual_space
  exit 0
endif
exit 1

Upload this probe. Create a job that includes the probe. The tasks are carried out if the available space of the host meets your requirements.