NetWorker VMware Protection-vProxy : activation de la journalisation de débogage

Regardez cette vidéo : Comment activer la journalisation du débogage vProxy.

Méthodes d’application du débogage du moteur vProxy :

En général, il suffit d’analyser les journaux de politique du NetWorker Server dans /nsr/logs/policy/[policy name], mais il peut parfois être nécessaire d’analyser les logs à partir de l’appliance vProxy elle-même et, en outre, d’augmenter le niveau de journalisation à déboguer afin d’avoir une idée plus claire de la raison d’une défaillance. Cette exigence n’intervient habituellement qu’une fois le support NetWorker engagé et après que l’ingénieur du support a demandé un ensemble de débogages pour le dépannage dans le cadre d’un processus spécifique. 

Les fichiers journaux NVP-vProxy sur l’appliance vProxy se trouvent dans le répertoire suivant : /opt/emc/vproxy/runtime/logsIl existe des sous-répertoires pour chacun des processus principaux utilisés pour les opérations NetWorker sur l’appliance vProxy :

vbackupd

vflrd

vrapid

vrecoverd

Par exemple, l’option vbackupd contient les logs suivants :

[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

Vous trouverez des informations supplémentaires sur la journalisation et la collecte vProxy dans l’article Guide de triage NVP-vProxy : Présentation du tri et des journaux NetWorker VMware Protection vProxy

Application de la méthode de débogage de service 1 :

Cette méthode s’applique aux versions 4.3.x et supérieures de vProxy.1. Il peut être utilisé pour activer le débogage sur les services vProxy (vrapid, vrecoverd, vbackupd, vflrd). Un débogage supplémentaire peut être activé pour le trafic DD Boost, le kit de développement de disque virtuel (VDDK) et la messagerie de snapshot (le cas échéant).

1. Connectez-vous au vProxy via SSH à l’aide du compte administrateur vProxy.2.
2. Passez à l’utilisateur root :

sudo su -

3. Rendez-vous dans le répertoire bin de l’agent vProxy :

cd /opt/emc/vproxy/bin

4. Pour le service nécessitant un débogage, exécutez les commandes suivantes :

Moteur de sauvegarde 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

Restaurer le moteur : 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

Moteur 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

Serveur REST : vrapid

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

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

Les commandes ci-dessus montrent l’activation du débogage. Ces commandes peuvent être réexécutées en modifiant le paramètre -l option de réinitialisation à la valeur par défaut :

Options :

• Pour le journal du programme :

• Pour le journal DD Boost :

• Pour le journal VDDK :

• Pour le journal Snapshot Manager :

Application de la méthode de débogage de service 2 :

1. Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :

sudo su -

2. Rendez-vous sur le systemd répertoire :

cd /usr/lib/systemd/system/ 

3. Ouvrez le fichier de service qui nécessite des paramètres de débogage, par exemple :

vi vbackupd.service 

4. Localisez la ligne avec ExecStart= et ajoutez-le avec les paramètres de débogage souhaités :

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. Enregistrez les changements apportés au fichier.
6. Rechargez le fichier de configuration de l’unité à l’aide de la commande :

systemctl daemon-reload

7. Confirmez dans NetWorker Management Console qu’aucune sauvegarde n’est en cours d’exécution, puis redémarrez le service vbackupd : vbackupd Service

systemctl restart vbackupd.service

systemctl restart vbackupd.serviceLe processus ci-dessus s’applique aux services suivants : vrapid, vrecoverd, vbackupd, vflrd.

Application du débogage VDDK :

Le débogage de VMware Disk Development Kit (VDDK) peut être appliqué manuellement dans VixDiskLib.config . Ce débogage s’applique uniquement à vbackupd et vrecoverd la procédure de dépannage. Elle ne s’applique pas à vflrd.
 

1. Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :

sudu su -

2. Modifiez le fichier VixDiskLib.config doit contenir la ligne suivante :

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. Redémarrez le service concerné :

systemctl restart [service-name].service 

systemctl restart vrecoverd.service

Une fois la journalisation du débogage définie, le fichier journal associé au service doit contenir des lignes DEBUG.

Une fois le processus de débogage terminé, réinitialisez le niveau de journalisation en suivant la même procédure, en utilisant le mot trace après le signe égal au lieu de debug. Pour que ce changement s’applique immédiatement, vous devez recharger et redémarrer le processus, comme indiqué ci-dessus.

Débogage DD Boost Precert :

Ce processus peut être effectué en association avec les autres méthodes de débogage décrites ci-dessus.1. Par défaut, la bibliothèque DD Boost ne consigne pas l’activité détaillée de l’API (Application Programming Interface). L’activation de la journalisation precert DD Boost ne doit être effectuée que lorsque d’autres erreurs liées à DD Boost sont observées dans le vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log fichiers et un débogage supplémentaire est nécessaire. Cela n’est généralement nécessaire que lorsque le support NetWorker le demande directement pour des collaborations Data Domain ou des engagements d’ingénierie.

1. Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :

sudu su -

2. Créez le fichier ddboost_precert.ini sous /: 

vi /ddboost_precert.ini

Ajoutez ce qui suit au fichier :

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

3. Créez le fichier DDLog répertoire :

mkdir /DDLog ; chmod 755 /DDLog

4. Activez le débogage DD Boost pour le service nécessitant le débogage :

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. Vérifiez que l’option ddboost_precert.log est générée, reproduire le problème et collecter les ddboost_precert.log:

ls -l /DDLog

6. Use precert-io-perf.py pour analyser les ddboost_precert.log files : NetWorker : Comment analyser les performances d’E/S à l’aide de ddboost_precert.log
7. Lorsque les opérations de débogage ne sont plus nécessaires :
   1. Exécutez à nouveau la commande suivante sur le service pour lequel vous avez activé le débogage ddboost :

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

1. 2. Supprimer le /ddboost_precert.ini .

rm -rf /ddboost_precert.ini

Journalisation de la sélection vProxy :

Ce débogage peut être utilisé chaque fois qu’un workflow de sauvegarde de machine virtuelle (VM) est bloqué avec les machines virtuelles en attente d’exécution. Dans ce scénario, la procédure de sauvegarde a démarré, mais aucun vProxy n’a été récupéré pour démarrer la session de sauvegarde. Il n’y a pas de journalisation du processus de sélection vProxy dans la journalisation standard. Nous pouvons activer vmbackup_logging sur le NetWorker Server, qui consigne le processus de sélection vProxy lors du démarrage de la politique de protection VMware. Cela est utile lorsqu’il n’y a aucun problème de communication entre le NetWorker Server et vProxy (port 9090) et qu’il n’y a pas d’erreur liée à l’indisponibilité du vProxy dans NMC ou daemon.raw.

1. Ouvrez une invite d’administration PowerShell (Windows) ou une session SSH root (Linux) sur le NetWorker Server.
2. Créez un fichier sans extension appelé vmbackup_logging sous NetWorker /nsr/tmp répertoire :

Linux: 
touch /nsr/tmp/vmbackup_logging

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

3. Démarrez la procédure de sauvegarde de la machine virtuelle.
4. Surveillez le rendu daemon.log pour Vmproxy Queue et select_vproxy messages

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

5. Pour désactiver ce débogage, supprimez la commande vmbackup_logging du fichier de l' /nsr/tmp dir.

Débogage de l’interface utilisateur vProxy :

• NVP-vProxy : Guide de dépannage de Data Protection Restore Client (DPRC)
• NVP-vProxy : dépannage du plugin vCenter et de l’interface utilisateur (VCUI)

Articles connexes :

• Guide de tri NVP-vProxy : Présentation du tri et des journaux de NetWorker VMware Protection vProxy
• NVP vProxy : comment obtenir la syntaxe de commande exacte pour exécuter une récupération de machine virtuelle à partir de l’interface de ligne de commande avec débogage.
• NetWorker (Linux) : copie de fichiers vers/depuis un serveur NetWorker Linux.
• NVP vProxy : dépannage de la connectivité réseau pour les opérations de sauvegarde et de restauration
• NetWorker : NVP vProxy - Dépannage des performances et du débit de sauvegarde et de restauration des machines virtuelles