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, 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_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.