nagios-snmp-plugins/doc/html/nagios.manubulon.com/snmp_vrrp.html

383 lines
15 KiB
HTML
Raw Permalink Blame History

<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<table border="0">
<tr>
<td valign=top><!-- Begin Side Bar -->
<table border="0" width="130" valign=top>
<tr>
<td><a class="SideNavBarHotItem" >This site :</a></td>
</tr>
<tr>
<td><a href="index.html" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td><a href="index_snmp.html" class="SideNavBarItem" >Nagios plugins</a></td>
</tr>
<tr>
<td><a href="index_info.html" class="SideNavBarItem" >Info on snmp</a></td>
</tr>
<tr>
<td><a href="index_commands.html" class="SideNavBarItem" > Nagios config</a></td>
</tr>
<tr>
<td><a href="http://nagios.manubulon.com/wiki/index.php/Faq-url" class="SideNavBarItem" > FAQ</a></td>
</tr>
<tr>
<td><a href="http://sourceforge.net/projects/nagios-snmp/" class="SideNavBarItem" > Project page on SourceForge</a> </td>
</tr>
<tr>
<td><font color="#FFFFFF">-----------</font></td>
</tr>
<tr>
<td><a class="SideNavBarHotItem" >Links :</a></td>
</tr>
<tr>
<td><a href="http://www.nagios.org/" class="SideNavBarItem" >Nagios
Home</a></td>
</tr>
<tr>
<td><a href="http://sourceforge.net/projects/nagiosplugins" class="SideNavBarItem" >Nagios
Plugins</a></td>
</tr>
<tr>
<td><a href="http://www.oreon.org" class="SideNavBarItem" >Oreon project</a></td>
</tr>
<tr>
<td><a href="http://www.nagiosexchange.org" class="SideNavBarItem" >NagiosExchange</a></td>
</tr>
<tr>
<td><a href="http://forums.opsyx.com/viewforum.php?f=1" class="SideNavBarItem" >Opsyx
forum</a></td>
</tr>
<tr>
<td><a href="http://forum.2037.org/" class="SideNavBarItem" >Forum 2037</a></td>
</tr>
<tr>
<td><font color="#FFFFFF">-----------</font></td>
</tr>
<tr>
<td><a class="SideNavBarHotItem" >Others :</a></td>
</tr>
<tr>
<td>
<script type="text/javascript"><!--
google_ad_client = "ca-pub-1303792821309694";
/* nagios */
google_ad_slot = "5986789334";
google_ad_width = 120;
google_ad_height = 600;
//-->
</script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>
</td>
</tr>
<tr>
<td><font color="#FFFFFF">-----------</font></td>
</tr>
<tr>
<td><A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&amp;type=3" width="110" height="37" border="0" alt="SourceForge.net Logo" /></A> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp vrrp check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_vrrp.pl</p>
<p class="SectionTitle"> Last update : Sept 4 2006</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 the vrrp status
of all vrrp enabled interfaces. <br>
Works on<br>
- Nokia IP with ipso 3.X , 4.X in VRRP mode.<br>
- Nokia IP with ipso 3.X , 4.X in clustering mode.<br>
- Radware Linkproof<br>
- Alteon AD4 Loadbalancers</p>
<p class="SectionBody">Depending on the state you put as option (&quot;master&quot;
or &quot;backup&quot;) the script will get all the vrrp enables
interface and check they are in this state. <br>
If not, it will retrun a critical status<br>
By default, it will check Nokia IP platforms using vrrp, you can
test other platforms with the '-T' option :<br>
<br>
- Alteon<br>
- Linkproof (VRRP)<br>
- Nokia clustering.</p>
<p class="SectionTitle">Nokia clustering check</p>
<p class="SectionBody">Nokia clustering check does not have a master
&amp; backup state. Instead, the plugin will check : </p>
<p class="SectionBody">- The number of cluster member<br>
- The % load on each cluster.</p>
<p class="SectionBody">For example <b>-s 2,90</b> will issue <br>
- A critical level if there is not 2 members.<br>
- A warning level if more than 90% is assigned to one cluster member.</p>
<p class="SectionBody">To have a long output, put the '-g' option.</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionBody"><span class="SectionTitle">French </span>:
V<>rifie par snmp v1 ou v3 l'&eacute;tat des interfaces vrrp : Nokia,
Linkproof, Alt&eacute;on ou l'&eacute;tat d'un cluster Nokia.</p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory<br>
</p>
<p class="SectionBody"><a href="check_snmp_vrrp.pl" class="SectionTitle">Dowload
lastest version : 1.3</a> </p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<p class="SectionBody">If multiple interfaces are selected, all must
be up to get an OK result</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Get help
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_vrrp.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">snmpv3 login</td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-l login -x passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check vrrp state of a node to be master.
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_vrrp.pl -H 127.0.0.1 -C public <b>-s master</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<div align="right">
<p>Output example :<br>
The ouput is : &lt;vrid&gt;(&lt;state&gt;,&lt;status&gt;,&lt;priority&gt;)
</p>
</div>
</td>
<td class="SectionBody" width="387">Vrid : 10(master/up/100),
1(master/up/100), 3(master/up/100), 2(master/up/100), : All
master :OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Check vrrp state
of a node to be backup. </td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-C public <b>-s backup</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p align="right">Output example :
</td>
<td class="SectionBody" width="387">
<p>Vrid : 1(backup/up/95), 3(backup/up/95), 10(backup/up/95),
2(backup/up/95), : All backup :OK</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Test a Linkproof</td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-C public -s master <b>-T lp</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Test a Nokia
cluster : 2 cluster members and max 90% load assigned to one
cluster. </td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-C public <b>-s 2,90%-T ipso</b></td>
</tr>
</table>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="NewsItemDate">Output of check_snmp_vrrp.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p class="SectionBody">SNMP VRRP Monitor for Nagios version
1.3<br>
(c)2004-2006 to my cat Ratoune - Author : Patrick Proy
<p>Usage: ./check_snmp_vrrp.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt;
[-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
-s &lt;master|backup|num,%&gt; [-T &lt;nokia|alteon|lp|nsc|ipsocluster&gt;]
[-p &lt;port&gt;] [-t &lt;timeout&gt;] [-V]<br>
-v, --verbose<br>
print extra debugging information (including interface list
on the system)<br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies v1 protocol)<br>
-2, --v2c<br>
Use snmp v2c<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default
md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des)
<br>
-P, --port=PORT<br>
SNMP port (Default 161)<br>
-T, --type=&lt;nokia|alteon|lp|nsc|ipso&gt;<br>
Type of vrrp router to check<br>
nokia (default) : Nokai vrrp. Should be working for most vrrp
routers<br>
alteon : for Alteon AD4 Loadbalancers<br>
lp : Radware Linkproof<br>
nsc : Nescreen (ScreenOS 5.x NSRP)<br>
ipso : Nokia IPSO clustering<br>
-s, --state=master|backup|num,%<br>
Nokia ipso clustering : number of members, max % assigned
to nodes.<br>
Other : check vrrp interface to be master or backup<br>
-g, --long<br>
Make output long even is all is OK <br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5)<br>
-V, --version<br>
prints version number</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>