Utiliser l'outil ARN de Catalyst Center

Introduction

Ce document décrit l'outil d'évaluation du réseau rapide Catalyst Center (anciennement Cisco DNA Center).

Cet outil a été conçu par l'équipe Cisco CX Customer Success.

Conditions préalables

Exigences

Un ordinateur connecté à Catalyst Center et disposant d'un nom d'utilisateur/mot de passe pour authentifier la collecte d'informations préalables.

Composants utilisés

Les informations contenues dans ce document sont basées sur la plate-forme Catalyst Center.

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.

À propos de RNA Tool

L'outil RNA effectue diverses vérifications qui ciblent l'utilisation des fonctionnalités et les meilleures pratiques sur Catalyst Center, ce qui permet à l'équipe Cisco Customer Success de comprendre quelles fonctionnalités sont utilisées et quelles fonctionnalités pourraient être activées pour fournir des avantages supplémentaires à votre organisation. L'exécution de l'outil est simple et toutes les informations sont collectées uniquement à partir de Catalyst Center dans le cadre des bilans de santé effectués par l'équipe de réussite du client. Il peut être exécuté à partir de n'importe quel ordinateur ayant accès à Catalyst Center. L'outil exécute un script Go qui se trouve sur ce lien :

github CiscoDevNet / catalyst-center-rna

Une fois la collecte terminée, l'outil RNA crée un fichier « dnac_rna_hc_collection.zip » qui doit être partagé avec votre spécialiste Cisco Customer Success pour le traiter et fournir une analyse. 

Comment exécuter l'outil ARN

Étape 1. Téléchargez le fichier correspondant à partir de ce lien :

• catalyst-center-rna_1.3.1_Linux.zip
• catalyst-center-rna_1.3.1_Windows.zip
• catalyst-center-rna_1.3.1_MacOS.zip

Conseil : sous MacOS, vous pouvez recevoir le message d'avertissement suivant : le fichier ne peut pas être ouvert car le développeur ne peut pas être vérifié. Pour exécuter le collecteur permettre l'exécution à partir de préférences > confidentialité et sécurité, faites défiler jusqu'à la section sécurité et vous voyez le message "collecteur" a été bloqué ..., cliquez sur Ouvrir quand même et exécutez le collecteur à nouveau. Une fenêtre contextuelle peut s'afficher et vous demander si vous souhaitez l'exécuter. Cliquez sur Oui. Ensuite, vous pouvez exécuter le script du collecteur.

Étape 2. Extrayez les fichiers et exécutez le collecteur.

Étape 3. Fournissez l'adresse IP, le nom d'utilisateur et le mot de passe de Catalyst Center et attendez qu'ils soient renseignés. Un fichier nommé 'dnac_rna_hc_collection.zip' est créé sous '/Users/ /'  folder. 

This location could be different than the one where the collector file was downloaded to. 

Conseil : l'emplacement exact est indiqué à la fin de l'exécution.

Remarque : en fonction de votre système d'exploitation, vous devez autoriser l'outil à s'exécuter et à créer le fichier mentionné précédemment.

Étape 4. Une fois le fichier .zip créé, assurez-vous de le partager avec l'organisation Cisco Customer Success par l'une des méthodes suivantes

• Échange de documents Cisco
  Accédez à https://ciscoshare.cisco.com et téléchargez le fichier dans le dossier précédemment créé par l'équipe Cisco Customer Success.
• Téléchargez-le sur le dossier TAC fourni par l'équipe de réussite du client
  Accédez à https://mycase.cloudapps.cisco.com/case et téléchargez le fichier directement dans le dossier.
  Pour plus d'informations sur les méthodes disponibles pour télécharger le fichier, cliquez ici

Remarque : pour les deux méthodes, l'accès précédent doit être accordé par l'équipe de réussite du client.

Contrôles effectués

Plusieurs contrôles sont collectés pour évaluer l'utilisation des fonctionnalités et les meilleures pratiques de configuration. Les domaines suivants peuvent être revus à l'aide d'API publiques et privées :

• Version et licence
• Intégration avec d'autres solutions
• Utilisation des fonctionnalités
• Vérification de la configuration

Exemple des journaux qui peuvent être vus pendant l'exécution de l'outil. Notez que le nombre de vérifications peut varier en fonction de la version de l'outil que vous utilisez. Pour obtenir la dernière version, cliquez ici

5:39PM INF Catalyst Center host host=xxx.xxx.xxx.xxx
5:39PM INF Catalyst Center username user=demo
5:39PM INF Authenticating to Catalyst Center...
5:39PM INF Authentication successfull
==============================
Fetching request batch 1
==============================
5:39PM INF fetching /dna/intent/api/v1/network-device/count...
5:39PM INF fetching /dna/intent/api/v1/compliance/detail...
5:39PM INF fetching /dna/intent/api/v1/client-health...
5:39PM INF fetching /dna/intent/api/v1/site...
5:39PM INF fetching /dna/intent/api/v1/network-device...
5:39PM INF fetching /dna/intent/api/v1/device-health...
5:39PM INF fetching /dna/intent/api/v1/network-device...
5:39PM INF fetching /dna/intent/api/v1/site/count...
5:39PM INF fetching /dna/intent/api/v1/wireless/profile...
5:39PM INF fetching /dna/intent/api/v1/enterprise-ssid...
5:39PM INF /dna/intent/api/v1/network-device/count > Complete
5:39PM INF /dna/intent/api/v1/compliance/detail > Complete
5:39PM INF /dna/intent/api/v1/network-device > Complete
5:39PM INF /dna/intent/api/v1/network-device > Complete
5:39PM INF /dna/intent/api/v1/site/count > Complete
5:39PM INF /dna/intent/api/v1/wireless/profile > Complete
5:39PM INF /dna/intent/api/v1/device-health > Complete
5:39PM INF /dna/intent/api/v1/enterprise-ssid > Complete
5:39PM INF /dna/intent/api/v1/client-health > Complete
5:39PM INF /dna/intent/api/v1/site > Complete
==============================
Fetching request batch 2
==============================
5:39PM INF fetching /dna/intent/api/v1/issues...
5:39PM INF fetching /api/system/v1/catalog/release-channel/dnac/latest...
5:39PM INF fetching /dna/home...
5:39PM INF fetching /dna/intent/api/v1/licenses/smartAccounts...
5:39PM INF fetching /dna/intent/api/v1/licenses/device/count?device_type=Wireless%20Controller...
5:39PM INF fetching /api/system/v1/maglev/packages...
5:39PM INF fetching /dna/intent/api/v1/template-programmer/template...
5:39PM INF fetching /dna/intent/api/v1/licenses/device/count?device_type=Switches%20and%20Hubs...
5:39PM INF fetching /dna/intent/api/v1/image/importation...
5:39PM INF fetching /api/system/v1/catalog/release-channel/active...
5:39PM INF /api/system/v1/catalog/release-channel/dnac/latest > Complete
5:39PM INF /dna/home > Complete
5:39PM INF /dna/intent/api/v1/licenses/smartAccounts > Complete
5:39PM INF /api/system/v1/catalog/release-channel/active > Complete
5:39PM INF /api/system/v1/maglev/packages > Complete
5:39PM INF /dna/intent/api/v1/licenses/device/count?device_type=Switches%20and%20Hubs > Complete
5:39PM INF /dna/intent/api/v1/template-programmer/template > Complete
5:39PM INF /dna/intent/api/v1/licenses/device/count?device_type=Wireless%20Controller > Complete
5:39PM INF /dna/intent/api/v1/image/importation > Complete
==============================
Fetching request batch 3
==============================
5:40PM INF fetching /api/telemetry-agent/v1/membership/info...
5:40PM INF fetching /api/v2/data/customer-facing-service/summary/ConnectivityDomain...
5:40PM INF fetching /api/v1/reasoner/cloud-connect/info...
5:40PM INF fetching /api/v1/commonsetting/global/-1...
5:40PM INF fetching /api/kairos/v1/config/data/read...
5:40PM INF fetching /api/system/v1/systemupdater/common/availabe_update_info...
5:40PM INF fetching /api/v1/inventory/global-settings?propertyName=device_controllability...
5:40PM INF fetching /api/system/v1/systemupdater/common/update_status...
5:40PM INF fetching /api/v1/disasterrecovery/dr/system/details...
5:40PM INF fetching /api/system/v1/maglev/nodes/config...
5:40PM INF /api/v1/reasoner/cloud-connect/info > Complete
5:40PM INF /api/kairos/v1/config/data/read > Complete
5:40PM INF /api/v1/commonsetting/global/-1 > Complete
5:40PM INF /api/telemetry-agent/v1/membership/info > Complete
5:40PM INF /api/system/v1/maglev/nodes/config > Complete
5:40PM INF /api/v1/inventory/global-settings?propertyName=device_controllability > Complete
5:40PM INF /api/system/v1/systemupdater/common/update_status > Complete
5:40PM INF /api/system/v1/systemupdater/common/availabe_update_info > Complete
5:40PM INF /api/v2/data/customer-facing-service/summary/ConnectivityDomain > Complete
5:40PM INF /api/v1/disasterrecovery/dr/system/details > Complete
==============================
Fetching request batch 4
==============================
5:40PM INF fetching /api/v1/ipam/configuration...
5:40PM INF fetching /api/system/v1/maglev/services/summary...
5:40PM INF fetching /api/endpoint-analytics/v1/eps/classification/rule?ruleType=Custom%20Rule...
5:40PM INF fetching /api/v1/system/health/cisco-ise...
5:40PM INF fetching /api/v2/data/customer-facing-service/summary/Segment...
5:40PM INF fetching /api/assurance/v1/webex/oauth-status...
5:40PM INF fetching /api/v1/aca-controller-service/getAcaVnSummary...
5:40PM INF /api/system/v1/maglev/services/summary > Complete
5:40PM INF /api/v2/data/customer-facing-service/summary/Segment > Complete
5:40PM INF /api/v1/aca-controller-service/getAcaVnSummary > Complete
5:40PM INF /api/v1/system/health/cisco-ise > Complete
5:40PM INF /api/endpoint-analytics/v1/eps/classification/rule?ruleType=Custom%20Rule > Complete
5:40PM INF /api/assurance/v1/webex/oauth-status > Complete
5:40PM INF /api/v1/ipam/configuration > Complete
==============================
Complete
==============================
5:40PM INF Collection complete.
5:40PM INF Please provide /Users/alejarui/health_checks_dnac_collector.zip to Cisco Services for further analysis.

Saving session...
...copying shared history...
...saving history...truncating history files...
...completed.

[Process completed]

En cas d'échec d'un appel API, l'état HTTP peut être affiché et trois tentatives consécutives peuvent être effectuées avant de passer à l'appel suivant.

5:39PM WRN request failed for /dna/intent/api/v1/issues. Retrying after 10 seconds. error="received HTTP status 500"
5:39PM WRN request failed for /dna/intent/api/v1/issues. Retrying after 10 seconds. error="received HTTP status 500"
5:39PM WRN request failed for /dna/intent/api/v1/issues. Retrying after 10 seconds. error="received HTTP status 500"
5:40PM ERR Error fetching data. error="request failed for /dna/intent/api/v1/issues: received HTTP status 500" 

Versions ARN - journal des modifications

github CiscoDevNet / catalyst-center-rna / commits

Sécurité

Veuillez noter les points suivants concernant la collecte de données effectuée par cet outil :

• Toutes les requêtes effectuées par cet outil sont également effectuées par l'interface graphique de Catalyst Center, il n'y a donc pas de plus de risque que de cliquer sur l'interface graphique.
• Les requêtes envoyées à Catalyst Center sont traitées par lots et limitées afin de réduire la charge sur Cisco Catalyst Center.
• Catalyst Center dispose de protections internes pour se protéger contre l'utilisation excessive des API.
• L'interaction API dans Catalyst Center n'a aucun impact sur le comportement de transfert des données.
• Cet outil est disponible sous Cisco Sample Code License afin que vous puissiez avoir accès au référentiel ici
• Les informations d'identification ne sont utilisées qu'au point de collecte et ne sont stockées d'aucune manière.
• Toutes les données fournies à Cisco sont gérées conformément à la politique de conservation des données de Cisco

Dépannage

En cas de problème lors de l'exécution, l'outil RNA crée un fichier journal qui peut être examiné et/ou fourni à Cisco pour résoudre tout problème lié au processus de collecte. Ce fichier est intégré automatiquement dans le fichier `dnac_rna_hc_collection.zip` avec les données collectées.