Contenu

Introduction

Conditions préalables

Conditions requises

Components Used

Dépannage

Centre d’architecture de réseau numérique (DNA Center)

Étape 1. Vérifier l'état du service DNA Maps sur l'interface CLI DNAC

Étape 2. Vérifier que le serveur CMX est configuré sur l'interface utilisateur graphique Web de DNA Center et qu'il est accessible en envoyant une requête ping

Étape 3. Activer le niveau de débogage dna-maps

Étape 4. Commencer à collecter les journaux de service pour analyse

Étape 5. Déclenchez l'API DNAC pour envoyer la requête GET au serveur CMX. Sur l'interface utilisateur Web DNAC

Informations connexes

Introduction

Ce document décrit la configuration de base et le dépannage de la fonction de lecture sur une intégration serveur DNAC (Digital Network Architecture Center) et CMX (Connected Mobile Experience).

La lecture fait partie des services d'emplacement CMX qui fournissent un emplacement en direct de l'hôte final et le suivi sur les cartes d'étage sans fil qui peuvent être intégrées à la fonctionnalité DNA Analytics.

Conditions préalables

Conditions requises

Cisco vous recommande de prendre connaissance des rubriques suivantes :

- Le Centre ADN et le CMX doivent déjà être intégrés.

- Le plan de sol a été ajouté ou importé dans DNAC WebGUI > Design > Network Hierarchy section.

- Les hôtes finaux sont affichés sur la carte correspondante.

- Base Linux.

Components Used

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

- Centre d'analyse de l'ADN version 2.1.2.5

The information in this document was created from the devices in a specific lab environment. Tous les périphériques utilisés dans ce document ont été configurés à des fins de test. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Dépannage

Cette section fournit des informations que vous pouvez utiliser pour dépanner votre configuration.

Centre d’architecture de réseau numérique (DNA Center)

Étape 1. Vérifier l'état du service DNA Maps sur l'interface CLI DNAC

$ magctl appstack status | egrep "STATUS|dna-maps-service"

NAMESPACE      NAME                                   READY    STATUS      RESTARTS     AGE      IP            NODE             NOMINATED NODE

fusion         dna-maps-service-7dffd9d6b6-58qjb 1/1      Running     3            133d                                    <none>

Il est nécessaire d'avoir un service en état Prêt et En cours.

$ magctl service status dna-maps-service

Name: dna-maps-service-7dffd9d6b6-58qjb

Namespace: fusion

Node:

Start Time: Tue, 01 Dec 2020 19:43:27 +0000

Labels: pod-template-hash=3899858262

serviceName=dna-maps-service

version=7.14.117.62009

Annotations: <none>

Status: Running

IP:

Controlled By: ReplicaSet/dna-maps-service-7dffd9d6b6

Containers:

dna-maps-service:

Container ID: docker://ddbe6999823a6830983611c1900c4a5d255b40b5a1957bef2d2ecddcd606a0b9

Image: maglev-registry.maglev-system.svc.cluster.local:5000/fusion/dna-maps-service:7.14.117.62009

Image ID: docker-pullable://maglev-registry.maglev-system.svc.cluster.local:5000/fusion/dna-maps-service@sha256:0b6510c1c29d260492647b586ffb714f1689ae7ec9d5f63905bb0ad4dac738c9

Ports: 22222/TCP, 11111/TCP

Host Ports: 0/TCP, 0/TCP

State: Running

.

.

.

.

Conditions:

Type               Status

Initialized        True

Ready              True

ContainersReady    True

PodScheduled       True

.

.

.

.

Events: <none>

Note: Il est recommandé d'exécuter ce jeu de commandes deux ou trois fois (toutes les 10 minutes) pour s'assurer que le service n'a pas de redémarrages constants. Si le service est rechargé constamment, référez-vous à la deuxième commande pour vérifier la dernière section Événements de service pour plus de détails.

Étape 2. Vérifier que le serveur CMX est configuré sur l'interface utilisateur graphique Web de DNA Center et qu'il est accessible en envoyant une requête ping

1. Cliquez sur le bouton  en haut à gauche de l'interface utilisateur graphique Web DNAC.

2. Accédez à System > Settings > DNA Spaces/CMX Servers.

3. Confirmez que les serveurs CMX sont ajoutés à la section appropriée et marqués comme statut enregistré.

4. À partir de DNAC CLI, envoyez une requête ping au serveur CMX.

5. Cliquez sur le bouton  en haut à gauche de l'interface utilisateur graphique Web DNAC.

6. Accédez à Design > Network Settings > Wireless.

7. Confirmez dans la section Espaces d'ADN/serveurs CMX que le serveur souhaité est Sélectionné et Enregistré sur la hiérarchie globale ou sur le site souhaité.

Étape 3. Activer le niveau de débogage dna-maps

1. Cliquez sur le bouton  en haut à gauche de l'interface utilisateur graphique Web DNAC

2. Accédez à Système > Paramètres > Journaux de débogage.

3. Dans la liste Service, sélectionnez dna-maps-service. Sélectionnez ensuite Déboguer en tant que Niveau de journalisation et définissez un horodatage.

4. Cliquez sur Enregistrer et le débogage de notre service sélectionné sera automatiquement lancé.

Note: Avant DNAC version 2.1.2.x (Wolverine), l'exécution du débogage dna-maps n'est pas prise en charge par l'interface utilisateur Web DNAC. Il est donc nécessaire d'activer les débogages de service manuellement sur l'interface CLI DNAC

Pour générer le niveau de débogage sur dna-maps-service, nous devons nous connecter à l'interface de ligne de commande DNAC et modifier les paramètres de l'API à la valeur requise :

Générer un jeton d'authentification

$ curl -s -k -u admin -X POST https://

/dna/system/api/v1/auth/token  | jq -r .Token

Utilisez la commande CURL suivante pour activer le débogage pour le service dna-maps. Assurez-vous que la réponse revient en 200 OK

$ curl -k -i -X POST 'https://

/api/v1/dna-maps-service/testing/logging/level?loggingLevel=5 ' --header 'X-Auth-Token:

' --form 'Content-Type='

Exemple :

$ curl -k -i -X POST 'https://x.x.x.x/api/v1/dna-maps-service/testing/logging/level?loggingLevel=5 ' --header 'X-Auth Token:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiI1ZjQ2NDZkOGE3NmQ4ZDAwY2UzNzA4ZWYiLCJhdXRoU291cmNlIjoiaW50ZXJuYWwiLCJ0ZW5hbnROYW1lIjoiVE5UMCIsInJvbGVzIjpbIjVmNDY0NmQ4YTc2ZDhkMDBjZTM3MDhlZSJdLCJ0ZW5hbnRJZCI6IjVmNDY0NmQ3YTc2ZDhkMDBjZTM3MDhlYyIsImV4cCI6MTYxODQyNDE3OCwiaWF0IjoxNjE4NDIwNTc4LCJqdGkiOiIwYTU4YWVmYS03ZTgwLTRlOGUtODg4OC0wODBiNTk4ZWM0NTciLCJ1c2VybmFtZSI6ImFkbWluIn0.Li0BGN3VeVRIeWlrUsd94hnQt0xlCx0fJHCAtg0pQ7wx9MMC1UMImcuFabHXUgVmHcDrIAgds5GyBnNaPKfgs9qsvmjhJyVHZdT7_f8YJ2BihkgEokfJbIkcb7Ulp7AqIzceACYpZXeBmfQtDCNDyJveoz1XLaKu69JYzArf8UaPzg3jHVoq9m6N5ohypMC-pmsp87-SbOoD-2x660K7Ankzqqtxw4vhyAp0atcYujPg0-8G4fkOPrLE-Cw6SXb8YonrjWVPbrBwfqENTr6sUj7SrPlH_CVBGzRG20YxaYvn_yeGG8E1pbCgDEK2UjyRaH-FM9BHIqY3TNUIf0mdvQ' --form 'Content-Type='

HTTP/1.1 100 Continue

HTTP/1.1 200 OK

Étape 4. Commencer à collecter les journaux de service pour analyse

$ magctl service logs -rf dna-maps-service | lql

Cela va commencer à afficher les journaux sur l'interface de ligne de commande, il est recommandé d'enregistrer la journalisation sur le terminal de l'application ou d'ajouter l'option > log.txt à la fin de la commande pour stocker automatiquement les sorties dans un fichier journal sur le chemin /home/maglev.

Étape 5. Déclenchez l'API DNAC pour envoyer la requête GET au serveur CMX. Sur l'interface utilisateur Web DNAC

1. Accédez à la carte Floor où se trouve un hôte d'extrémité non fonctionnel.

2. Cliquez sur l'icône bleue de l'hôte final. Ceci ouvrira un nouvel onglet latéral avec les informations Client 360 avec l'adresse MAC, l'adresse IP et les informations associées.

3. Cliquez à nouveau sur l'onglet Lecture.

À ce stade, DNA Center afficherait sur l'interface de ligne de commande les débogages du service principal avec la conversion entre DNAC et CMX Server.

Exemple :

|2021-03-31 16:23:13,024 | DEBUG | scheduler-12 | | o.s.web.client.RestTemplate | - Created GET request for "https://x.x.x.x/api/location/v3/clients/count?associatedOnly=true "

|2021-03-31 16:23:13,024 | DEBUG | scheduler-12 | | o.s.web.client.RestTemplate | - Setting request Accept header to [application/xml, text/xml, application/json, application/*+xml, application/*+json]

|2021-03-31 16:23:16,028 | DEBUG | scheduler-12 | | o.s.web.client.RestTemplate | - GET request for "https://x.x.x.x/api/location/v3/clients/count?associatedOnly=true " resulted in 503 (Service Unavailable); invoking error handler

|2021-03-31 16:23:16,030 | ERROR | scheduler-12 | | c.c.a.m.c.p.i.CMXVerificationRestClientImpl | - Error occurred during interaction with CMX to get client counts for CMX IpAddr x.x.x.x org.springframework.web.client.HttpServerErrorException: 503 Service Unavailable at org.springframework.web.client.DefaultResponseErrorHandler.handleError(DefaultResponseErrorHandler.java:89)

~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.handleResponse(RestTemplate.java:708)

~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:661)

~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:621)

~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.exchange(RestTemplate.java:539)

~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at com.cisco.apicem.maps.cmx.proxy.impl.CMXVerificationRestClientImpl.checkCMXServiceability(CMXVerificationRestClientImpl.java:169)

~[cmx-proxy-7.14.264.62702.jar:7.14.264.62702] at com.cisco.csg.ngmaps.impl.apicem.integration.diagnostic.cmx.CMXDiagnosticJob.diagnose(CMXDiagnosticJob.java:114)

~[classes/:na] at jdk.internal.reflect.GeneratedMethodAccessor118.invoke(Unknown Source) ~[na:na]

Attention : Une fois le dépannage effectué, il est nécessaire de rétablir le niveau de débogage par défaut au cas où il serait configuré sur l'interface CLI DNAC

$ curl -k -i -X POST 'https://

/api/v1/dna-maps-service/testing/logging/level?loggingLevel=3 ' --header 'X-Auth-Token:

' --form 'Content-Type='

Exemple :

$ curl -k -i -X POST 'https://x.x.x.x/api/v1/dna-maps-service/testing/logging/level?loggingLevel= 3' --header 'X-Auth-Token:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiI1ZjQ2NDZkOGE3NmQ4ZDAwY2UzNzA4ZWYiLCJhdXRoU291cmNlIjoiaW50ZXJuYWwiLCJ0ZW5hbnROYW1lIjoiVE5UMCIsInJvbGVzIjpbIjVmNDY0NmQ4YTc2ZDhkMDBjZTM3MDhlZSJdLCJ0ZW5hbnRJZCI6IjVmNDY0NmQ3YTc2ZDhkMDBjZTM3MDhlYyIsImV4cCI6MTYxODQyNDE3OCwiaWF0IjoxNjE4NDIwNTc4LCJqdGkiOiIwYTU4YWVmYS03ZTgwLTRlOGUtODg4OC0wODBiNTk4ZWM0NTciLCJ1c2VybmFtZSI6ImFkbWluIn0.Li0BGN3VeVRIeWlrUsd94hnQt0xlCx0fJHCAtg0pQ7wx9MMC1UMImcuFabHXUgVmHcDrIAgds5GyBnNaPKfgs9qsvmjhJyVHZdT7_f8YJ2BihkgEokfJbIkcb7Ulp7AqIzceACYpZXeBmfQtDCNDyJveoz1XLaKu69JYzArf8UaPzg3jHVoq9m6N5ohypMC-pmsp87-SbOoD-2x660K7Ankzqqtxw4vhyAp0atcYujPg0-8G4fkOPrLE-Cw6SXb8YonrjWVPbrBwfqENTr6sUj7SrPlH_CVBGzRG20YxaYvn_yeGG8E1pbCgDEK2UjyRaH-FM9BHIqY3TNUIf0mdvQ' --form 'Content-Type='

HTTP/1.1 100 Continue

HTTP/1.1 200 OK

Informations connexes

- Notes de version de Cisco DNA Assurance