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 een metroknooppunt annuleren en opschonen?

Een. 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 knooppunt (*1) 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.

   *1 OPMERKING: Voer de opdracht 'collect-diagnostics' uit vanuit slechts één director, op slechts één cluster als een Metro configuratie is, en wacht tot deze volledig is voltooid voordat u de cd's ophaalt van een andere director of van het peercluster, indien nodig.

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 metro-knooppunten 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:
     • "--noextended": Met deze optie wordt het verzamelen van uitgebreide diagnostische gegevens weggelaten.
     • "--last-logs": Met deze optie worden logboeken van een x aantal uren of dagen vastgelegd.
   • 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: <Serial number>-c1-diag-YYYY-MM-DD-HH.MM.SS.tar.gz
   • Extended file: <Serial number>-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 blader naar /var/log/VPlex/cli. Kopieer het bestand "fe-perf-stats.tar.gz" naar uw systeem. Upload het tar-bestand samen met een of meer collect-diagnostics bestanden, indien gevraagd door support, naar de SR of een ftp-link die Support u biedt 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.

   De volgende opdrachten moeten worden uitgevoerd vanaf de VPlexcli-prompt.

   1. cluster status
   2. ll clusters/**/storage-views/* --full
   3. ll ~ports
   4. show-use-hierarchy /clusters/**/virtual-volumes/*
   5. ll ~system-volumes
   6. ls -t /clusters/*/directors/*::serial-number (deze opdracht geeft een overzicht van alle DST's voor elk knooppunt)
   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?

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.
   ',) 
   
   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. Hoe de bestaande collect-diagnostics-pakketten op de director/knooppunt te valideren.

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 bladert u naar de map /diag/collect-diagnostics-out/

2. Identificeer een of meer logbestanden met de juiste tijdstempel en download deze naar uw lokale workstation.

D. Een lopende verzamelingsdiagnose annuleren

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.
   ',) 
   
   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 te annuleren.

   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.
   ',) 
   
   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 mappen 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 vervolgens opnieuw "ll" in om ervoor te zorgen dat de mappen zijn verwijderd of 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.