Monitoring, Management & Location Tracking

Configure AirWave to be monitored by external NMS
Requirement:

Airwave Administrators wants to monitor Airwave's health status, resource utilization etc.

 


 



Solution:

Most of the Aruba customers have existing NMS systems that they would like to use to monitor the health of their AirWave servers. AirWave uses standard open-source Linux SNMP packages to make sure that critical system process are running, that the load average is not too high and the disks have enough free space. Configuration of the SNMP daemon (snmpd) is not something that can be done from AMP's GUI today, but it is supported via the CLI. This article describes how to install the needed packages and configure the daemon to run.



Configuration:

First, install net-snmp (to do this, the server needs to be able to get out to the internet):
# yum install -y net-snmp

 

Second, go into the /var/airwave/custom directory and run the snmpconf script. The most important settings are documented below.
# custom
# snmpconf

When it asks if you'd read in existing files, choose "none". All we want to do is make a new snmpd.conf file.
I can create the following types of configuration files for you.
Select the file type you wish to create:
(you can create more than one as you run this program)

  1:  snmpd.conf
  2:  snmp.conf
  3:  snmptrapd.conf


The settings that our customers would typically edit are the Access Control, Monitoring and System Info.
  1:  Access Control Setup
  2:  Trap Destinations
  3:  Monitor Various Aspects of the Running Host
  4:  Extending the Agent
  5:  Agent Operating Mode
  6:  System Information Setup


Access control: Set up a read-only community string or SNMPv3 user.

Monitoring:
  1:  Check for processes that should be running.
  2:  Check for disk space usage of a partition.
  3:  Check for unreasonable load average values.
  4:  Check on the size of a file.

 

Recommended Settings:

Typical configuration of processes that should be running:

Name  Max  Min  Notes  
httpd__________  128  32  Make sure to include the underscores  
postmaster  128  32  database processes  
pound  128  1  internal proxy server  
java  <0-2>  <0-2>  1 process for VisualRF, 1 for Instant GUI config  


 For a server that is running VisualRF and IGC, this section of the config file will look like this:
proc httpd__________ 128 32
proc postmaster 128 32
proc pound 128 1
proc java 2 2


Disk space and load average thresholds will be very different from server to server.  Put whatever settings make sense in your environment.

Finally, copy the config file you created, turn the service on, and tell the OS to start snmpd on bootup:
# cp /var/airwave/custom/snmpd.conf /etc/snmp/snmpd.conf
# service snmpd restart
# chkconfig snmpd on

 

 

 

 

 

 



Verification

After the config, the example snmp.conf file, might look like this:

###########################################################################
#
# snmpd.conf
#
#   - created by the snmpconf configuration program
#
###########################################################################
# SECTION: Access Control Setup
#
#   This section defines who is allowed to talk to your running
#   snmp agent.

# rocommunity: a SNMPv1/SNMPv2c read-only access community name
#   arguments:  community [default|hostname|network/bits] [oid]

rocommunity  public 10.0.0.0/8

 

 


###########################################################################
# SECTION: Monitor Various Aspects of the Running Host
#
#   The following check up on various aspects of a host.

# proc: Check for processes that should be running.
#     proc NAME [MAX=0] [MIN=0]
#   
#     NAME:  the name of the process to check for.  It must match
#            exactly (ie, http will not find httpd processes).
#     MAX:   the maximum number allowed to be running.  Defaults to 0.
#     MIN:   the minimum number to be running.  Defaults to 0.
#   
#   The results are reported in the prTable section of the UCD-SNMP-MIB tree
#   Special Case:  When the min and max numbers are both 0, it assumes
#   you want a max of infinity and a min of 1.

proc httpd__________ 128 32
proc postmaster 128 32
proc pound 128 1
proc java 2 2

# disk: Check for disk space usage of a partition.
#   The agent can check the amount of available disk space, and make
#   sure it is above a set limit.  
#   
#    disk PATH [MIN=100000]
#   
#    PATH:  mount path to the disk in question.
#    MIN:   Disks with space below this value will have the Mib's errorFlag set.
#           Can be a raw integer value (units of kB) or a percentage followed by the %
#           symbol.  Default value = 100000.
#   
#   The results are reported in the dskTable section of the UCD-SNMP-MIB tree

disk  / 100000000

# load: Check for unreasonable load average values.
#   Watch the load average levels on the machine.
#   
#    load [1MAX=12.0] [5MAX=12.0] [15MAX=12.0]
#   
#    1MAX:   If the 1 minute load average is above this limit at query
#            time, the errorFlag will be set.
#    5MAX:   Similar, but for 5 min average.
#    15MAX:  Similar, but for 15 min average.
#   
#   The results are reported in the laTable section of the UCD-SNMP-MIB tree

load  16 8 8

 

 

 

 

###########################################################################
# SECTION: System Information Setup
#
#   This section defines some of the information reported in
#   the "system" mib group in the mibII tree.

# syslocation: The [typically physical] location of the system.
#   Note that setting this value here means that when trying to
#   perform an snmp SET operation to the sysLocation.0 variable will make
#   the agent return the "notWritable" error code.  IE, including
#   this token in the snmpd.conf file will disable write access to
#   the variable.
#   arguments:  location_string

syslocation  "In the Data Center"

# syscontact: The contact information for the administrator
#   Note that setting this value here means that when trying to
#   perform an snmp SET operation to the sysContact.0 variable will make
#   the agent return the "notWritable" error code.  IE, including
#   this token in the snmpd.conf file will disable write access to
#   the variable.
#   arguments:  contact_string

syscontact  network_admins@arubanetworks.com

 

done.

Version History
Revision #:
2 of 2
Last update:
‎12-28-2015 01:13 AM
Updated by:
 
Labels (1)
Contributors
Search Airheads
Showing results for 
Search instead for 
Did you mean: 
Is this a frequent problem?

Request an official Aruba knowledge base article to be written by our experts.