Catalyst Center RNA-gereedschap gebruiken

Inleiding

In dit document wordt de Rapid Network Assessment Tool van het Catalyst Center (voorheen Cisco DNA Center) beschreven.

Deze tool is ontwikkeld door het Cisco CX Customer Success Team.

Voorwaarden

Vereisten

Een computer met verbinding met Catalyst Center en gebruikersnaam/wachtwoord voor verificatie van eerdere gegevensverzameling.

Gebruikte componenten

De informatie in dit document is gebaseerd op het Catalyst Center-platform.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Over RNA-gereedschap

RNA-tool voert een verscheidenheid aan controles uit die gericht zijn op het gebruik van functies en best practices op Catalyst Center, waardoor het Cisco Customer Success Team kan begrijpen welke functies worden gebruikt en welke functies kunnen worden geactiveerd om extra voordelen voor uw organisatie te bieden. De uitvoering van de tool is eenvoudig en alle informatie wordt uitsluitend verzameld bij Catalyst Center als onderdeel van de gezondheidscontroles die worden uitgevoerd door het Customer Success Team. Het kan worden uitgevoerd vanaf elke computer met toegang tot Catalyst Center. De tool voert een Go-script uit dat op deze link te vinden is:

GitHub CiscoDevNet / Catalyst-Center-RNA

Zodra de verzameling is voltooid, maakt RNA-tool een 'dnac_rna_hc_collection.zip'-bestand dat moet worden gedeeld met uw Cisco Customer Success Specialist om het te verwerken en analyse te bieden. 

Hoe te gebruiken RNA Tool

Stap 1. Download het corresponderende bestand van deze link:

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

Tip: In MacOS kunt u het volgende waarschuwingsbericht ontvangen: het bestand kan niet worden geopend omdat de ontwikkelaar niet kan worden geverifieerd. Als u de verzamelaar wilt uitvoeren en de uitvoering wilt toestaan vanuit Voorkeuren > Privacy en beveiliging, bladert u naar het gedeelte Beveiliging en ziet u het bericht "verzamelaar" is geblokkeerd ..., klik op Hoe dan ook openen en voer de verzamelaar opnieuw uit. Er kan een pop-up verschijnen en u kunt vragen of u deze wilt uitvoeren. Klik op Ja. Hierna kunt u het verzamelaarscript uitvoeren.

Stap 2. Bestanden uitpakken en de verzamelaar uitvoeren.

Stap 3. Geef het IP-adres, de gebruikersnaam en het wachtwoord van Catalyst Center op en wacht tot het is voltooid. Een bestand met de naam 'dnac_rna_hc_collection.zip' wordt aangemaakt onder '/Users//'  folder. 

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

Tip: De exacte locatie wordt getoond aan het einde van de uitvoering.

Opmerking: op basis van uw besturingssysteem moet u machtigingen toestaan voor het hulpprogramma om het eerder genoemde bestand uit te voeren en te maken.

Stap 4. Zodra het .zip-bestand is gemaakt, moet u het delen met de Cisco Customer Success-organisatie via een van de volgende methoden

• Cisco DOC Exchange
  Ga naar https://ciscoshare.cisco.com en upload het bestand naar de eerder door het Cisco Customer Success Team gemaakte map.
• Upload deze naar de TAC-case die door het Customer Success Team is geleverd
  Ga naar https://mycase.cloudapps.cisco.com/case en upload het bestand rechtstreeks naar de zaak.
  Vind hier meer informatie over de beschikbare methoden om het bestand te uploaden

Opmerking: voor beide methoden moet eerdere toegang worden verleend door het Customer Success Team.

Controles uitgevoerd

Er worden meerdere controles verzameld om het gebruik van functies en de best practices voor configuratie te beoordelen. De volgende gebieden kunnen worden beoordeeld met het gebruik van zowel publieke als private API's:

• Versie en licentie
• Integratie met andere oplossingen
• Gebruik van functies
• Configuratieverificatie

Voorbeeld van de logs die kunnen worden gezien tijdens de uitvoering van de tool. Merk op dat het aantal controles kan variëren, afhankelijk van de tool versie die u gebruikt. Om de nieuwste versie te krijgen, ga hier

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]

In het geval dat een API-oproep niet succesvol is, kan de HTTP-status worden weergegeven en kunnen drie opeenvolgende pogingen worden gedaan voordat deze naar de volgende oproep gaat.

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" 

RNA-versies - wijzigingslogboek

github CiscoDevNet / catalyst-center-rna / committeert

Beveiliging

Let op de volgende punten met betrekking tot de gegevensverzameling die door deze tool wordt uitgevoerd:

• Alle zoekopdrachten die door deze tool worden uitgevoerd, worden ook uitgevoerd door Catalyst Center GUI, dus er is geen groter risico dan klikken via de GUI.
• Query's naar Catalyst Center worden gegroepeerd en afgekapt om te zorgen voor een lagere belasting van Cisco Catalyst Center.
• Catalyst Center heeft interne beveiligingen om te beschermen tegen overmatig API-gebruik.
• API-interactie in Catalyst Center heeft geen invloed op het gedrag van het doorsturen van gegevens.
• Deze tool is vrijgegeven onder de Cisco Sample Code License, zodat u hier toegang hebt tot de repository
• Credentials worden alleen gebruikt op het punt van verzameling en worden op geen enkele manier opgeslagen.
• Alle gegevens die aan Cisco worden verstrekt, worden bewaard volgens het beleid voor gegevensbewaring van Cisco

Problemen oplossen

In het geval dat problemen worden gezien tijdens de uitvoering, maakt RNA-tool een logbestand dat kan worden beoordeeld en / of aan Cisco kan worden verstrekt om problemen met het verzamelproces op te lossen. Dit bestand wordt automatisch gebundeld in het bestand `dnac_rna_hc_collection.zip` samen met de verzamelde gegevens.