Configuration du serveur Syslog sur les contrôleurs LAN sans fil

Introduction

Ce document décrit comment configurer le contrôleur LAN sans fil pour les serveurs Syslog.

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Connaissance de la façon dont configurer le contrôleur LAN sans fil (WLC) et le point d'accès léger (LAP) pour le fonctionnement de base.

• Connaissances de base du protocole CAPWAP (Control And Provisioning of Wireless Access Point).

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Contrôleurs LAN sans fil exécutant le logiciel AireOS 8.8.11.0.

• Points d'accès de phase 1 : 3500, 1600/2600/3600 (ceux-ci sont limités à la version logicielle 8.5 et peuvent manquer certaines des fonctionnalités suivantes qui ont été ajoutées par la suite), 1700/2700/3700.
• Points d'accès de phase 2 : 1800/2800/3800/4800, 1540 et 1560. 

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations sur Syslog sur les WLC

La journalisation système permet aux contrôleurs de consigner leurs événements système sur un maximum de trois serveurs syslog distants.

Le WLC envoie une copie de chaque message syslog tel qu'il est consigné à chaque serveur syslog configuré sur le contrôleur.

La possibilité d'envoyer les messages Syslog à plusieurs serveurs garantit que les messages ne sont pas perdus en raison de l'indisponibilité temporaire d'un serveur Syslog.

Syslog sur les points d'accès

Depuis AireOS 8.4, vous avez la possibilité de désactiver le serveur syslog par AP et/ou global via l'interface de ligne de commande WLC.

Sur la version 8.8, il a été introduit le support de la fonctionnalité syslog sur les AP de phase 2. 

Configurer

Vous pouvez activer et configurer le contrôleur pour qu'il consigne les événements système sur un maximum de trois serveurs syslog distants. Le contrôleur envoie une copie de chaque message syslog tel qu'il est consigné à chaque serveur syslog configuré sur le contrôleur. Étant donné qu'il peut envoyer les messages Syslog à plusieurs serveurs, il s'assure que les messages ne sont pas perdus en raison de l'indisponibilité temporaire d'un serveur Syslog.

Ce type de configuration est utile dans les situations suivantes :

• L'un des serveurs syslog configurés n'est pas disponible.
• Plusieurs groupes d'administrateurs peuvent surveiller différents types de messages.
• Pour les déploiements de grande envergure, les messages syslog doivent être envoyés aux serveurs dans différents fuseaux horaires pour une meilleure visibilité.

Remarque : les messages Syslog sont envoyés sur le port UDP 514 ; une configuration de serveur supplémentaire peut nécessiter une configuration correcte des règles de pare-feu.

Remarque : lorsqu'une liaison de port WLC principal tombe en panne, les messages peuvent être consignés en interne uniquement et ne pas être publiés sur un serveur syslog. La restauration de la journalisation sur le serveur syslog peut prendre jusqu'à 40 secondes.

Configurations de Syslog sur WLC (GUI)

Étape 1. Accédez à Management > Logs > Config. La page Syslog Configuration s'affiche :

Étape 2. Entrez l'adresse IP du serveur Syslog et cliquez sur Add. Vous pouvez ajouter jusqu'à trois serveurs syslog au contrôleur. La liste des serveurs Syslog qui ont déjà été ajoutés au contrôleur apparaît sous cette zone de texte. Si vous voulez supprimer un serveur syslog du contrôleur, cliquez sur Remove à droite du serveur souhaité.

Étape 3. Pour définir le niveau Syslog (gravité) pour filtrer les messages Syslog vers les serveurs Syslog, choisissez l'une des options suivantes dans la liste déroulante Niveau Syslog :

• Urgences= Niveau de gravité 0
• Alertes= Niveau de gravité 1 (valeur par défaut)
• Critique= Niveau de gravité 2
• Erreurs= Niveau de gravité 3
• Avertissements= Niveau de gravité 4
• Notifications= Niveau de gravité 5
• Informationnel= Niveau de gravité 6
• Débogage= Niveau de gravité 7

Étape 4. Pour définir l'utilitaire Syslog pour les messages Syslog sortants vers les serveurs Syslog, choisissez l'une des options suivantes dans la liste déroulante Utilitaire Syslog :

• Noyau= Niveau de fonction 0 
• Processus utilisateur= Niveau d'installation 1
• Mail= Niveau d'installation 2
• Démons système= Niveau de service 3
• Autorisation= Niveau d'installation 4
• Syslog = niveau 5 de l'installation (valeur par défaut)
• Imprimante ligne= Niveau d'installation 6
• USENET= Niveau d'installation 7
• Copie Unix-vers-Unix= niveau 8 du domaine
• Cron= Niveau d'installation 9
• Démon FTP= Niveau de fonction 11
• Utilisation du système 1= Niveau d'installation 12
• Utilisation du système 2= Niveau d'installation 13
• Utilisation du système 3= Niveau d'installation 14
• Utilisation du système 4= Niveau d'installation 15
• Utilisation locale 0= Niveau d'installation 16
• Utilisation locale 2= Niveau d'installation 17
• Utilisation locale 3= Niveau d'installation 18
• Utilisation locale 4= Niveau d'installation 19
• Utilisation locale 5= Niveau d'installation 20
• Utilisation locale 5= Niveau d'installation 21
• Utilisation locale 5= Niveau d'installation 22
• Utilisation locale 5 = niveau d'installation 23

Par exemple, sélectionner Kernel ne fait que des messages liés au noyau à envoyer. Autorisation, ne fait que les messages AAA à envoyer, etc.

Étape 5. Cliquez sur Apply.

Configuration de Syslog sur WLC (CLI)

Étape 1. Activez la journalisation système et définissez l'adresse IP du serveur syslog auquel envoyer les messages syslog en entrant cette commande :

(Cisco Controller) >config logging syslog host server_IP_address

Étape 2. Pour supprimer un serveur Syslog du contrôleur en entrant cette commande :

(Cisco Controller) >config logging syslog host server_IP_address delete

Étape 3. Définissez le niveau de gravité du filtrage des messages Syslog sur le serveur Syslog en entrant la commande suivante : 

(Cisco Controller) >config logging syslog level severity_level

Remarque : comme severity_level vous pouvez entrer le mot ou le numéro. Par exemple : debugging ou 7.

Envoi de débogages CLI WLC au serveur Syslog 

À l'aide de cette commande, le WLC enregistre la sortie de débogage sur le serveur syslog. Cependant, si la session CLI est interrompue, le débogage se termine et il n'y a plus de sortie envoyée au serveur syslog.

(Cisco Controller) >config logging debug syslog enable 

Configuration de Syslog pour les AP à partir du WLC (CLI uniquement)

Étape 1.Pour configurer l’adresse IP du serveur Syslog, vous devez utiliser l’interface de ligne de commande. Vous pouvez définir l'adresse IP de manière globale pour tous les points d'accès ou pour un point d'accès spécifique.

(Cisco Controller) >config ap syslog host ?

global        Configures the global system logging host for all Cisco AP
specific      Configures the system logging host for a specific Cisco AP.

(Cisco Controller) >config ap syslog host global ?

<ip_address> IP address of the global system logging host for all Cisco AP

(Cisco Controller) >config ap syslog host global 10.0.0.1
Setting the AP Global Syslog host will overwrite all AP Specific Syslog host configurations!
Are you sure you would like to set the AP Global Syslog host? (y/n) y


AP Global Syslog host has been set.

(Cisco Controller) >show ap config global

AP global system logging host.................... 10.0.0.1
AP global system logging level................... debugging
AP Telnet Settings............................... Globally Configured (Disabled)
AP SSH Settings.................................. Globally Configured (Disabled)
Diminished TX power Settings..................... Globally Configured (Disabled)

Étape 2. Via l'interface de ligne de commande, vous pouvez également définir le niveau de gravité et de syslog pour filtrer les messages syslog d'un point d'accès particulier ou de tous les points d'accès en entrant les commandes suivantes :

(Cisco Controller) >config ap logging syslog level severity_level 

Remarque : comme severity_level vous pouvez entrer le mot ou le numéro. Par exemple : debuggingor 7.

Étape 3. Définissez la fonction pour les messages syslogsortants sur le serveur syslogen entrant cette commande :

(Cisco Controller) >config logging syslog facility facility-code

où facility-code est l'un des suivants :

• ap = interruptions liées aux points d'accès.

• authorization = Système d'autorisation. Niveau d'installation = 4.

• auth-private = système d'autorisation (privé). Niveau d'installation = 10.
• cron = installation cron/at. Niveau d'installation = 9.
• daemon = Démons système. Niveau de l'installation = 3.
• ftp = démon FTP. Niveau d'installation = 11.
• kern = Noyau. Niveau d'installation = 0.
• local0 = Utilisation locale. Niveau d'installation = 16.
• local1 = Utilisation locale. Niveau d'installation = 17.
• local2 = Utilisation locale. Niveau d'installation = 18.
• local3 = Utilisation locale. Niveau de l'installation = 19.
• local4 = utilisation locale. Niveau d'installation = 20.
• local5 = utilisation locale. Niveau de l'installation = 21.
• local6 = Utilisation locale. Niveau de l'installation = 22.
• local7 = Utilisation locale. Niveau de l'installation = 23.
• lpr = système d'impression en ligne. Niveau d'installation = 6.
• mail = système de messagerie. Niveau de l'installation = 2.
• news = news USENET. Niveau de l'installation = 7.
• sys12 = Utilisation du système. Niveau d'installation = 12.
• sys13 = Utilisation du système. Niveau de l'installation = 13.
• sys14 = Utilisation du système. Niveau d'installation = 14.
• sys15 = Utilisation du système. Niveau d'installation = 15.
• syslog= Thesyslogself. Niveau d'installation = 5.
• utilisateur = Processus utilisateur. Niveau d'installation = 1.
• uucp = système de copie Unix vers Unix. Niveau d'installation = 8.

Étape 3. Configurez l'utilitaire syslog pour AP à l'aide de la commande suivante :

(Cisco Controller) >config logging syslog facility AP

où AP peut être :

Étape 4. Configurez l'utilitaire syslog pour un AP ou tous les AP en entrant cette commande :

(Cisco Controller) >config ap logging syslog facility facility-level {Cisco_AP| all}

où niveau installation est l'un des suivants :

• auth = système d'autorisation
• cron = installation cron/at
• daemon = Démons système
• kern = Noyau
• local0 = Utilisation locale
• local1 = Utilisation locale
• local2 = Utilisation locale
• local3 = Utilisation locale
• local4 = utilisation locale
• local5 = utilisation locale
• local6 = Utilisation locale
• local7 = Utilisation locale
• lpr = système d'impression en ligne
• mail = Système de messagerie
• news = news USENET
• sys10 = Utilisation du système
• sys11 = Utilisation du système
• sys12 = Utilisation du système
• sys13 = Utilisation du système
• sys14 = Utilisation du système
• sys9 = utilisation du système
• syslog = Syslog lui-même
• utilisateur = Processus utilisateur
• uucp = système de copie Unix vers Unix

Configuration de Syslog sur les points d'accès FlexConnect

Le débogage basé sur le client FlexConnect permet d'activer le débogage spécifique au client pour un point d'accès ou des groupes de points d'accès. Il permet également à la configuration du serveur syslog de consigner les messages de débogage.

Utilisation du débogage client FlexConnect :

• Vous pouvez déboguer un problème de connectivité client d'AP en entrant une adresse MAC particulière d'un client à partir du WLC ou de la console AP.
• Vous pouvez déboguer un problème de connectivité client sur le site FlexConnect sans entrer de commandes de débogage sur plusieurs points d'accès ou activer plusieurs débogages. Une seule commande debug active les débogages.
• Vous n'avez pas besoin d'entrer la commande debug sur plusieurs AP selon l'endroit où le client peut se déplacer. En appliquant debug au niveau du groupe FlexConnect, tous les AP qui font partie du groupe FlexConnect reçoivent cette demande de débogage.
• Les journaux sont collectés de manière centralisée au niveau du serveur syslog en fournissant l'adresse IP du serveur à partir du WLC.
• Si vous configurez un point d'accès FlexConnect avec un serveur Syslog configuré sur le point d'accès, après le rechargement du point d'accès et du VLAN natif autre que 1, au moment de l'initialisation, peu de paquets Syslog du point d'accès sont étiquetés avec l'ID de VLAN 1. Il s'agit d'un problème identifié.

Remarque : les débogages du pilote AP ne sont pas activés sur le WLC. Si vous avez accès à la console AP, les débogages du pilote peuvent être activés.

Voici les commandes de débogage sur l'interface de ligne de commande WLC :

(Cisco Controller) >debug flexconnect client ap ap-name{add|delete}mac-addr1 mac-addr2 mac-addr3 mac-addr4
(Cisco Controller) >debug flexconnect client apap-namesyslog{server-ip-address|disable}
(Cisco Controller) >debug flexconnect client groupgroup-name{add|delete}mac-addr1 mac-addr2 mac-addr3 mac-addr4
(Cisco Controller) >debug flexconnect client groupgroup-namesyslog{server-ip-address|disable}
(Cisco Controller) >show debug

Les commandes de débogage qui peuvent être entrées sur la console AP sont listées ici. Ces commandes sont applicables pour déboguer la console AP cliente quand elle est accessible. Si vous entrez ces commandes sur la console AP, les commandes ne sont pas communiquées au WLC.

AP#[no]debug condition mac-address mac-addr 
AP#[no]debug dot11 client

Restrictions

• La configuration AP n'est pas enregistrée lors des redémarrages.
• L'ajout et la suppression d'un point d'accès à un FlexConnectGroup ont un impact sur l'état de débogage de FlexConnect AP.

Remarque : il n'est pas possible de modifier le port syslog utilisé.

Vérifier

(Cisco Controller) >show logging 

Logging to Logger Queue : 

- Logging of system messages to Logger Queue : 
 - Effective Logging Queue filter level.......... debugging
- Number of Messages recieved for logging : 
 - Emergency severity............................ 0
 - Alert Severity................................ 0
 - Critical Severity............................. 0
 - Error Severity................................ 9
 - Warning Severity.............................. 6
 - Notice Severity............................... 210
 - Information Severity.......................... 8963
 - Debug Severity................................ 5
 - Total messages recieved....................... 9193
 - Total messages enqueued....................... 2815
 - Total messages dropped........................ 6378
Logging to buffer : 
- Logging of system messages to buffer : 
 - Logging filter level.......................... errors
 - Number of system messages logged.............. 9
 - Number of system messages dropped............. 
- Number of Messages dropped due to Facility .... 09195
- Logging of debug messages to buffer ........... Disabled
 - Number of debug messages logged............... 0
 - Number of debug messages dropped.............. 0
- Cache of logging ............................. Disabled
- Cache of logging time(mins) ................... 10080
- Number of over cache time log dropped ........ 0
Logging to console : 
- Logging of system messages to console : 
 - Logging filter level.......................... disabled
 - Number of system messages logged.............. 0
 - Number of system messages dropped............. 9204
 - Number of system messages throttled........... 0
- Logging of debug messages to console .......... Enabled
 - Number of debug messages logged............... 0
 - Number of debug messages dropped.............. 0
 - Number of debug messages throttled............ 0
Logging to syslog : 
- Syslog facility................................ local0
- Logging of system messages to syslog : 
 - Logging filter level.......................... debugging
 - Number of system messages logged.............. 2817
 - Number of system messages dropped............. 6387
- Logging of debug messages to syslog ........... Disabled
 - Number of debug messages logged............... 0
 - Number of debug messages dropped.............. 0
- Number of remote syslog hosts.................. 1
- syslog over tls................................ Disabled
- syslog over ipsec.............................. Disabled
- ipsec profile inuse for syslog................. none
 - Host 0....................................... 192.168.100.2
 - Host 1....................................... 
 - Host 2....................................... 
Logging of Debug messages to file : 
- Logging of Debug messages to file.............. Disabled
- Number of debug messages logged................ 0
- Number of debug messages dropped............... 0
Logging of traceback............................. Enabled
- Traceback logging level........................ errors
Logging of source file informational............. Enabled
Timestamping of messages......................... 
- Timestamping of system messages................ Enabled
 - Timestamp format.............................. Date and Time
- Timestamping of debug messages................. Enabled
 - Timestamp format.............................. Date and Time

[...]

(Cisco Controller) >

Pour afficher les paramètres globaux du serveur syslog pour tous les points d'accès qui rejoignent le contrôleur en entrant cette commande : show ap config global.

Des informations similaires à celles du texte suivant s'affichent :

AP global system logging host.................... 10.0.0.1

Pour afficher les paramètres AP-specific syslogserver pour un AP, utilisez la commande show ap config generalap-name.

Exemple :

(Cisco Controller) >show ap config general testAP

Cisco AP Identifier.............................. 1
Cisco AP Name.................................... testAP
[...]
Remote AP Debug ................................. Disabled
Logging trap severity level ..................... informational
KPI not configured .............................. 
Logging syslog facility ......................... kern
S/W Version .................................... 8.8.111.0
[...]

Informations connexes

• Guide de configuration du contrôleur sans fil Cisco, version 8.8
• Assistance technique de Cisco et téléchargements