Skip to main content

Ruckus Smartzone

Overview​

Ruckus SmartZone network controllers simplify the complexity of scaling and managing wired switches, and wireless access points through a common interface to support private-cloud network-as-a-service (NaaS) offerings in addition to general enterprise networks.

Plugin-Pack assets​

Monitored objects​

  • Ruckus Access Point
  • Ruckus Controllers

Discovery rules​

Rule nameDescription
Net-Ruckus-Smartzone-SNMP-Ap-NameDiscover access point attached to your controller
Net-Ruckus-Smartzone-SNMP-Disk-NameDiscover storage point attached to your controller
Net-Ruckus-Smartzone-SNMP-Traffic-NameDiscover interfaces attached to your controller

Monitored metrics​

Metric nameDescription
connection_statusThe connection status.
config_statusThe registration status, which could either be pending, approved, rejected or swapped.
registration_statusThe AP configuration status.
accesspoint.connection.client.devices.authorized.countThe number of stations. Unit: Count
accesspoint.traffic.in.bitspersecondIncoming 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 pack, 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 server must be able to reach the Ruckus device over UDP/161 SNMP port.

Setup​

  1. Install the Centreon Plugin package on every Centreon poller expected to monitor Ruckus Smartzone ressources:
yum install centreon-plugin-Network-Ruckus-Smartzone-Snmp
  1. On the Centreon Web interface, install the 'Ruckus Smartzone' Centreon Plugin-Pack on the "Configuration > Plugin Packs > Manager" page

Configuration​

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

When using SNMP v3, set extra parameters with SNMPEXTRAOPTIONS macro :

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_smartzone_snmp.pl \
--plugin=network::ruckus::smartzone::snmp::plugin \
--mode=cpu \
--hostname=ruckus.int.centreon.com \
--snmp-version='2c' \
--snmp-community='ruckus_smartzone' \
--verbose

The command above checks the CPU utilization of your Ruckus box (--mode=cpu). 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_smartzone')

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

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

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

/usr/lib/centreon/plugins//centreon_ruckus_smartzone_snmp.pl \
--plugin=network::ruckus::smartzone::snmp::plugin \
--mode=cpu \
--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.