NetWorker VMware Protection-vProxy: come abilitare la registrazione di debug

Summary: Potrebbe essere necessario modificare il livello di registrazione in "debug" per risolvere un problema in NetWorker VMware Protection con la soluzione vProxy Appliance (NVP-vProxy). Questo articolo spiega come modificare il livello di registrazione. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Guardare questo video: Come abilitare la registrazione di debug 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 se, dopo aver coinvolto il supporto di NetWorker, il tecnico del supporto richiede un set di debug per la risoluzione dei problemi come processo specifico. 

I file di registro NVP-vProxy in vProxy Appliance si trovano nella directory seguente: /opt/emc/vproxy/runtime/logsEsiste una sottodirectory per ciascun processo principale utilizzato per le operazioni di NetWorker in vProxy Appliance:

vbackupd

vflrd

vrapid

vrecoverd

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

[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 NVP-vProxy Triage Guide: NetWorker VMware Protection vProxy Triage and Log Overview


Applicazione del metodo di debug del servizio 1:

Questo metodo si applica a vProxy 4.3.x e versioni successive.1. 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 admin vProxy.2.
  2. Passare a root:
sudo su -
  1. Passare alla directory bin dell'agent vProxy:
cd /opt/emc/vproxy/bin
  1. Per il servizio che richiede il debug, eseguire i seguenti comandi:


Backup Engine: vbackupd

daemon Entità di registrazione Esempio di utilizzo dei comandi Percorso del log
vbackupd Programma (motore principale)
./vProxy_debug.sh -s -d vbackupd -p program -l debug
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log

Registri delle singole sessioni di backup: 

/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.log
Il VDDK conserva inoltre log privati nella directory /tmp/vmware-root
       Gestione delle istantanee
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log


Engine di ripristino: vrecoverd

daemon Entità di registrazione Esempio di utilizzo dei comandi Percorso del log
vrecoverd Programma (entità principale)
./vProxy_debug.sh -s -d vrecoverd -p program -l debug
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log

Registri delle singole sessioni di ripristino: 

/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.log
Il VDDK conserva anche log privati nella directory /tmp/vmware-root


Engine FLR: vflrd

daemon Entità di registrazione Esempio di utilizzo dei comandi Posizione del registro:
vflrd Programma (motore principale)
./vProxy_debug.sh -s -d vflrd -p program -l debug
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log
Registri delle sessioni di montaggio FLR individuali:
/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
I registri completati vengono spostati in
/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


Server REST: vrapid

daemon Entità di registrazione Esempio di utilizzo dei comandi Posizione del registro:
vrapid Programma (motore principale)
./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:
warn | info | trace (impostazione predefinita) debug
  • Consente di disabilitare la registrazione DD Boost
none | error | warn | info | debug | trace (impostazione predefinita) all
  • Per il registro VDDK:
0 0: nessuna registrazione
1 = Solo errori
2 Warnings and Errors
3 3 - Errori, avvertenze e messaggi informativi importanti
4 = dati di debug più tutto il resto
  • Per il registro di Snapshot Manager:
warn | info | trace (impostazione predefinita) debug


Applicazione del metodo di debug del servizio 2:

I livelli di registrazione disponibili sono none, error, warn, info, trace e debug.

Al fine di impostare il vbackupd Processo in debug a livello di registrazione:
  1. Accedere a vProxy Appliance come amministratore tramite SSH o la console e passare a root:
sudo su -
  1. Passare a: systemd :
cd /usr/lib/systemd/system/ 
NOTA BENE: Ciascuno dei file di servizio si trova qui: vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, e così via.
  1. Aprire il file di servizio che richiede le impostazioni di debug, ad esempio:
vi vbackupd.service 
  1. 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
  1. Salvare le modifiche del file.
  2. Ricaricare il file di configurazione dell'unità digitando il comando:
systemctl daemon-reload
  1. Verificare in NetWorker Management Console che non siano in esecuzione backup, quindi riavviare il servizio vbackupd: vbackupd Servizio
systemctl restart vbackupd.service

systemctl restart vbackupd.serviceIl processo di cui sopra è applicabile per i servizi: vrapid, vrecoverd, vbackupd, vflrd.


Applicazione del debug VDDK:

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

  1. Accedere a vProxy Appliance tramite SSH o la console come amministratore e passare a root:
sudu su -
  1. 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
  1. Riavviare il servizio pertinente:
systemctl restart [service-name].service 
Ad esempio: 
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. Per rendere immediatamente applicabile questa operazione, è necessario ricaricare e riavviare il daemon, come specificato in precedenza.


Debug precertificato di DD Boost:

Questo processo può essere eseguito in combinazione con altri metodi di debug descritti in precedenza.1. 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 -
  1. Creare il file ddboost_precert.ini in /
vi /ddboost_precert.ini

Inserire quanto segue nel file:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=3
  1. Creare il file DDLog :
mkdir /DDLog ; chmod 755 /DDLog
  1. 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
  1. Verificare che l'opzione ddboost_precert.log generato, riproduce l'emissione e raccoglie le informazioni ddboost_precert.log:
ls -l /DDLog
Schermata di conferma del registro
  1. Utilizzo precert-io-perf.py per analizzare il ddboost_precert.log file: NetWorker: come analizzare le prestazioni di I/O utilizzando ddboost_precert.log
  2. 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. Eliminare il . /ddboost_precert.ini .
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 :
Linux: 
touch /nsr/tmp/vmbackup_logging

Windows: 
New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File
Il comando precedente presuppone che sia stato utilizzato il percorso di installazione predefinito di NetWorker. Se NetWorker è stato installato in una posizione diversa, regolare la posizione di /nsr/tmp di conseguenza.
  1. Avviare il processo di backup della VM.
  2. Monitorare il daemon.log sottoposto a rendering per Vmproxy Queue e select_vproxy messages
Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
In caso di domande, consultare l'articolo: NetWorker: come utilizzare nsr_render_log.
  1. Per disabilitare questo debug, eliminare il vmbackup_logging dal file dal /nsr/tmp dir.

Debug dell'interfaccia utente di vProxy:

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000022610
Article Type: How To
Last Modified: 20 أغسطس 2026
Version:  23
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.