Contexte

Le pack ruckus-AP-by-SNMP__shinken permet de superviser les bornes WIFI de la marque Ruckus. Les vérifications sont effectuées grâce au protocole SNMP, via des appels actifs effectués depuis les pollers de Shinken.

• Le pack vous permet de vérifier :
  • l'utilisation ( Cpu, Mémory ) des ressources.
  • l'état ( Connected Clients ) du service WIFI.
• Les commandes de vérifications exécutées depuis les serveurs Shinken utilisent une sonde PYTHON présente dans le répertoire des sondes Shinken  /var/lib/shinken-user/libexec/shinken-additional-packs/ruckus-AP-by-SNMP_shinken/   ( ou $GLOBAL_RUCKUS-AP-BY-SNMP_SHINKEN_PLUGINSDIR $ depuis l'interface de configuration ), après la mise en place du pack.

Le pack se compose de deux grandes familles de modèles d'hôtes :

• Les modèles "SNMPv1v2", pour superviser la borne WIFI grâce au protocole SNMP v1 ou v2 (  Les versions V1 et V2 du protocole SNMP permettent une mise en place plus rapide, au détriment d'une sécurité plus faible  ) :
  • ruckus-AP-by-SNMPv1v2 qui permet la supervision des ressources ( Cpu, Memory ).
  • ruckus-AP-by-SNMPv1v2__clients-stats qui permet d'obtenir les informations relatives aux réseaux WIFI gérés par la borne ( Connected Clients ).

• Les modèles "SNMPv3", pour superviser la borne WIFI grâce au protocole SNMP v3 (  La version V3 du protocole SNMP impose une mise en place plus longue, avec la configuration de plusieurs mots de passe et algorithmes de chiffrement. Il s'agit de la version la plus sécurisée de SNMP  ) :
  • ruckus-AP-by-SNMPv3__( noAuthNoPriv / authNoPriv / authPriv )  qui permet la supervision des ressources ( Cpu, Memory ).
  • ruckus-AP-by-SNMPv3__( noAuthNoPriv / authNoPriv / authPriv )__clients-stats qui permet d'obtenir les informations relatives aux réseaux WIFI gérés par la borne ( Connected Clients ).

Ce pack est importé et mis à jour par la source " shinken-additional-packs-import ".

Voici un aperçu du contenu du pack :

Comment utiliser son pack ?

Mise en place

Pour utiliser les packs externes Shinken, il faut commencer par les installer sur son infrastructure Shinken. Cette action permet :

• D'installer sur les serveurs les sondes ( le code informatique  ) nécessaires aux vérifications.
• De faire apparaître sur l'interface de configuration les nouveaux modèles.
• De préparer l'hôte à superviser ( Borne WIFI Ruckus  ) pour accepter les requêtes de supervision.

Une page dédiée explique comment mettre en place le pack ruckus-AP-by-SNMP ( Page NEW-PAGE - SPAC-66 - Mise en place du Pack cisco-AP-by-SNMP__shinken ).

Utilisation

Choisir les modèles d'hôtes

Une fois le pack installé, il suffit d'appliquer les modèles nouvellement importés sur les hôtes à superviser :

• En utilisant l'interface de configuration : Créez ou éditez un Hôte, et ajoutez un des modèles ; "ruckus-AP-by-SNMPv3__authPriv "  par exemple ; grâce au menu déroulant ( voir la page Éditer un Hôte  ).
• En éditant les fichiers de définition d'élément ( .cfg ) : 
  • Dans un fichier de configuration, créez ou éditez votre définition d'hôte en ajoutant, dans la propriété "use", la valeur " ruckus-AP -by-SNMPv3__authPriv ".
  • Le fichier de configuration devra alors être importé avec une source ( voir la page Collecteur de type ( cfg-file-import ) - Import depuis des fichiers au format .cfg  ).

Listes des modèles à utiliser dans le pack

Personnaliser son pack

Il est possible de modifier certains éléments (  commandes, checks ou modèles d'hôtes  )

• voir la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken .

Version des scripts livrés