NetWorker VMware Protection-vProxy: come abilitare la registrazione debug

Guarda questo video: Come abilitare la registrazione di debug di vProxy.

Metodi per l'applicazione del debug dell'engine vProxy:

In genere, è sufficiente analizzare i log delle policy del server NetWorker in /nsr/logs/policy/[policy name], ma occasionalmente potrebbe essere necessario analizzare i log dall'appliance vProxy stesso e, inoltre, aumentare il livello di registrazione da sottoporre a debug per avere un'idea più chiara del motivo di un errore. Ciò è in genere richiesto solo dopo aver coinvolto il supporto NetWorker e aver richiesto al tecnico del supporto di eseguire il debug set per la risoluzione dei problemi come processo specifico. 

I file di registro NVP-vProxy sull'appliance vProxy si trovano nella directory seguente: /opt/emc/vproxy/runtime/logs.

Esiste una sottodirectory per ciascuno dei processi principali utilizzati per le operazioni di NetWorker sull'appliance vProxy:

vbackupd

vflrd

vrapid

vrecoverd

Ad esempio, la proprietà vbackupd contiene i seguenti registri:

[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

Ulteriori informazioni sulla registrazione e sulla raccolta di vProxy sono disponibili nell'articolo Guida alla valutazione di NVP-vProxy: Panoramica della valutazione e del registro di NetWorker VMware Protection vProxy

Applicazione del metodo di debug del servizio 1:

Questo metodo si applica a vProxy versione 4.3.x e successive. Può essere utilizzato per abilitare il debug sui servizi vProxy (vrapid, vrecoverd, vbackupd, vflrd). È possibile abilitare ulteriori debug per il traffico di DD Boost, il Virtual Disk Development Kit (VDDK) e la messaggistica delle istantanee (ove applicabile).

1. Connettersi a vProxy tramite SSH utilizzando l'account amministratore di vProxy.
2. Passare a root:

sudo su -

3. Passare alla directory bin dell'agent vProxy:

cd /opt/emc/vproxy/bin

4. Per il servizio che richiede il debug, eseguire i seguenti comandi:

Backup Engine: vbackupd

./vProxy_debug.sh -s -d vbackupd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log

/opt/emc/vrproxy/runtime/logs/vbackupd/BackupVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vbackupd/<DATE>/BackupVmSession-<session-id>.log

./vProxy_debug.sh -s -d vbackupd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log

./vProxy_debug.sh -s -d vbackupd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.log

./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log

Engine di ripristino: vrecoverd

./vProxy_debug.sh -s -d vrecoverd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log

/opt/emc/vrproxy/runtime/logs/vrecoverd/RecoverVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vrecoverd/<DATE>/RecoverVmSession-<session-id>.log

./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log

./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.log

Engine FLR: vflrd

./vProxy_debug.sh -s -d vflrd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log

/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>.log

/opt/emc/vrproxy/runtime/logs/recycle/vflrd

./vProxy_debug.sh -s -d vflrd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log

Server REST: vrapid

./vProxy_debug.sh -s -d vrapid -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log

I comandi precedenti mostrano l'abilitazione del debug, questi comandi possono essere rieseguiti, modificando il -l opzione per ripristinare le impostazioni predefinite:

Opzioni:

• Per il registro del programma:

• Per DD Boost Log:

• Per il registro VDDK:

• Per il registro di Snapshot Manager:

Applicazione del metodo di debug del servizio 2 (manualmente):

1. Accedere a vProxy Appliance come amministratore tramite SSH o la console e passare a root:

sudo su -

2. Accedere al systemd Directory:

cd /usr/lib/systemd/system/ 

3. Aprire il file di servizio che richiede le impostazioni di debug, ad esempio:

vi vbackupd.service 

4. Individuare la riga con ExecStart= e aggiungere con i parametri di debug desiderati:

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

5. Salvare le modifiche del file.
6. Ricaricare il file di configurazione dell'unità digitando il comando:

systemctl daemon-reload

7. Verificare in NetWorker Management Console che non siano in esecuzione backup, quindi riavviare vbackupd del server NMC:

systemctl restart vbackupd.service

Il processo di cui sopra è applicabile ai servizi vrapid, vrecoverd, vbackupd, vflrd.

Applicazione del debug VDDK (manualmente):

Il debug del VMware Disk Development Kit (VDDK) può essere applicato manualmente in VixDiskLib.config di NetWorker. Questo debug si applica solo a vbackupd e vrecoverd Risoluzione dei problemi relativi. Non si applica a vflrd.
 

1. Accedere a vProxy Appliance tramite SSH o la console come amministratore e passare a root:

sudu su -

2. Modificare la proprietà VixDiskLib.config file contenente la seguente riga:

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

3. Riavviare il servizio pertinente:

systemctl restart [service-name].service 

systemctl restart vrecoverd.service

Una volta impostata la registrazione di debug, il file di log associato al servizio deve contenere le righe DEBUG.

Dopo aver completato il processo di debug, reimpostare il livello di registro utilizzando la stessa procedura, utilizzando la parola trace dopo il segno di uguale anziché debug. Affinché questa modifica sia immediatamente applicabile, è necessario ricaricare e riavviare il daemon, come descritto in precedenza.

Debug precertificato di DD Boost:

Questo processo viene eseguito con altri metodi di debug descritti in precedenza. Per impostazione predefinita, la libreria DD Boost non registra l'attività API (Application Programming Interface) dettagliata. L'abilitazione della registrazione dei precertificati di DD Boost deve essere eseguita solo quando si osservano altri errori correlati a DD Boost in vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log file e debug aggiuntivi sono necessari. Questa operazione è in genere necessaria solo se richiesto direttamente dal supporto NetWorker per collaborazioni o impegni tecnici con Data Domain.

1. Accedere a vProxy Appliance tramite SSH o la console come amministratore e passare a root:

sudu su -

2. Creare un file vuoto denominato ddboost_precert.ini in /:

touch /ddboost_precert.ini

3. Creare il file DDLog Directory:

mkdir /DDLog

4. Abilitare DD Boost debug per il servizio che richiede il debug:

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

5. Verificare che l'opzione ddboost_precert.log generato, riproduce l'emissione e raccoglie le informazioni ddboost_precert.log:

ls -l /DDLog

6. Quando le operazioni di debug non sono più necessarie:
   1. Eseguire nuovamente il comando seguente sul servizio per il quale è stato abilitato il debug ddboost:

/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace

1. 2. Eliminare il /ddboost_precert.ini di NetWorker.

rm -rf /ddboost_precert.ini

Registrazione della selezione di vProxy:

Questo debug può essere utilizzato ogni volta che un flusso di lavoro di backup di una macchina virtuale (VM) è bloccato con le VM in attesa di esecuzione. In questo scenario, il processo di backup è stato avviato ma non è stato prelevato alcun vProxy per avviare la sessione di backup. Il processo di selezione di vProxy non viene registrato nella registrazione standard. Possiamo abilitare vmbackup_logging sul server NetWorker, che registra il processo di selezione del vProxy durante l'avvio della policy di protezione VMware. Questa opzione è utile quando non sono presenti problemi di comunicazione tra il server NetWorker e vProxy (porta 9090) e non vi sono errori relativi alla non disponibilità di vProxy in NMC o daemon.raw.

1. Aprire un prompt amministrativo di PowerShell (Windows) o una sessione SSH root (Linux) sul server NetWorker.
2. Creare un file senza estensione chiamato vmbackup_logging sotto la finestra di dialogo NetWorker /nsr/tmp Directory:

Linux: 
touch /nsr/tmp/vmbackup_logging

Windows: 
New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File

3. Avviare il processo di backup della VM.
4. Monitorare il daemon.log sottoposto a rendering per Vmproxy Queue e select_vproxy Messaggi.

Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log

5. Per disabilitare questo debug, eliminare il vmbackup_logging dal file dal /nsr/tmp Dir.

Articoli correlati:

• NVP-vProxy Triage Guide: Panoramica della valutazione e del registro di NetWorker VMware Protection vProxy
• NVP vProxy: Come ottenere la sintassi esatta del comando per l'esecuzione del ripristino di una macchina virtuale dalla CLI con debug.
• NetWorker (Linux): Come copiare file da/verso un server NetWorker Linux.
• NVP vProxy: risoluzione dei problemi di connettività di rete per le operazioni di backup e ripristino
• NetWorker: NVP vProxy - Risoluzione dei problemi di prestazioni e throughput relativi al backup e al ripristino di macchine virtuali (in inglese)