2005-11-16
Jason Schoonover

Unnoc Aironets
	
	1. Intro
	2. unnoc config
	3. index.php

1. Introduction

At the company I'm currently at, we use Cisco Aironets 1231 Access 
Points all over our building and I wanted a way to view all of the
details that go along with each Aironet.  The number of users (with each
SSID), the traffic graphs associated with each SSID/VLAN and the combined
usage.  So I initially wrote a simple CGI perl script that was a wrapper
to an IOS command 'show dot11 associations'.  However this proved to be
unreliable at times, and was a kluge to configure because it required
telnet access and a username/password to get onto the system.

As of Unnoc 1.0.6, this is no longer required.  Everything is pulled in
from SNMP, and is all integrated with RRD.  Each SSID is graphed, along
with whatever VLAN it is associated with.  There's also a combined usage
RRD traffic graph, per interface statistics, and the number of users is
also graphed.


This is example output:

------------------------------------------------------------------------------
aironet1, Payroll
8 total active clients

SSID [priv] :
 
 Mac Address		IP Address	Strength  Time 	Sent 	Received  State
 00:0b:7d:0a:17:23 	10.10.41.19 	-52 	  9318	5976634	1476319	  WEP/EAP-Auth
 00:ab:7c:11:51:de 	10.10.41.117	-53 	  9756	1322152	520629	  WEP/EAP-Auth 
 00:0d:93:dc:54:7a 	10.10.41.140 	-70 	  831	372774	56618     WEP/EAP-Auth 
 00:12:fa:01:16:98 	10.10.42.137	-36 	  13017	1053159	1577823   WEP/EAP-Auth 
 00:12:0f:18:84:df 	10.10.42.180	-65 	  2203	1449507	603167	  WEP/EAP-Auth
  
SSID [oracle] :
 00:fa:22:01:16:b8 	172.18.4.144	-44 	  20321	105551	191783    WEP/EAP-Auth 
 00:0b:75:18:d4:df 	172.18.4.118	-56 	  2353	1313557	6000107	  WEP/EAP-Auth
   
SSID [public access] :
 00:12:ad:12:52:22 	0.0.0.0 	-12 	  155	534	1739	  Assoc.

------------------------------------------------------------------------------

NOTE: I've not tested this out on Aironets with the Aironet software
on them, I've only tested it out with the Cisco IOS software.

2. unnoc config

The way to configure an aironet is with the 'host' directive in the
unnoc.conf file.  See the README.hosts file for proper syntax, here is
an example config:

	host {
		hostname = aironet-1
		community = public
		type = aironet
	}

You can specify a different interval with the 'interval' directive.

If you would like to check the up/down status via 'ping' then specify
the 'updown' directive as 'ping'.  The default value of 'updown' is
'snmp' -- this means that if it does not get a response via snmp, then it
will consider it down, or will wait until 'fuzz' attempts before it
considers it down (if fuzz is defined).

3. index.php

To see the aironet link, enable it with the print_href functions on
the front page (or wherever you want it to be displayed).  The proper 
argument is 'aironets':

	<?php print_href_type ('aironet'); ?>
	<?php print_href_host ('aironet-1', 'aironet-2'); ?>

If you would like to print out all of the access points on one page
(without the graphs), then you can use the term 'all_aironets', to the
print_href_type() function,  so if you wanted to see a list of all of 
your aironets and then at the bottom have a link to 'All Aironet
Associations', you could to:

	
	<?php print_href_type ('aironet', 'all_aironets'); ?>

	OR 

	<?php print_href_type ('aironet'); ?>
	<?php print_href_type ('all_aironets'); ?>

If you would like to setup links manually, the links that are printed
are:

	For single host display, hostname 'aironet-1':

		display.php?host=aironet-1

	For all display:

		display.php?all=aironets




vim:tw=72:wm=1