Metro-knooppunt: Logboeken verzamelen van het metro-knooppunt

Stappen voor het uitvoeren van de volgende taken: 

1. Welke logboeken zijn vereist voor het oplossen van problemen met metroknooppunten? 
2. Hoe leg ik collect-diagnostics vast op een cluster van metro-knooppunten? 
3. De bestaande collect-diagnostics-pakketten valideren op de beheerservers.  
4. Hoe kan ik een lopende verzameldiagnose in Metro Node afbreken en opschonen?  

Opmerking: Als SupportAssist-logboeken nodig zijn, raadpleegt u de klant KBA-000135669, "Hoe exporteer ik een SupportAssist-logboekverzameling van SupportAssist Enterprise? Verbonden of niet verbonden "


 A. Welke logboeken zijn vereist voor het oplossen van problemen met metroknooppunten? 

1. De opdracht die nodig is om logboeken van het metro-knooppunt te verzamelen, heet "collect-diagnostics" en kan worden uitgevoerd vanaf elk ^[1] knooppunt in de metro-knooppuntopstelling. Als u deze opdracht uitvoert op één director van een cluster van metro-knooppunten, moeten alle data van alle directors en van alle knooppunten van een cluster aanwezig zijn. Voer deze opdracht NIET uit op meer dan één knooppunt tegelijk.

2. De opdracht 'collect-diagnostics' genereert een gecomprimeerd tar.gz logbestand met configuratie- en logbestanden. Het bestand collect-diagnostics wordt geplaatst in de map /diag/collect-diagnostics-out/ op het knooppunt van waaruit het bestand is uitgevoerd. Zodra de opdracht is voltooid, gebruikt u WINSCP of een gelijkwaardig SCP-hulpprogramma om het bestand van het knooppunt te kopiëren, waarna het kan worden gebruikt ter ondersteuning voor analyse. Meer informatie over het gebruik van deze opdracht vindt u in sectie B hieronder.

Opmerkingen: 

• Als de opdracht 'collect-diagnostics' zonder opties wordt uitgevoerd, worden twee bestanden gegenereerd, een basisbestand en een uitgebreid bestand. Dit kan behoorlijk lang duren op geschaalde systemen. 
• Support voor metroknooppunten vereist over het algemeen alleen het basisbestand, maar in sommige gevallen kunnen prestatieproblemen ze ook om het uitgebreide bestand vragen. 
• Standaardopties die kunnen worden gevraagd om te worden gebruikt bij het uitvoeren van collect-diagnostics zijn: 

• Voor meer details over de opdracht kunt u "collect-diagnostics -h" typen 

Dit zijn voorbeelden van hoe deze twee bestandsnamen eruit zien: de datum en tijd, weergegeven als YYYY-MM-DD-HH.MM.SS, zijn van de datum en tijd waarop deze zijn verzameld: 

• Basisbestand - <serienummer>-c1-diag-YYYY-MM-DD-HH.MM.SS.tar.gz 
• Uitgebreid bestand - <serienummer>-c1-diag-ext-YYYY-MM-DD-HH.MM.SS.tar.gz 

3. Prestatievraagstukken zijn complex en vereisen veel specifieke informatie om te verzamelen. Daarom hebben we een prestatievragenlijst die klanten moeten invullen om dit proces te versnellen. De vragenlijst is als bijlage bij dit Knowledge Base-artikel te vinden in de bijlage aan het einde. 

4. Bij sommige soorten prestatieproblemen is het handig om een extra logboek met de naam "fe_perf_stats" vast te leggen. De logboeken worden continu gegenereerd, maar niet vastgelegd door collect-diagnostics. Om dit logbestand vast te leggen, gaat u naar /var/log/VPlex/cli op een knooppunt van elk cluster en voert u de opdracht "tar cvzf fe-perf-stats.tar.gz fe_perf_stats*" uit om de gegevens van de bestanden in een tar-bestand te comprimeren. Maak verbinding met het knooppunt met WINSCP, of een gelijkwaardig SCP-hulpprogramma, en navigeer naar /var/log/VPlex/cli. Kopieer het bestand "fe-perf-stats.tar.gz" naar uw systeem. Upload het tar-bestand samen met de collect-diagnostics bestand(en), op verzoek van support, naar de SR of een ftp-link die support u zal verstrekken in de SR en een e-mail. 

5. Naast het verzamelen van diagnostische gegevens kan het nuttig zijn om de volgende informatie vast te leggen;

• open logging voor een putty-sessie,
• Voer vervolgens de onderstaande opdrachten uit,
• verzamel vervolgens het Putty-logboek en download het naar uw systeem,
• Voeg vervolgens het PuTTY-logboek, de collect-diagnostics
  en eventuele andere gevraagde data toe aan de SR.

1. Clusterstatus 
2. ll clusters/**/storage-views/* --full 
3. ll ~poorten 
4. show-use-hierarchy /clusters/**/virtual-volumes/* 
5. ll ~system-volumes 
6. ls -t /clusters/*/directors/*::serial-number [met deze opdracht worden alle DST's voor elk knooppunt weergegeven]
7. ls -t /clusters/**/director-*/::hostname [de weergegeven hostnamen zijn de IP-adressen, dit is te verwachten]

B. Hoe leg ik collect-diagnostics vast op een cluster van metro-knooppunten? 
 
Opmerking: Het basisbestand, dat de afgelopen 30 dagen beslaat, is voldoende om de meeste problemen te onderzoeken en op te lossen. Deze opties moeten worden gebruikt, tenzij anders aangegeven door de ondersteuning.
Als u deze data wilt vastleggen, voert u een collect-diagnostics-opdracht uit met de volgende vlaggen: "--noextended" en "--last-logs 30d".

1. Zet een SSH-sessie op bij een Linux-prompt van een directorknooppunt, bijvoorbeeld service@director-1-1-a, en meld u vervolgens aan bij de vplexcli. 

Voorbeeldresultaat:

login as: service 
Keyboard-interactive authentication prompts from server: 
| Password: 
End of keyboard-interactive prompts from server 
Last login: <date and timestamp data> from x.x.x.x
service@director-1-1-a:~> 
service@director-1-1-a:~> vplexcli 
Trying ::1... 
Connected to localhost. 
Escape character is '^]'. 
 
VPlexcli:/> 

2. Om collect-diagnostics te starten, voert u vanuit de vplexcli-prompt de opdracht "collect-diagnostics" uit met de gerichte opties zoals weergegeven in het onderstaande voorbeeld. 

Voorbeeld van uitvoer: 

VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 

('WARNING:The collect-diagnostics command was issued with option --noextended.\n',) 

The following file(s) will NOT be collected: 

        core files 
        fast trace dump files 
        slow trace dump files 
        udcom trace dump files 
        udcom legacy trace files 
        user-defined performance sink files 
        the management console's heap 

('WARNING:Only the logs that are generated in the last 30 days are collected.') 

2024-02-09 19:55:12 UTC: ****Initializing collect-diagnostics... 
2024-02-09 19:55:13 UTC: No cluster-witness server found. 
2024-02-09 19:55:13 UTC: Free space = 88G 
2024-02-09 19:55:13 UTC: Total space needed = 1907M 

================================================================================ 

Starting collect-diagnostics, this operation might take a while... 

================================================================================ 

Executing cluster collection .. 

C. De bestaande collect-diagnostics-pakketten valideren op de director/knooppunt. 

1. Wanneer de opdracht collect-diagnostics is voltooid en terugkeert naar de vplexcli-prompt, maakt u verbinding met de director van waaruit u de opdracht hebt uitgevoerd met behulp van winscp [of gelijkwaardig SCP-hulpprogramma] en navigeert u naar de map /diag/collect-diagnostics-out/ 

2. Identificeer de logboekbestanden met de juiste tijdstempel en download ze naar uw lokale workstation. 

D. Een lopende verzamelingsdiagnose

afbrekenOpmerking:  Dit is een niet-onderbrekende activiteit. Aangezien er geen directe opdrachten zijn om het incassoproces af te breken, moet u de beheerconsole opnieuw opstarten. Maar voordat u een actieve collect-diagnostics afbreekt, neemt u contact op met de ondersteuning om uit te leggen waarom u de uitvoering van de collect-diagnostics wilt afbreken om er zeker van te zijn dat deze OK is, omdat er gegevens verloren kunnen gaan. Deze verloren data zijn niet opnieuw beschikbaar voor verzameling wanneer de collect-diagnostics opnieuw wordt uitgevoerd na de afbreekactie.

1. Als u nog steeds bezig bent met de PuTTY-sessie waarin u de collect-diagnostics hebt gestart, zou u de streaming van de collect-diagnostics moeten zien, wat aangeeft dat deze nog steeds wordt uitgevoerd. 

Voorbeeldresultaat: 

VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 

('WARNING:The collect-diagnostics command was issued with option --noextended.\n',) 

The following file(s) will NOT be collected: 

        core files 
        fast trace dump files 
        slow trace dump files 
        udcom trace dump files 
        udcom legacy trace files 
        user-defined performance sink files 
        the management console's heap 

('WARNING:Only the logs that are generated in the last 30 days are collected.') 

2022-02-09 19:55:12 UTC: ****Initializing collect-diagnostics... 
2022-02-09 19:55:13 UTC: No cluster-witness server found. 
2022-02-09 19:55:13 UTC: Free space = 88G 
2022-02-09 19:55:13 UTC: Total space needed = 1907M 

================================================================================ 

Starting collect-diagnostics, this operation might take a while... 

================================================================================ 

Executing cluster collection .. 

2. Open een dubbele PuTTY-sessie en meld u aan bij de director waar u de collect-diagnostics hebt gestart, met behulp van het serviceaccount. 

  Voorbeeldresultaat: 

login as: service 
Using keyboard-interactive authentication. 
Password: 
Last login: <date and time stamp data> from x.x.x.x 
service@director-1-1-b:~>

3. Eenmaal in de director start u de beheerconsole opnieuw op met de volgende opdracht om de collect-diagnostics die wordt uitgevoerd af te breken.  

Voorbeeldresultaat: 

   service@director-1-1-b:~> sudo systemctl restart VPlexManagementConsole.service 
 

4. Als u terugkijkt naar de eerste PuTTY-sessie waarin de collect-diagnostics wordt uitgevoerd en u de beheerconsole opnieuw start, ziet u het collect-diagnostics rapport als de laatst genoteerde uitvoer: 

"Connection closed by foreign host."

Sample output (controleer de laatste regel van de output):

VPlexcli:/> collect-diagnostics --noextended --last-logs 30d 

('WARNING:The collect-diagnostics command was issued with option --noextended.\n',) 

The following file(s) will NOT be collected: 

        core files 
        fast trace dump files 
        slow trace dump files 
        udcom trace dump files 
        udcom legacy trace files 
        user-defined performance sink files 
        the management console's heap 

('WARNING:Only the logs that are generated in the last 30 days are collected.') 

2022-02-09 20:02:03 UTC: ****Initializing collect-diagnostics... 
2022-02-09 20:02:04 UTC: No cluster-witness server found. 
2022-02-09 20:02:04 UTC: Free space = 88G 
2022-02-09 20:02:04 UTC: Total space needed = 1907M 

================================================================================ 

Starting collect-diagnostics, this operation might take a while... 

================================================================================ 

Executing cluster collection ..                               ERROR 
Executing SMS log collection ..                               Connection closed by foreign host. <<<

5. Zodra de collect-diagnostics is gestopt, stap 3 hierboven, ga terug naar de tweede PuTTY-sessie en 'cd' naar de /diag-directory, voer dan ' ll ' uit en je zou wat extra mappen moeten zien, 

• collect-diagnostics-tmp
• collect-diagnostics-jobs 
• collect-diagnostics-tmp-ext*

      *als uitgebreide bestanden niet zijn weggelaten

Voorbeeldresultaat: 

service@director-1-1-b:/diag> ll 
total 32 
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:03 collect-diagnostics-tmp-ext
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:03 collect-diagnostics-jobs 
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:04 collect-diagnostics-out 
drwxr-xr-x 3 service groupSvc  4096 Feb  9 20:02 collect-diagnostics-tmp 
drwx------ 2 root    root     16384 Jan 27 16:54 lost+found 
drwx--x--x 3 service groupSvc  4096 Dec 17 03:08 share 
service@director-1-1-b:/diag> 

6. Als u in elk van deze directory's kijkt, ziet u bestanden met de datum en tijd waarop u de nu geannuleerde collect-diagnostics hebt gestart. Deze bestanden nemen ruimte in beslag in de partitie /diag en moeten worden verwijderd. 

7. Om de bestanden uit de /diag-directory te verwijderen/verwijderen, typt u "rm -r collect-diagnostics-jobs" en "rm -r collect-diagnostics-tmp" en voert u opnieuw ' ll ' in om er zeker van te zijn dat de mappen zijn verwijderd/verwijderd. 

Voorbeeldresultaat: 

service@director-1-1-b:/diag> rm -r collect-diagnostics-jobs 
service@director-1-1-b:/diag> rm -r collect-diagnostics-tmp 

service@director-1-1-b:/diag> ll 
total 24 
drwxr-xr-x 2 service groupSvc  4096 Feb  9 20:04 collect-diagnostics-out 
drwx------ 2 root    root     16384 Jan 27 16:54 lost+found 
drwx--x--x 3 service groupSvc  4096 Dec 17 03:08 share 
service@director-1-1-b:/diag> 

8. Als er een map 'collect-diagnostics-tmp-ext' bestaat, verwijdert u deze door "rm -r collect-diagnostics-tmp-ext" uit te voeren  

Opmerking: Het uitgebreide bestand wordt meestal gebruikt om knooppuntcrashes te onderzoeken. Als er een lopend onderzoek loopt naar een knooppuntcrash en support niet alle benodigde logboeken heeft vastgelegd, neem dan contact op met support voordat u de directory collect-diagnostics-tmp-ext opschoont, omdat hierdoor de benodigde kernbestanden kunnen worden verwijderd.