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. ...
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).
- Connettersi a vProxy tramite SSH utilizzando l'account admin vProxy.2.
- Passare a root:
sudo su -
- Passare alla directory bin dell'agent vProxy:
cd /opt/emc/vproxy/bin
- 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.logIl 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.logIl 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.logRegistri 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>.logI 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:
Al fine di impostare il
vbackupd Processo in debug a livello di registrazione:
- Accedere a vProxy Appliance come amministratore tramite SSH o la console e passare a root:
sudo su -
- Passare a:
systemd:
cd /usr/lib/systemd/system/
vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, e così via.
- Aprire il file di servizio che richiede le impostazioni di debug, ad esempio:
vi vbackupd.service
- 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
- Salvare le modifiche del file.
- Ricaricare il file di configurazione dell'unità digitando il comando:
systemctl daemon-reload
- Verificare in NetWorker Management Console che non siano in esecuzione backup, quindi riavviare il servizio vbackupd:
vbackupdServizio
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.
- Accedere a vProxy Appliance tramite SSH o la console come amministratore e passare a root:
sudu su -
- Modificare la proprietà
VixDiskLib.configfile 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
- 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. 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.
- Accedere a vProxy Appliance tramite SSH o la console come amministratore e passare a root:
sudu su -
- Creare il file
ddboost_precert.iniin/:
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
- Creare il file
DDLog:
mkdir /DDLog ; chmod 755 /DDLog
- 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
- Verificare che l'opzione
ddboost_precert.loggenerato, riproduce l'emissione e raccoglie le informazioniddboost_precert.log:
ls -l /DDLog
- Utilizzo
precert-io-perf.pyper analizzare ilddboost_precert.logfile: NetWorker: come analizzare le prestazioni di I/O utilizzando ddboost_precert.log - Quando le operazioni di debug non sono più necessarie:
- 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
-
- Eliminare il .
/ddboost_precert.ini.
- Eliminare il .
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.
- Aprire un prompt amministrativo di PowerShell (Windows) o una sessione SSH root (Linux) sul server NetWorker.
- Creare un file senza estensione chiamato
vmbackup_loggingsotto 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
/nsr/tmp di conseguenza.
- Avviare il processo di backup della VM.
- Monitorare il daemon.log sottoposto a rendering per
Vmproxy Queueeselect_vproxymessages
Linux: /nsr/logs/daemon.log Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- Per disabilitare questo debug, eliminare il
vmbackup_loggingdal file dal/nsr/tmpdir.
Debug dell'interfaccia utente di vProxy:
Additional Information
Articoli correlati:
- Guida alla valutazione di NVP-vProxy: 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: risoluzione dei problemi di prestazioni e throughput di backup e restore delle VM tramite NVP vProxy