Handleiding voor het verzamelen van ACI-technische ondersteuning en TAC-vereiste uitgangen

Inleiding

In dit document worden de verschillende logbestanden en outputs beschreven die vereist zijn voor het oplossen van problemen bij het werken met TAC voor ACI.

Achtergrondinformatie

Zie Tabel 1 voor een snelle referentie naar welke gegevens u wilt verzamelen voordat u een TAC-case opent.

Tabel 1: Logs/matrixprinter voor technische verzameling tonen

Problemen	Wat te verzamelen	Opmerkingen
Upgradeproblemen	TelePresence On-Demand technische ondersteuning van knooppunten met een upgradeprobleem Technologische ondersteuning op aanvraag van alle APIC’s Aanvullende fouten, gebeurtenissen, audits via TacOutput	Als APIC's uiteenlopen en de verzameling van on-demand technische ondersteuning faalt, dient u "Techsupport Local" te verzamelen
Probleem met betrekking tot bereikbaarheid	Tidal Enterprise Scheduler - ondersteuning op verzoek van het src-knooppunt (waar het src-eindpunt is aangesloten) Tidal Enterprise Scheduler - ondersteuning op verzoek van het diagnostische knooppunt (waar het eindpunt is aangesloten) Aanvullende fouten, gebeurtenissen, audits via TacOutput
Compleet verlies van connectiviteit	On-Demand technische ondersteuning van bladeren (src en dst) Technologische ondersteuning op verzoek van stekels Technologische ondersteuning op aanvraag van APIC’s Aanvullende fouten, gebeurtenissen, audits via TacOutput	Voor aanhoudende uitgangen, dient u TAC te gebruiken voor bewegend fouilleren. Als knooppunten om wat voor reden dan ook moeten worden herstart, verzamel logbestanden voordat u ze opnieuw laadt als u om RCA vraagt.
Cloudproblemen	Technologische ondersteuning op aanvraag van alle APIC’s Aanvullende fouten, gebeurtenissen, audits via TacOutput	Als APIC's uiteenlopen en de verzameling van on-demand technische ondersteuning faalt, dient u "Techsupport Local" te verzamelen
Routing- en routingproblemen	On-Demand technische ondersteuning van knooppunten met routingprobleem Aanvullende fouten, gebeurtenissen, audits via TacOutput
Knooppunt/onverwacht opnieuw laden	On-Demand technische ondersteuning van crashknooppunten Crash/core bestanden van crashes knooppunt(s) Aanvullende fouten, gebeurtenissen, audits via TacOutput
APP-probleem	Technologische ondersteuning op aanvraag van alle APIC’s APIC APP-technische ondersteuning voor getroffen app

ACI APIC en Switch

Technologische ondersteuning op aanvraag

Opmerking: Als uw ACI Fabric is aangesloten en geclaimd via internet, wordt de technische ondersteuning gegenereerd en geüpload naar de TAC SR voor het serienummer dat wordt geleverd tijdens geopende case geautomatiseerd. De TAC engineer op die SR om dan de generatie te activeren en of extra TechSupport voor andere aangesloten apparaten via Intersight te uploaden.

Trillingen en uploaden naar het internet via APIC - Nexus Insights Cloud-app

Om deze methode te gebruiken, moet uw ACI Fabric met elkaar zijn verbonden en op het scherm worden geclaimd via het APIC: Nexus Insights Cloud Connector - app.

1. Navigeren in: APIC > apps > geïnstalleerde apps > open NICC app > TAC Assist > klik op "Beginnen"
2. Selecteer het (de) knooppunt(en) en klik op "Logs verzamelen"
3. Klik op "Details bekijken" als de taakstatus "COMPLETE" is
4. In de pagina "Taakdetails" onder Logs-tabel vindt u de kolom "Cloud". 
5. Klik op "Upload" - voor het TechSupport-bundel van elk apparaat

Trigger en uploaden naar internet via ND - Nexus Dashboard Insights

Om deze methode te gebruiken, moet uw ACI Fabric met elkaar zijn verbonden en op het scherm worden geclaimd via Nexus Dashboard: Nexus Dashboard Insights.

1. Navigeren in: Nexus Dashboard > Admin Console > Services > Open "Nexus Dashboard Insights" > Problemen oplossen > Log Collector
2. Klik op "Nieuwe logcollectie"
   1. Geef een naam om collectie te registreren.
   2. Selecteer een site. 
   3. Selectieknop inschakelen voor "Auto Upload Log Files"
   4. Klik op "Select Nodes" en kies de knooppunten
   5. Klik op "Verzameling starten"
   6. TechSupport-bestanden worden geüpload naar intersight.com  
3. Wanneer het uploaden is voltooid, stelt u TAC in kennis van het feit dat de bestanden op internet zijn geüpload. 
4. TAC engineer zou in staat zijn om de bestanden van intersight naar de TAC case te verplaatsen voor analyse. 

Trigger via APIC UI

Een on-demand-ondersteuningsbeleid maken

Opmerking: Specificeer geen tijdbereik voor technische ondersteuning tenzij dit expliciet door TAC wordt gevraagd. Als er een overmatige tekenherkenning is, kan dit leiden tot het verlies van stammen. Dit heeft ernstige gevolgen voor het vermogen van TAC om tijdig RCA te leveren. Als een TechSupport Time Range wordt aangeboden, maakt deze stamboeken op basis van de tijdstempel "laatste bestandswijziging" en NIET op basis van de tijdzegels binnen het logbestand zelf.

1. Klik in de menubalk op Admin > Importeren/Exporteren > Exporteren beleid > Rechtsklik op TechSupport op aanvraag > TechSupport op aanvraag maken
2. Voer de gewenste waarden in in de velden van het dialoogvenster TechSupport op verzoek maken.
   • Als er geen externe locatie beschikbaar is, controleert u op Exporteren naar controller. Vervolgens kan de gegenereerde technische ondersteuning worden gedownload via het tabblad Operationeel van de GUI nadat deze gegenereerd is.
   • Controleer alle controllers in TechSupport om APIC-technische ondersteuning te genereren.
   • In het veld Bron knooppunten kunt u knooppunten voor de switch specificeren die een technische ondersteuning genereren.
3. Klik op Indienen om het on-demand ondersteuningsbeleid te maken.

Een on-demand technische ondersteuning genereren

1. Navigeren in naar een bestaand on-demand ondersteuningsbeleid. U vindt het gedefinieerde beleid op: Admin > Importeren/Exporteren > Exporteren > Beleid op aanvraag > TechSupport op aanvraag > Map TechSupport op aanvraag uitbreiden > Rechtsklik op het te gebruiken beleid > Technische ondersteuning verzamelen.
   
   • of klik met de rechtermuisknop op het beleid voor technische ondersteuning op aanvraag om het in het hoofdvenster te plaatsen; Klik vervolgens op het pictogram Wfrank/hamer en kies Technische ondersteuning verzamelen.
2. Klik op "Ja" om te beginnen met het verzamelen van technische ondersteuningsinformatie.

Verzamel de gegenereerde technische ondersteuning

1. Als "Exporteren naar controller" niet is ingeschakeld tijdens de productie van technische ondersteuning, moet de Exportoptie (Remote Locatie) worden gecontroleerd op alle technische ondersteuningsbestanden.
2. Als "Exporteren naar controller" is ingeschakeld, navigeer dan naar het beleid voor on-demand technische ondersteuning waarmee de technische ondersteuning gegenereerd is. Beweerd beleid kan worden gevonden bij Admin > Importeren/Exporteren > Exportbeleid > TechSupport op aanvraag
   • De gegenereerde technische ondersteuning is te vinden in het tabblad Operationeel van het onderdeel Tidal Enterprise Scheduler. Elk bestand heeft een link om het te downloaden via http/https. Elk knooppunt heeft drie koppelingen, één link die aan elk bestand is gekoppeld.

Opmerking: Als de versie eerder dan 2.2 is, moet u de lokale gebruikersaccount "Admin" gebruiken om technische ondersteuning te downloaden via de UI. Gebruik anders elke andere lokale account met beheerrechten. Afstandsgebruikers kunnen technische ondersteuning niet downloaden via de UI. In plaats daarvan zouden ze gebruik moeten maken van ftp of een andere methode om de techsupport bestanden uit de folder "/data/techsupport/" van de corresponderende APIC's te halen.

Opmerking:  Het nummer in de URL van de technische ondersteuningsbundel geeft aan op welke APIC het bestand zich bevindt. Bijvoorbeeld "files/2/techsupport.tgz" geeft aan dat deze specifieke bundel te vinden is in de "/data/techsupport/" folder van APIC 2.

Opgeloste technische ondersteuningsbestanden

Als de technische ondersteuning gegenereerd is met de optie Exporteren naar controller, toont de GUI drie URL’s per ACI-knooppunt (APIC-knooppunt of Switch-knooppunt). Elke URL is een ander logbestandstype en bevat unieke informatie. TAC vereist gewoonlijk dat alle drie bestanden per knooppunt worden geüpload om alle vastlegging voor een volledige analyse te verkrijgen.

Elke URL wordt in kaart gebracht op een van de drie bestandstypen:

Categorie	Typisch voegsel	Handig voor:	Bestandsgrootte
Exporteren	_1of3.tgz	Aanwijzingen voor audits/fouten	klein
Logs	_logs_3of3.tgz	Procesloggers	grootste
DB	_db_2of3.tgz	MO-belasting	Klein

Opmerking:  Als een Exportbestemming werd geselecteerd in plaats van Exporteren naar controller, maakt de gedefinieerde Remote Locatie een map die de drie bestanden per knooppunt bevat.

Als er een probleem is met het downloaden van de technische ondersteuning via de browser-link, kunt u de bestanden direct downloaden van APIC-opslag met een scp- of SDP-client zoals WinSCP of FileZilla.

1. Sluit (SFP) aan op elke APIC. De verzamelde tech-support bestanden worden opgeslagen over alle beschikbare APIC's, dus is het belangrijk om elke APIC te controleren op de verzamelde tech-support bestanden.

2. Navigeer naar /data/techsupport map in de aangesloten APIC (herhaal deze stap in alle APIC-controllers).

Bekijk de bestanden met een naam die de beleidsnaam On-demand TechSupport bevat (in dit voorbeeld is het "ABCTECH") en download deze bestanden naar uw computer.

Technische ondersteuning lokaal

Een On-Demand Techsupport is altijd beter dan een "techsupport local", omdat een On-Demand technische ondersteuning een vollediger beeld biedt. Het is echter afhankelijk van een volledig geschikt APIC-cluster, aangezien de verzameling via het beleid wordt geactiveerd.

Merk op dat een "Techsupport local" op elk afzonderlijk knooppunt moet worden geactiveerd, dus als u van plan bent "techsupport local" voor alle APIC's te verzamelen, moet de cmd op elke APIC in het cluster afzonderlijk worden uitgevoerd.

TechSupport Local Scenarios

• APIC is niet volledig geschikt
• ACI-switch is nog niet ontdekt door APIC
• ACI-switch heeft de communicatie met APIC verloren
• Interne procedurefout ter voorkoming van gebruik van On-Demand technische ondersteuning (zelden)

Trigger via APIC CLI

1. Open een SSH-sessie met APIC met admin-referenties.
   • Als u geen admin-aanmeldingsgegevens kunt gebruiken om in te loggen, gebruikt u de gebruikersnaam voor "reddingsgebruiker". Het wachtwoord dient hetzelfde te zijn als de lokale gebruiker "admin".
2. Start de opdracht bash-c "techsupport local"

   Using username "admin".
   Application Policy Infrastructure Controller
   
   apic1# bash -c "techsupport local"
   This command is being deprecated on APIC controller, please use NXOS-style equivalent command
   Running bash commands
   Completed 1 of 10 commands
   ...
   Completed 10 of 10 commands
   Starting data compression
   Techsupport collected at /data/techsupport/local_apic1_2018-05-29T08-17.tgz . Please remove the file once done.
   

3. Download de lokale technische ondersteuning.
   
   • Optie A: Download het technische ondersteuningsbestand met SCP:
     • WinSCP of pscp.exe (Windows-gebruikers)
     • Native SCP-client (MAC-gebruikers)
   • Optie B: Downloadt het bestand van technische ondersteuning met HTTPS:
     1. Open een browser zoals Chrome of Firefox.
     2. Navigeren in: https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
        • Voorbeeld: https://a.p.i.c/files/1/techsupport/local_apic1_2018-05-29T08-17.tgz
     3. Inloggen met admin-referenties.
     4. Selecteer desgevraagd Bestand opslaan in de downloadmelding van de browser.

Trigger via Switch CLI

1. Open een SSH-sessie met de ACI-switch met behulp van admin-referenties.
   • Indien de switch nog niet door APIC wordt ontdekt, gebruik dan de gebruikersnaam "admin".
2. Start de opdracht: "techsupport local"

fab5-leaf1# techsupport local
Running bash commands
Completed 1 of 9 commands
...
Completed 9 of 9 commands
Starting data compression
Techsupport collected at /data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz . Please remove the file once done

3. Download de plaatselijke technische ondersteuning.

• Optie A: Download het technische ondersteuningsbestand van de ACI-switch met SCP:
  • WinSCP of pscp.exe (Windows-gebruikers)
  • Native SCP-client (MAC-gebruikers)
• Optie B: Download het technische ondersteuningsbestand met HTTPS via APIC:
  
  1. Meld u aan bij een APIC CLI (let op welke APIC voor stap #4 wordt gebruikt)
  2. Breng het technische ondersteuningsbestand van de ACI-switch naar de APIC over met de volgende opdracht:
     • SCP <naam van het knooppunt>:/data/techsupport/<ts_filename> /data/techsupport
     • Voorbeeld: apic1# SFP5-blad1:/data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz/data/technische ondersteuning
  3. Open een browser zoals Chrome of Firefox.
  4. Navigeren in: https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
     • Voorbeeld: https://a.p.i.c/files/1/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz
  5. Inloggen met admin-referenties.
  6. Selecteer desgevraagd Bestand opslaan in de downloadmelding van de browser.

CIMC-technische ondersteuning

Trigger via CIMC UI

Er kan een technische ondersteuning van APIC CIMC worden verzameld voor het bekijken van logbestanden met betrekking tot het APIC-chassis. Een CIMC-viewer kan lokaal worden opgenomen of naar een externe locatie worden verzonden vanuit het gedeelte Hulpprogramma's van het tabblad CIMC Admin. 

Trigger via CIMC CLI

Voer in de APIC CIMC CLI het volgende in:

~ # scope cimc
~ /cimc # scope tech-support
~ /cimc/tech-support # set tftp-ip 192.168.1.1
~ /cimc/tech-support *# set path \techsupport\showtech
~ /cimc/tech-support *# commit
~ /cimc/tech-support *# start 

CIMC-technologieën parseren

Enkele van de belangrijkste velden binnen de show tech opdracht zijn zoals hieronder.

TechSwitch-bestand/locatie	Beschrijving
var/	Bevat gedetailleerde logbestanden en de status van alle gecontroleerde diensten. Het bevat ook informatiebestanden voor diensten zoals de configuratie van SOL- en IPMI-sensoralarmen.
var/log	Bevat vluchtige logberichten
obfl/	Bevat de rolbare niet-vluchtige logberichten
met/	Niet-vluchtige configuratie en SEL
mp/	De show tech-support tekstbestanden, samen met geprogrammeerde tekstbestanden met technische ondersteuning. De tekstbestanden bevatten alle proces-, netwerk-, systeem-, mezzanine- en geprogrammeerde informatie.
werktuig	Geeft basisinformatie over de stand van het CIMC
netwerk	Hiermee krijgt u informatie over de huidige netwerkconfiguratie en -socket
obfl	Hiermee krijgt u live personeel (aantekeningen bij fouten aan boord)
berichten	Hiermee wordt het bestand live/var/log/boodschappen ontvangen
alarm	Lijstsensoren in alarmtoestanden
sensoren	Huidige sensorlezingen van IPMI
macht	Huidige stroomtoestand van de x86

Uitgebreide audits, gebeurtenissen, fouten en meer (TACO)

TAC kan om extra basisoutput vragen zoals fouten, gebeurtenissen en audits die over het algemeen vereist zijn voor RCA.

Op dit moment bevat de show techno al een subset van deze objecten, maar alleen de laatste 10.000 records. In sommige gevallen is voor TAC de volledige reeks records nodig, die veel verder gaat dan 10.000 records.

Opmerking: Gebruik de CLI-opdracht 'trigger tacoutput' van APIC om deze extra objecten te verzamelen, om te beginnen met release 5.2(1g).

Trigger via "trigger tacoutput" - 5.2(1g)+

Voor ACI-stoffen met versie 5.2+ levert de trigger-output een vereenvoudigde inzamelinterface voor gebeurtenissen, fouten, audits en andere uitgangen voor het opsporen en verhelpen van problemen):

apic1# trigger tacoutput
Select corresponding numbers of objects to collect. Separate numbers with commas. *Note, topSystem, fabricNode, and firmwareARunning are automatically included.
Ex: 1,2,3,4,5
1. faultInfo *collected unfiltered
2. faultRecord
3. eventRecord
4. aaaModLR *collected unfiltered
5. polDeploymentRecord
6. epRecord
7. healthRecord
8. healthInst *collected unfiltered
Enter selections: 1,2,3,4,5,6,7,8
Enter record start date (format: 2019-12-15T00:00:00) *default is one month prior to current date: 
Enter record end date (format: 2019-12-15T00:00:00) *default is current date: 

... collection runs...

2021-12-17T08:19:59 TacOutput collection completed.
2021-12-17T08:19:59 Verify files and file sizes at /tmp/TacOutput2021-12-17T08-16-19
2021-12-17T08:19:59 Compressing files...
2021-12-17T08:20:01 Compression completed
Logs available for SCP or SFTP download from /data/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz
To download through your web browser go to https://
     
     
       /files/1/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz 
     
Note: in the URL above 1 denotes the APIC ID 1, if script was run on APIC-n, then n must be specified in the URL (n = APIC-ID).

To remove files when done run
rm -rf /tmp/TacOutput2021-12-17T08-16-19
rm -f /data/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz

Trigger via Collect TacOutputs script

Voor ACI-stoffen die pre-5.2 actief zijn, is er een Collect TacOutput Script beschikbaar in de aci-tac-scripts opslagruimte die een zelfde interface als de activateringsopdracht van de activatocutatie dient:

apic# /tmp/collectTacOutputs.sh
Select corresponding numbers of objects to collect. Separate numbers with commas. *Note, topSystem, fabricNode, and firmwareARunning are automatically included.
Ex: 1,2,3,4,5
1. faultInfo *collected unfiltered
2. faultRecord
3. eventRecord
4. aaaModLR
5. polDeploymentRecord
6. epRecord
7. healthRecord
8. healthInst *collected unfiltered
Enter selections: 1,2,3,4,5,6,7,8
Enter record start date (format: 2019-12-15T00:00:00) *default is one month prior to current date: 2019-12-25T00:00:00
Enter record end date (format: 2019-12-15T00:00:00) *default is current date: 2020-01-05T00:00:00

...script collection runs...

Compression completed
Logs available for SCP or SFTP download from /data/techsupport/TacOutput-2019-12-25T00:00:00-to-2020-01-05T00:00:00.tgz
To download through your web browser go to https:///files/1/techsupport/TacOutput-2019-12-25T00:00:00-to-2020-01-05T00:00:00.tgz

Crash/Core-bestanden

Verzamelen via APIC UI

Het ACI-switch-knooppunt en de APIC hebben talrijke processen die verschillende functionele aspecten van het systeem beheersen. Als de software in een bepaald proces defect is, wordt er een kernbestand gegenereerd en wordt het proces opnieuw geladen. Wanneer een proces crasht en er een kernbestand wordt gegenereerd, worden zowel een fout als een gebeurtenis gegenereerd. Wanneer het proces op de switch/APIC crasht, wordt het kernbestand gecomprimeerd en naar APIC gekopieerd.

APIC GUI biedt een centrale locatie om de kernbestanden voor de weefselknooppunten te verzamelen.

Een nieuw exportbeleid kan worden gecreëerd door Admin > IMPORT/EXPORT in Exportbeleid > Core.

Er is een standaard kernbeleid waar bestanden direct gedownload kunnen worden. Alle gegenereerde kernbestanden proberen een overdracht naar de APIC-controller uit te voeren wanneer ze gegenereerd worden. Als dit succesvol is, kunnen ze gevonden worden onder het standaard kernbeleid.

Standalone audits

Inzameling via NDO/MSO UI

MSC Audit Logs kunnen in JSON worden gedownload in CSV-indeling