← Back to branch summary

~ubuntu-branches/ubuntu/precise/nagios-plugins/precise-proposed

« back to all changes in this revision

Viewing changes to contrib/check_vcs.pl

  • Committer: Bazaar Package Importer
  • Author(s): Guido Trotter
  • Date: 2004-06-15 15:37:48 UTC
  • Revision ID: james.westby@ubuntu.com-20040615153748-pq7702qdzghqfcns
Tags: upstream-1.3.1.0
Import upstream version 1.3.1.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
contrib/check_vcs.pl
 
1
#!/usr/bin/perl
 
2
#
 
3
# Veritas Cluster System monitor for Nagios.
 
4
# Written by Aaron Bostick (abostick@mydoconline.com)
 
5
# Last modified: 05-22-2002
 
6
#
 
7
# Usage: check_vcs {-g <vcs_group> | -r <vcs_resource> } -s <vcs_system> [-n]
 
8
#
 
9
# Description:
 
10
#
 
11
# This plugin is just a perl wrapper to the vcs commands hagrp and hares. 
 
12
# You specify what group/resource and system you want the status for, and
 
13
# the plugin returns a status code based on the output of either hagrp or 
 
14
# hares.
 
15
#
 
16
# Normal hagrp/hares status codes are ONLINE and OFFLINE depending on where the 
 
17
# cluster service currently lives.  I have added an option, -n, which makes
 
18
# the expected state to be OFFLINE rather than ONLINE so you can run the 
 
19
# plugin on both sides of the cluster and will receive critical alerts when
 
20
# the cluster fails over i.e.  a proper failover will make the standby node
 
21
# go from OFFLINE to ONLINE for the group, so an ONLINE status should alert
 
22
# you! (You do want to know when the cluster fails over, right? :))
 
23
#
 
24
# Output:
 
25
#
 
26
# This plugin returns OK when hagrp/hares -state <grp> -sys <system> returns 
 
27
# ONLINE (or OFFLINE if -n is specified).  Any other hagrp/hares string returns 
 
28
# CRITICAL...  Would a WARNING ever be justified???  UNKNOWN is returned if 
 
29
# hagrp/hares cannot run for some reason.
 
30
# 
 
31
# Examples:
 
32
#
 
33
# Make sure group oracle is ONLINE on server dbserver1:
 
34
#   check_vcs -g oracle -s dbserver1
 
35
#
 
36
# Make sure group oracle is OFFLINE on server dbserver2:
 
37
#   check_vcs -g oracle -s dbserver2 -n
 
38
#
 
39
# Make sure resource oraip is ONLINE on server dbserver1:
 
40
#   check_vcs -r oraip -s dbserver1
 
41
#
 
42
# Make sure resource oraip is OFFLINE on server dbserver2:
 
43
#   check_vcs -r oraip -s dbserver2 -n
 
44
#
 
45
 
 
46
 
 
47
BEGIN {
 
48
    if ($0 =~ s/^(.*?)[\/\\]([^\/\\]+)$//) {
 
49
        $prog_dir = $1;
 
50
        $prog_name = $2;
 
51
    }
 
52
}
 
53
 
 
54
require 5.004;
 
55
 
 
56
use lib $main::prog_dir;
 
57
use utils qw($TIMEOUT %ERRORS &print_revision &support);
 
58
use Getopt::Long;
 
59
 
 
60
sub print_usage ();
 
61
sub print_version ();
 
62
sub print_help ();
 
63
 
 
64
    # Initialize strings
 
65
    $vcs_bin = '/opt/VRTSvcs/bin';
 
66
    $vcs_command = '';
 
67
    $vcs_arg = '';
 
68
    $vcs_group = '';
 
69
    $vcs_resource = '';
 
70
    $vcs_system = '';
 
71
    $vcs_negate = '';
 
72
    $vcs_result = '';
 
73
    $vcs_expected_result = 'ONLINE';
 
74
    $plugin_revision = '$Revision: 1.1 $ ';
 
75
 
 
76
    # Grab options from command line
 
77
    GetOptions
 
78
    ("g|group:s"        => \$vcs_group,
 
79
     "r|resouce:s"      => \$vcs_resource,
 
80
     "s|system=s"       => \$vcs_system,
 
81
     "n|negate"         => \$vcs_negate,
 
82
     "v|version"        => \$version,
 
83
     "h|help"           => \$help);
 
84
 
 
85
    (!$version) || print_version ();
 
86
    (!$help) || print_help ();
 
87
    (!$vcs_negate) || ($vcs_expected_result = 'OFFLINE');
 
88
 
 
89
    # Make sure group and resource is not specified
 
90
    !($vcs_group && $vcs_resource) || usage("Please specify either a group or a resource, but not both.\n");
 
91
    # Make sure group or resource is specified
 
92
    ($vcs_group || $vcs_resource) || usage("HA group or resource not specified.\n");
 
93
    # Make sure system is specified
 
94
    ($vcs_system) || usage("HA system not specified.\n");
 
95
 
 
96
    # Specify proper command
 
97
    if ($vcs_group) {
 
98
        $vcs_command = 'hagrp';
 
99
        $vcs_arg = $vcs_group;
 
100
    } else {
 
101
        $vcs_command = 'hares';
 
102
        $vcs_arg = $vcs_resource;
 
103
    }
 
104
 
 
105
    # Run command and save output
 
106
    $vcs_result = `$vcs_bin/$vcs_command -state $vcs_arg -sys $vcs_system`;
 
107
    chomp ($vcs_result);
 
108
 
 
109
    # If empty result, return UNKNOWN
 
110
    if (!$vcs_result) {
 
111
        print "UNKNOWN: Problem running $vcs_command...\n";
 
112
        exit $ERRORS{'UNKNOWN'};
 
113
    }
 
114
        
 
115
    # If result is expected, return OK
 
116
    # If result is not expected, return CRITICAL
 
117
    if ($vcs_result eq $vcs_expected_result) {
 
118
        print "OK: $vcs_command $vcs_arg is $vcs_result\n";
 
119
        exit $ERRORS{'OK'};
 
120
    } else {
 
121
        print "CRITICAL: $vcs_command $vcs_arg is $vcs_result\n";
 
122
        exit $ERRORS{'CRITICAL'};
 
123
    }
 
124
        
 
125
 
 
126
#
 
127
# Subroutines
 
128
#
 
129
 
 
130
sub usage () {
 
131
    print @_;
 
132
    print_usage();
 
133
    exit $ERRORS{'OK'};
 
134
}
 
135
 
 
136
sub print_usage () {
 
137
    print "\nUsage: $prog_name { -g <vcs_group> | -r <vcs_resource> } -s <vcs_system> [-n]\n";
 
138
    print "Usage: $prog_name [ -v | --version ]\n";
 
139
    print "Usage: $prog_name [ -h | --help ]\n";
 
140
}
 
141
 
 
142
sub print_version () {
 
143
    print_revision($prog_name, $plugin_revision);
 
144
    exit $ERRORS{'OK'};
 
145
}
 
146
 
 
147
sub print_help () {
 
148
    print_revision($prog_name, $plugin_revision);
 
149
    print "\n";
 
150
    print "Validate output from hagrp/hares command.\n";
 
151
    print "\n";
 
152
    print_usage();
 
153
    print "\n";
 
154
    print "-g, --group=<vcs_group>\n";
 
155
    print "    The HA group to be validated\n";
 
156
    print "-r, --resource=<vcs_resource>\n";
 
157
    print "    The HA resource to be validated\n";
 
158
    print "-s, --system=<vcs_system>\n";
 
159
    print "    The HA system where the group/resource lives\n";
 
160
    print "-n, --negate=<negate>\n";
 
161
    print "    Set expected result to OFFLINE instead of ONLINE\n";
 
162
    print "\n";
 
163
    support();
 
164
    exit $ERRORS{'OK'};
 
165
}