Compréhension de divers problèmes de corruption Flash AP-IOS

Introduction

Ce document décrit comment gérer les problèmes de corruption Flash signalés sur les points d'accès Cisco basés sur IOS.  

Conditions préalables

  

Conditions requises

Cisco vous recommande d'avoir des connaissances de base sur :

• Contrôleur LAN sans fil AireOS (WLC) 
• Points d'accès légers
• Python 2.7 (rien de plus)

Components Used

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

• Cisco Aironet 1040, 1140, 1250, 1260, 1600, 1700, 2600, 2700, 3500, 3600, 3700, 700, AP Points d'accès intérieurs des gammes 801 et AP802
• Points d'accès sans fil industriels et extérieurs Cisco Aironet 1520 (1522, 1524), 1530, 1550 (1552), 1570 et Industrial Wireless 3700

Note: Il y a une prévalence beaucoup plus élevée dans les modèles de points d'accès Wave1 comme 1700/2700/3700 et 2600/3600 sur ce problème par rapport aux autres types de points d'accès en raison du type de matériel Flash.  

  

Informations générales

Selon FN70330 - AP IOS bloqué en raison d'un problème de corruption de la mémoire flash, en raison d'un certain nombre de bogues logiciels et d'un AP en fonctionnement normal, le système de fichiers flash sur certains AP IOS peut devenir corrompu au fil du temps. Ceci est observé surtout après une mise à niveau vers le WLC mais pas nécessairement limité à ce scénario. 

Le point d'accès fonctionne correctement, avec le client de maintenance, etc., alors que sur cet état de problème qui n'est pas facilement détectable. 

Solution 

Travail avant la mise à niveau du WLC.

Afin d'identifier les points d'accès affectés sur le réseau et de les réparer avant une mise à niveau. Vous devez exécuter le contrôleur WLAN

Attention : Avant la mise à niveau, lisez ce document.

Logique de rouleau WLAN

Chaque fois que le script est exécuté, il vérifie si la mémoire flash d'un point d'accès est accessible ou non. 

S'il est accessible, il exécute la commande fsck flash:

• Si tout va bien, passez au point d'accès suivant
• sinon, répétez la commande jusqu'à 4 fois. En cas d'échec, le script le signale sur le rapport final et ce point d'accès peut être récupéré. 

s'il est inaccessible

• le script signale le point d'accès sur son rapport final et ce point d'accès peut être récupéré. 

S'il est accessible, AP vérifiera les valeurs MD5 pour les fichiers critiques. 

• Si toutes les valeurs sont correctes, passez au point d'accès suivant
• sinon, le script le signalera dans le rapport final et ce point d'accès est admissible à être récupéré. 

Le script doit être exécuté trois fois. 

1. Exécutez la commande 
   • Le script crée la base de données MD5 en examinant la valeur de somme de contrôle MD5 pour chaque fichier sur l'AP. La valeur MD5 finale pour un fichier spécifique est celle qui a le plus de succès sur la même famille d'AP sur le WLC. 
2. Exécutez la commande 
   • Le script compare les valeurs de somme de contrôle MD5 à sa base de données. Si la valeur correspond, alors le fichier est ok, si ce n'est pas le point d'accès est marqué afin de récupérer sur la troisième exécution
3. Exécutez la commande  
   
   • Le script déclenche la commande test capwap image capwap uniquement pour les AP qui ont été marqués au cours des deux étapes précédentes.

Remarque : cette méthode de récupération entraîne le rechargement de l'AP une fois l'image téléchargée et installée. Assurez-vous de l'exécuter dans une fenêtre de maintenance. 

Installation/préparation du contrôleur WLAN 

1.   Téléchargez l'outil d'interrogation WLAN.

Remarque : si vous téléchargez la dernière version de l'outil de contrôleur de réseau local sans fil à partir du lien ci-dessus, vous pouvez ignorer les étapes 2 et 3. Cette version installera automatiquement tous les composants requis pour votre outil de contrôleur WLAN. Si vous avez une version antérieure (.rar) de WLAN Poller, suivez les étapes 2 et 3 ci-dessous.

2.   Déplacer le fichier vers un dossier spécifique dans lequel stocker les fichiers de l'analyseur WLAN

3.   Pour obtenir des instructions sur l'installation du script, cliquez sur le lien suivant :

Pour un guide détaillé sur l'ordinateur Windows 10, cliquez ici

Pour obtenir un guide détaillé sur MAC OS cliquez ici

4.   Préparer le fichier « config.ini » 

Une fois l'installation terminée et les fichiers générés. Nous devons modifier le fichier "config.ini »

Spécifier le mode de connexion WLC/AP 

; config global mode for WLC and AP connection: "ssh" or "telnet"
mode: ssh
ap_mode: ssh

Spécifier les informations d'identification WLC/AP 

; set global WLC credentials
wlc_user: <wlc_user>
wlc_pasw: <wlc_pasw>

; set global AP credentials
ap_user: <ap_user>
ap_pasw: <ap_pasw>
ap_enable: <ap_enable>

Pour la vérification/restauration Flash, nous avons les options suivantes : 

Pour identifier les AP affectés, utilisez : 

; ap file system checks (WARNING: recover will force IOS image download and AP reload) 
ap_fs_check: True
ap_fs_recover: False

Pour récupérer les points d'accès, utilisez : 

; ap file system checks (WARNING: recover will force IOS image download and AP reload) 
ap_fs_check: True
ap_fs_recover: True

Spécifier les informations WLC

Dans cet exemple, le nom du WLC est « 2504-WLC ». Vous pouvez trouver ces informations sur la page WLC Monitor. 

; WLC sections must be named as [WLC- 
      
        ] 
      
[WLC-2504-Rafis]
active: True
ipaddr: 
     
     

Vous pouvez ajouter plusieurs WLC, si c'est le cas, copiez/collez la syntaxe ci-dessus à l'aide de nouvelles informations WLC. 

Note: Vous n'avez pas besoin de spécifier de liste de points d'accès. Le script récupère l'AP du WLC. 

Exécuter le contrôleur WLAN 

À partir du répertoire où les fichiers de configuration ont été créés (section précédente, étape 3). Utilisez la commande suivante : wlanpoller —cli-logging

Une fois le script terminé. Il fournira un résumé comme suit : 

============================================================
Summary
============================================================
Total APs : 1
Processed APs : 1
Failed APs : 0
============================================================
Errors
============================================================
AP MD5 checksum mismatch : 2
AP FSCK recover : 1
============================================================

Remarque : Rappelez-vous que le script doit être exécuté 2 fois pour avoir des informations précises sur le nombre d'AP affectés

Sortie du rouleau WLAN

Sur le chemin d'accès où le script a été exécuté. Il crée les fichiers suivants. 

• ap_md5_db.json : Base de données MD5
• Journal des dossiers
  • Il stocke tous les affichages de sortie par l’analyseur WLAN sur le terminal.
• Données du dossier

Il divise les rapports en deux chemins : <année> / <mois> / <jour>

Fichier: <timestamp>_ap_fs.csv - Récapitulatif des contrôles exécutés sur les points d'accès et leurs résultats

Description des colonnes 

• nom_ap : Nom de l'AP.
• type_ap : Modèle AP.
• ap_uptime : Temps de fonctionnement du point d'accès (jours).
• ap_ios_ver : Version IOS.
• fs_free_bytes : Nombre d'octets libres dans le système de fichiers flash.
• flash_issue : Cette propriété a la valeur True si une corruption de mémoire flash a été observée.
• fs_zéro_size : Cette propriété a la valeur True lorsque le système de fichiers flash a été détecté et affiche "-" - (show file system - command)
• fsck_fail : True si la vérification du système de fichiers a échoué. - (flash fsck : -commande )
• fsck_Occupé : Vrai périphérique ou ressource occupé lors de l'exécution de flash fsck.
• fsck_recover : True lorsqu'une erreur s'est produite sur fsck mais qu'elle est corrigée dans fsck suivant.
• fsck_tries : Nombre de tentatives de fsck pour récupérer l'AP (max 4)
• md5_fail : Cette propriété a la valeur True lorsque md5 au moins un fichier est différent de celui stocké dans la base de données.
• rcv_trigger : True lorsque AP a essayé de télécharger l'image à partir du WLC lorsque le problème a été détecté et que la récupération a été activée.

Fichier: <timestamp>_ap_md5.csv Détails des valeurs de somme de contrôle MD5 de tous les fichiers (sur tous les AP)

   

Description des colonnes 

• nom_ap : Nom de l'AP.
• type_ap : Modèle AP.
• ap_uptime : Temps de fonctionnement du point d'accès (jours).
• nom de fichier : Nom du fichier image IOS.
• md5_hash : valeur md5 du nom de fichier.
• is_good : La valeur True md5 correspond à la valeur stockée dans la base de données. Erreur de correspondance md5 fausse observée pour ce fichier.
• is_zero_octets : True lorsque le nom de fichier a 0 octets en fonction de la somme de contrôle md5checksum, le fichier est incorrect.
• md5_error : Erreur lors de la récupération de la valeur md5 s'il n'était pas possible d'obtenir md5 pour le nom de fichier.

Remarque : il peut y avoir des scénarios dans lesquels le script de récupération du contrôleur WLAN ne peut pas récupérer certains AP et ces AP restent marqués comme ayant échoué dans le rapport. Dans ces scénarios, la récupération manuelle des points d'accès par telnet/SSH/console dans l'interface de ligne de commande des points d'accès est recommandée. Veuillez ouvrir TAC SR si vous avez besoin d'aide pour ce processus. Associez toutes les sorties générées par l'analyseur WLAN au boîtier. 

  

Point d'accès bloqué

Si connexion SSH/telnet

Vous pouvez suivre les étapes suivantes pour tenter de récupérer le point d'accès : 

• arrêter le redémarrage automatique de capwap

AP# debug capwap console cli
AP# debug capwap client no-reload

• Formatez la mémoire Flash, si vous réussissez, vous pouvez passer à l'étape suivante sinon quitter.

AP# format flash:

• Charger une image de récupération. Image de récupération ici. 

archive download-sw /overwrite tftp://<IP address>/<file name>

• Vérifiez MD5 sur l'image de récupération chargée, si la valeur est correcte, passez à l'étape suivante. 

 AP# verify /md5 flash:/<image directory>/<image file>

Vous pouvez comparer la valeur de l'interface de ligne de commande (CLI) à la valeur de la page Web de cisco. 

• Définir la variable de démarrage sur l'image Récupération récemment téléchargée

AP#show boot
AP(config)#boot system flash:/RCV/RCV-image

• Recharger AP

Si l'état Rommon AP

Vous pouvez essayer la même chose que ci-dessus, mais à partir des commandes de démarrage. Voici les commandes que vous pouvez suivre :

ap: tftp_init
ap: ether_init
ap: flash_init
ap: format flash:
ap: set IP_ADDR <IP Address>
ap: set NETMASK <mask>
ap: set DEFAULT_ROUTER < default router >
ap: tar -xtract tftp://<IP address>/<file name> flash:
ap: set BOOT flash:/
     
      
      
 
     ap: boot

Impossible de SSH/telnet

Le port de commutation de renvoi, peu de fois, vérifie si cela aide. 

Guide pas à pas pour installer l'analyseur WLAN sur une machine Windows 10 - 64 bits

Remarque : si vous téléchargez la dernière version de l'outil de contrôleur WLAN, vous pouvez ignorer cette section.

1. Téléchargez et installez Python 2.7.14 à partir du lien suivant
2. Téléchargez et installez le compilateur C++ pour les clients Python pour Windows à partir du lien suivant
3. Une fois installé, accédez aux Paramètres système du Panneau de configuration et sélectionnez Paramètres système avancés (assurez-vous que tous les terminaux Windows sont fermés) :

4. Dans la fenêtre qui apparaît, sélectionnez « Variables d'environnement... ».

5. Dans ce champ, sélectionnez la variable ” Chemin d'“ dans les « Variables système » et cliquez sur Modifier...

6. Dans cette fenêtre, ajoutez le chemin d'accès au répertoire de base où vous avez installé Python 2.7.14.0 et le répertoire de base C:\<Répertoire de base>\Scripts afin que la ligne de commande de l'ordinateur portable reconnaisse les commandes python : Cliquez sur Nouveau et ajoutez le chemin manuellement.

Fermez toutes les fenêtres de paramètres et les terminaux (invite de commande) ouverts le cas échéant

7.  Vérifiez si pip est installé, ouvrez un nouveau terminal et entrez : pip —version

Une autre option consiste à vérifier s'il existe un fichier appelé pip ou pip2 ou pip2.7 sur le dossier : C:\Python27\Scripts 

• Si tout va bien allez à la section upgrade pip. Étape 8
• Si vous recevez une erreur ou si vous ne trouvez pas le dossier/les fichiers, continuez à lire. 

Installer pip

• Fermez le terminal et installez pip à partir de la liaison ci-dessous
• Téléchargez et enregistrez le fichier “ get-pip.py ”. Sur le site Web rechercher

• Copiez le fichier “ get-pip-py ” dans le dossier “ C:\Python27 ”

Note: Si vous copiez et collez le contenu à partir du site Web, assurez-vous qu'il n'a pas l'extension py.txt, vérifiez-le avec un répertoire sur le dossier “ C:\Python27 ”, si cela se produit, renommez le fichier à partir du terminal.

Renommez le fichier à l'aide de la commande suivante :

  

• Sur le même dossier “ C:\Python27 ” exécuter : python get-pip.py

8. Mettez PIP à niveau vers la dernière version à l'aide de la commande suivante : pip install —upgrade pip

9. Les étapes ci-dessus installeront tous les paquets nécessaires. Ouvrez maintenant une ligne de commande pour Windows et accédez au répertoire dans lequel vous avez stocké le fichier de l'analyseur WLAN .tar.gz (utilisez : cd <Chemin d'accès au répertoire>)

10. Installez le script à l'aide de la commande “ pip install wlanpoller-0.7.1.dev90_md5rcv.tar.gz ”

10. Créez un nouveau répertoire que vous souhaitez stocker toutes les informations de l'analyseur WLAN.

11. Sur la ligne de commande “, ” accédez à ce répertoire et exécutez la commande “ wlanpoller —generate-configs ” pour créer les variables de configuration et les fichiers de configuration nécessaires à l'exécution du script :

Cliquez ici pour continuer avec le fichier config.ini

Guide pas à pas pour installer l'analyseur WLAN sur MacBook version 10.11 ou ultérieure

Remarque : si vous téléchargez la dernière version de l'outil de contrôleur WLAN, vous pouvez ignorer cette section.

Le système d'exploitation MAC a déjà installé python. Pour que nous puissions installer le reste des paquets, veuillez suivre les étapes suivantes

1. Accédez au dossier dans lequel se trouve le fichier de l'analyseur WLAN : cd <chemin>
2. Une fois la commande suivante exécutée : sudo pip install wlanpoller-<version>.tar.gz Pour cela vous avez besoin d'un mot de passe sudo (mot de passe MACBook Admin)
3. Créer un répertoire pour organiser tous les fichiers que le script va créer
   • mkdir <nom du répertoire>
   • cd <nom du répertoire>
4. Exécutez la commande suivante afin que le script prépare tous les répertoires/fichiers nécessaires à l'exécution du script : wlanpoller —generate-configs

Cliquez ici pour continuer avec le fichier config.ini

 Restrictions de chargement de réseau local sans fil

• L'analyseur WLAN n'est testé que sur les systèmes Windows 10 64 bits et Apple MacBook version 10.11 ou ultérieure. 
• Si vous n'utilisez pas la version plus récente de l'outil WLANPoller, seule la version Python 2.7 est prise en charge sur les versions plus anciennes.
• Si les noms des AP ont des caractères spéciaux comme  les erreurs ci-dessous apparaissent lors de l'exécution du script. L'utilisateur doit supprimer manuellement les caractères spéciaux du nom de l'AP pour résoudre le problème.