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

Regardez cette vidéo : Activation de 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. Il ne s’agit généralement d’une exigence qu’une fois que le support NetWorker a été engagé et que l’ingénieur du support a demandé un ensemble de débogages pour le dépannage en tant que processus spécifique. 

Les fichiers journaux NVP-vProxy sur l’appliance vProxy se trouvent dans le répertoire suivant : /opt/emc/vproxy/runtime/logs.

Il existe un sous-répertoire 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 Le sous-répertoire contient les journaux 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 du journal 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 ultérieures de vProxy. 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 à vProxy via SSH à l’aide du compte administrateur vProxy.
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 (manuellement) :

1. Connectez-vous à l’appliance vProxy en tant qu’administrateur via SSH ou 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é en saisissant la commande suivante :

systemctl daemon-reload

7. Dans NetWorker Management Console, vérifiez qu’aucune sauvegarde n’est en cours d’exécution, puis redémarrez le vbackupd du serveur NMC :

systemctl restart vbackupd.service

Le processus ci-dessus s’applique aux services vrapid, vrecoverd, vbackupd, vflrd.

Application du débogage VDDK (manuellement) :

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 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 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 cette modification s’applique immédiatement, un rechargement et un redémarrage du processus sont requis, comme indiqué ci-dessus.

Débogage DD Boost Precert :

Ce processus est effectué avec d’autres méthodes de débogage décrites ci-dessus. 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 un fichier vide appelé ddboost_precert.ini sous /:

touch /ddboost_precert.ini

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

mkdir /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é, reproduit le problème et recueille les ddboost_precert.log:

ls -l /DDLog

6. 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. Supprimez 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.

Articles connexes :

• guide de tri NVP-vProxy : Présentation du tri et du journal 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) : Copier des fichiers vers/depuis un serveur NetWorker Linux.
• NVP vProxy : Connectivité réseau pour les opérations de sauvegarde et de restauration
• NetWorker : Dépannage de NVP vProxy - Sauvegarde et restauration des performances et du débit d’une machine virtuelle