Skip to main content

Ruckus Zonedirector

Overview

Ruckus Wireless ZoneDirector is RUCKUS’ centrally managed Smart Wireless LAN (WLAN) system developed specifically for small-to-medium enterprises (SMEs).

Monitoring Connector assets

Monitored objects

  • Ruckus Access Point
  • Ruckus Controllers

Discovery rules

Rule nameDescription
Net-Ruckus-Zonedirector-SNMP-Ap-NameDiscover access point attached to your controller

Monitored metrics

Metric nameDescription
zd_connection_statusThe connection status with Zonedirector controller.
accesspoint.cpu.utilization.percentageCpu utilization by AP. Unit: %
accesspoint.memory.usage.bytesMemory used by AP. Unit: Bytes
accesspoint.memory.free.bytesMemory free by AP. Unit: Bytes
accesspoint.memory.usage.percentageMemory used by AP. Unit: %
accesspoint.connection.accesspointsNumber of APs. Unit: Count
accesspoint.connection.client.devices.authorized.countTotal number of authenticated terminal which is using currently on this AP. Unit: Count
accesspoint.connection.rogue.devices.countNumber of rogue devices. Unit: Count
accesspoint.traffic.in.bitsperseconIncoming traffic going through the access point. Unit: bits/second
accesspoint.traffic.out.bitspersecondOutgoing traffic going through the access point. Unit: bits/second

Prerequisites

Ruckus device configuration

To use this Plugin, the SNMP service must be properly configured on your Ruckus device. Ruckus provides an official documentation to achieve this: http://docs.ruckuswireless.com/smartzone/3.6.1/sz100-vsze-administrator-guide/GUID-F08BF334-2116-47A5-900C-B6AA4FC5E62A

Network flow

Your Centreon Poller must be able to reach the Ruckus device over UDP/161 SNMP port.

Setup

  1. Install the Centreon package on every Poller expected to monitor Ruckus Zonedirector ressources:
yum install centreon-plugin-Network-Ruckus-Zonedirector-Snmp
  1. On the Centreon Web interface, install the 'Ruckus Zonedirector' Centreon Monitoring Connector on the Configuration > Monitoring Connector Manager page

Configuration

  • Log into Centreon and add a new Host through "Configuration > Hosts".
  • Apply the template "Net-Ruckus-Zonedirector-SNMP-custom" and configure the 'SNMP Community' and 'SNMP Version' fields to match the device configuration.

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific authentication parameters More information in the Troubleshooting SNMP section.

MandatoryNomDescription
SNMPEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

FAQ

How do I test my configuration through the CLI and what do the main parameters stand for ?

Once the Centreon Plugin installed, you can test it logging with the centreon-engine user:

/usr/lib/centreon/plugins//centreon_ruckus_zonedirector_snmp.pl \
--plugin=network::ruckus::zonedirector::snmp::plugin \
--mode=system \
--hostname=ruckus.int.centreon.com \
--snmp-version='2c' \
--snmp-community='ruckus_zonedirector' \
--verbose

The command above checks the system utilization on your Ruckus box (--mode=system). You must always define the IP address/FQDN of the device (--hostname=ruckus.int.centreon.com) as well as the SNMP versions and community (--snmp-version='2c' --snmp-community='ruckus_zonedirector')

You can display all modes that come with the Plugin with the command below:

/usr/lib/centreon/plugins//centreon_ruckus_zonedirector_snmp.pl \
--plugin=network::ruckus::zonedirector::snmp::plugin \
--list-mode

You can display options of a specific mode by using the --help flag. Here is an example to display system mode parameters:

/usr/lib/centreon/plugins//centreon_ruckus_zonedirector_snmp.pl \
--plugin=network::ruckus::zonedirector::snmp::plugin \
--mode=system \
--help

UNKNOWN: SNMP GET Request : Timeout

This message generally means that you are not using the right SNMP version or community. It could also indicate that a third-party device like a firewall is blocking the SNMP UDP/161 request.

UNKNOWN: SNMP GET Request : Cant get a single value.

This error message often refers to the following issues:

  • the Ruckus device doesn't support the MIB used by the plugin
  • the targeted SNMP OID cannot be fetched because of insufficient privileges on the device. SNMP Agent must be capable of accessing to the enterprise branch Ruckus : .1.3.6.1.4.1.25053.