Friday 1 July 2011

Nagios - Check Backup Exec

****************************************************************
* check_be - Nagios plugin for Symantec BackupExec for Windows *
* by Toussaint OTTAVI (t.ottavi@medi.fr)                       * 
****************************************************************

This is a windows executable, to be run on Windows servers where BackupExec
is installed. It will process all the job history files, find the most recent
occurrence of a specified job name, then it will return the current status of
this job. It can also return a 'warning' or 'critical' status if the last job
found is older than the specified amount of days.


1/ HOW TO USE THIS SOFTWARE
---------------------------

Run check_be.exe in a Windows console, with the following syntax :

  check_be "path of XML files" "Name of the backup job"
  
- "Path of XML files" is the location where BackupExec puts its log files in
  XML format. Default locations for these files are :
    v10:  c:\program files\veritas\backup exec\nt\data
    v12: c:\Program Files\Symantec\Backup Exec\Data
  
- "Name of the backup job log" is the name of the job you want to check. It's
  case independant.

Possible switches are :

-h : Shows brief syntax help

-d : Writes detailed debug information. This can help determining what's wrong
     in case of any problem.
     
-c<n> : Return 'critical' state if the last occurrence of the job is older 
        than <n> days. This can help to determine if a scheduled job is 
        disabled, locked, paused, or any other reason.

-w<n> : Same, but for 'warning' state

Example of use :

check_be  "c:\Program Files\Symantec\Backup Exec\Data" "My tape backup" -w1 -c3

Return states are :
  'ok' for BackupExec status 2 and 19
  'critical' for BackupExec status 0,1,6,7 and 21
  'warning' for any other BackupExec status 
  'unknown' if it can not determine the BackupExec job status, for any reason.
  

2/ HOW TO USE IT WITH NAGIOS
----------------------------

2.1/ ON THE MONITORED SERVER

You should have nsclient++ installed. In your 'nsc.ini' file, you must declare
an external script like this: 

[NRPE Handlers]
;# COMMAND DEFINITIONS
check_be=check_be.exe "c:\program files\veritas\backup exec\nt\data\" "JobName" -w1 -c3
 
 
2.2. ON THE NAGIOS SERVER 

Define a service template :

define service{
  name                  template-backupexec
  use                   generic-service
  service_description    BackupExec Job Check    ; default display name in Nagios
  check_command         check_nrpe!-c check_be  ; same name as in the nsclient++ nsc.ini command definition 
  normal_check_interval 60                      ; your check intervals here
  retry_check_interval  60
  register 0                                    ; this is a template
  }
  
Then, in your object definition, add the following :

define service {
  use                 template-backupexec
  service_description BackupExec - Daily DAT backup   ; specific display name, if you need
  host_name           MYHOST
  } 

No comments:

Post a Comment