NetWorker VMware Protection-vProxy: Logboekregistratie voor foutopsporing inschakelen
Summary: Het wijzigen van het logboekniveau in 'debug' kan nodig zijn om een probleem met NetWorker VMware Protection (NVP) met vProxy Appliance-oplossing (NVP-vProxy) op te lossen. In dit artikel wordt uitgelegd hoe u het logboekniveau kunt wijzigen. ...
Instructions
Bekijk deze video: Logboekregistratie voor vProxy-foutopsporing inschakelen.
Methoden voor het toepassen van vProxy Engine Debug:
Meestal is het voldoende om de beleidslogboeken van de NetWorker-server in /nsr/logs/policy/[policy name], maar af en toe kan het nodig zijn om de logboeken van het vProxy-apparaat zelf te analyseren en bovendien het logboekregistratieniveau te verhogen om fouten op te sporen om een duidelijker idee te krijgen van de reden voor een fout. Dit is doorgaans alleen een vereiste nadat NetWorker-support is ingeschakeld en de supporttechnicus heeft gevraagd om de set voor probleemoplossing als specifiek proces te debuggen.
NVP-vProxy-logbestanden op de vProxy appliance bevinden zich in de volgende map: /opt/emc/vproxy/runtime/logs.
Er is een subdirectory voor elk van de belangrijkste processen die worden gebruikt voor NetWorker-bewerkingen op de vProxy-appliance:
vbackupd vflrd vrapid vrecoverd
Zo heeft de vbackupd Subdirectory bevat de volgende logboeken:
[session-uuid].log Processing details for a session vbackupd-engine.log Requests and problem events including error and panic messages from the session log. vbackupd-boost.log DD Boost logging. vbackupd-snapmgr.log Snapshot logging vbackupd-vddk.log VDDK logging - VMware Virtual Disk Development Kit
Aanvullende informatie over vProxy-logboekregistratie en -verzameling is te vinden in het artikel NVP-vProxy Triage Guide: Overzicht van NetWorker VMware Protection vProxy Triage en logboeken
Methode 1 voor foutopsporing van service toepassen:
Deze methode is van toepassing op vProxy's versie 4.3.x en hoger. Het kan worden gebruikt om foutopsporing in te schakelen op vProxy-services (vrapid, vrecoverd, vbackupd, vflrd). Meer foutopsporing kan worden ingeschakeld voor DD Boost-verkeer, Virtual Disk Development Kit (VDDK) en snapshotberichten (waar van toepassing).
- Maak verbinding met de vProxy via SSH met behulp van het vProxy-beheerdersaccount .
- Overschakelen naar root:
sudo su -
- Ga naar de bin-directory van de vProxy-agent:
cd /opt/emc/vproxy/bin
- Voor de service waarvoor foutopsporing is vereist, voert u de volgende opdrachten uit:
Back-upengine: vbackupd
| Daemon | Entiteit voor logboekregistratie | Voorbeeld van opdrachtgebruik | Logboeklocaties |
|---|---|---|---|
vbackupd |
Programma (hoofdmotor) |
./vProxy_debug.sh -s -d vbackupd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log Logboeken van individuele back-upsessies: /opt/emc/vrproxy/runtime/logs/vbackupd/BackupVmSession-<session-id>.log /opt/emc/vrproxy/runtime/logs/recycle/vbackupd/<DATE>/BackupVmSession-<session-id>.log |
| DD Boost |
./vProxy_debug.sh -s -d vbackupd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log |
|
| VDDK |
./vProxy_debug.sh -s -d vbackupd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.logDe VDDK houdt ook privélogboeken bij in de directory /tmp/vmware-root
|
|
| Snapshotbeheer |
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log |
Recover Engine: vrecoverd
| Daemon | Entiteit voor logboekregistratie | Voorbeeld van opdrachtgebruik | Logboeklocaties |
|---|---|---|---|
vrecoverd |
Programma (hoofdentiteit) |
./vProxy_debug.sh -s -d vrecoverd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log Logboeken voor individuele herstelsessies: /opt/emc/vrproxy/runtime/logs/vrecoverd/RecoverVmSession-<session-id>.log /opt/emc/vrproxy/runtime/logs/recycle/vrecoverd/<DATE>/RecoverVmSession-<session-id>.log |
| DD Boost |
./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log |
|
| VDDK |
./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.logDe VDDK onderhoudt ook privélogboeken in de directory /tmp/vmware-root
|
FLR-motor: vflrd
| Daemon | Entiteit voor logboekregistratie | Voorbeeld van opdrachtgebruik | Locatie van logboek |
|---|---|---|---|
vflrd |
Programma (hoofdmotor) |
./vProxy_debug.sh -s -d vflrd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.logIndividuele FLR-koppelingssessielogboeken: /opt/emc/vrproxy/runtime/logs/vflr/FlrMountSession-<session-id>.log Individual FLR Browse Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrBrowseSession-<session-id>.log Individual FLR Recover Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrRecoverSession-<session-id>.logVoltooide logbestanden worden verplaatst naar /opt/emc/vrproxy/runtime/logs/recycle/vflrd |
| DD Boost |
./vProxy_debug.sh -s -d vflrd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log |
REST-server: vrapid
| Daemon | Entiteit voor logboekregistratie | Voorbeeld van opdrachtgebruik | Locatie van logboek |
|---|---|---|---|
vrapid |
Programma (hoofdmotor) |
./vProxy_debug.sh -s -d vrapid -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log |
De bovenstaande opdrachten tonen dat foutopsporing is ingeschakeld. Deze opdrachten kunnen opnieuw worden uitgevoerd door de -l optie om terug te zetten naar de standaardinstellingen:
Opties:
- Voor programmalogboek:
warn | info | trace (standaard) | debug
- Voor DD Boost-logboek:
none | error | warn | info | debug | trace (standaard) | all
- Voor VDDK Log:
0 = Geen logging
1 = Alleen fouten
2 = Waarschuwingen en fouten
3 = Belangrijke informatieberichten, fouten en waarschuwingen (standaard)
4 = Debug data plus al het andere
- Voor Snapshot Manager-logboek:
warn | info | trace (standaard) | debug
Servicefoutopsporingsmethode 2 toepassen (handmatig):
Als u de
vbackupd Proces tot logboekniveau debug:
- Meld u aan bij de vProxy Appliance als admin via SSH of console en schakel over naar root:
sudo su -
- Ga naar de
systemdDirectory:
cd /usr/lib/systemd/system/
vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, enzovoort
- Open het servicebestand waarvoor debug-instellingen zijn vereist, bijvoorbeeld:
vi vbackupd.service
- Zoek de lijn met
ExecStart=en voeg toe met de gewenste foutopsporingsparameters:
vbackupd, vrecoverd, vflrd, and vrapid engine debug options: { debug | trace | info | warn } (default "trace")
--program-log-level=option
vbackupd, vrecoverd, and vflrd ddboost debug options: { none | error | warn | info | debug | all } (default "trace")
--boost-log-level=option
vbackupd snapshot manager debug options: { warn | info | trace | debug } (default "trace")
--snapmgr-log-level=option
Display version
--version
Multiple options could be used at once, for example if you needed to debug the vbackupd service, ddboost communication, and snapshot manager logging, the vbackupd.service file would include:
ExecStart=/opt/emc/vproxy/bin/vbackupd --program-log-level=debug --boost-log-level=all --snapmgr-log-level=debug
- Sla de wijzigingen in het bestand op.
- Laad het eenheidsconfiguratiebestand opnieuw met de opdracht:
systemctl daemon-reload
- Controleer in de NetWorker Management Console dat er geen back-ups worden uitgevoerd en start vervolgens de
vbackupdService:
systemctl restart vbackupd.service
Het bovenstaande proces is van toepassing op de services vrapid, vrecoverd, vbackupd, vflrd.
VDDK-foutopsporing toepassen (handmatig):
VMware Disk Development Kit (VDDK)-foutopsporing kan handmatig worden toegepast in de VixDiskLib.config Bestand. Deze foutopsporing is alleen van toepassing op vbackupd als vrecoverd Probleemoplossing. Het is niet van toepassing op: vflrd.
- Meld u aan bij het vProxy-apparaat met SSH of console als admin en schakel over naar root:
sudu su -
- Bewerk de
VixDiskLib.configbestand bevat de volgende regel:
vi /opt/emc/vproxy/conf/VixDiskLib.config vixDiskLib.transport.LogLevel=4 0 = No logging 1 = Errors only 2 = Warnings, and Errors 3 = Important information messages, errors, and warnings 4 = Debug data plus everything else
- Start de betreffende service opnieuw:
systemctl restart [service-name].service
systemctl restart vrecoverd.service
Zodra de logboekregistratie voor foutopsporing is ingesteld, moet het logboekbestand dat aan de service is gekoppeld, foutopsporingsregels bevatten.
Nadat u het foutopsporingsproces hebt voltooid, stelt u het logboekniveau opnieuw in met behulp van dezelfde procedure, met het woord tracering na het gelijkteken in plaats van foutopsporing. Om ervoor te zorgen dat deze wijziging onmiddellijk van toepassing is, moet de daemon opnieuw worden geladen en opnieuw worden opgestart zoals hierboven beschreven.
DD Boost Precert Debugging:
Dit proces wordt uitgevoerd met andere foutopsporingsmethoden die hierboven zijn beschreven. De DD Boost-bibliotheek registreert standaard geen gedetailleerde API-activiteit (Application Programming Interface). Het inschakelen van DD Boost precert-logging dient alleen te worden gedaan wanneer u andere DD Boost-gerelateerde fouten waarneemt in de vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log bestanden en extra foutopsporing is nodig. Dit is doorgaans alleen vereist wanneer NetWorker-support hierom vraagt voor Data Domain-samenwerkingen of engineering-opdrachten.
- Meld u aan bij het vProxy-apparaat met SSH of console als admin en schakel over naar root:
sudu su -
- Maak een leeg bestand met de naam
ddboost_precert.iniOnder/:
touch /ddboost_precert.ini
- Maak het
DDLogDirectory:
mkdir /DDLog
- Schakel DD Boost-foutopsporing in voor de service die foutopsporing vereist:
vbackupd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vbackupd -p ddboost -l debug vflrd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vflrd -p ddboost -l debug vrecoverd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vrecoverd -p ddboost -l debug
- Controleer of het
ddboost_precert.logwordt gegenereerd, reproduceert u het probleem en verzamelt u deddboost_precert.log:
ls -l /DDLog
- Wanneer foutopsporingsbewerkingen niet langer nodig zijn:
- Voer de volgende opdracht opnieuw uit op de service waarmee u ddboost-foutopsporing hebt ingeschakeld:
/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace
-
- Verwijder de
/ddboost_precert.iniBestand.
- Verwijder de
rm -rf /ddboost_precert.ini
vProxy Selection Logging:
Deze foutopsporing kan worden gebruikt wanneer een back-upworkflow voor een virtuele machine (VM) vastloopt met de VM's in de wachtrij om te worden uitgevoerd. In dit scenario is de back-uptaak gestart, maar is er geen vProxy opgehaald om de back-upsessie te starten. Er is geen logboekregistratie van het vProxy-selectieproces in standaardlogboekregistratie. We kunnen vmbackup_logging op de NetWorker-server, die het vProxy-selectieproces registreert tijdens het starten van VMware Protection Policy. Dit is handig als er geen communicatieproblemen zijn tussen de NetWorker-server en vProxy (poort 9090) en er geen foutmeldingen zijn over het feit dat de vProxy niet beschikbaar is in de NMC of daemon.raw.
- Open een PowerShell-beheerdersprompt (Windows) of een root-SSH-sessie (Linux) op de NetWorker-server.
- Maak een bestand zonder extensie met de naam
vmbackup_loggingonder de NetWorker/nsr/tmpDirectory:
Linux: touch /nsr/tmp/vmbackup_logging Windows: New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File
/nsr/tmp Dienovereenkomstig.
- Start de VM-back-uptaak.
- Bewaak de gerenderde daemon.log voor
Vmproxy Queuealsselect_vproxyBerichten.
Linux: /nsr/logs/daemon.log Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- Als u deze foutopsporing wilt uitschakelen, verwijdert u het
vmbackup_loggingbestand uit de/nsr/tmpDir.
Additional Information
Gerelateerde artikelen:
- NVP-vProxy Triage Guide: Overzicht van NetWorker VMware Protection vProxy Triage en logboeken
- NVP vProxy: De exacte opdrachtsyntaxis verkrijgen voor het uitvoeren van een VM-herstel vanuit CLI met foutopsporing.
- NetWorker (Linux): Bestanden kopiëren van/naar een Linux NetWorker server.
- NVP vProxy: Problemen met netwerkconnectiviteit oplossen voor back-up- en herstelbewerkingen
- NetWorker: NVP vProxy probleemoplossing voor VM-back-up en herstelprestaties en doorvoer