Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

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

Summary: Le passage au niveau de journalisation « debug » peut s’avérer nécessaire pour résoudre un problème avec NetWorker VMware Protection à l’aide de la solution vProxy Appliance (NVP-vProxy). Cet article explique comment modifier le niveau de journalisation. ...

This article may have been automatically translated. If you have any feedback regarding its quality, please let us know using the form at the bottom of this page.

Article Content


Instructions

 
 



Généralement, il suffit d’analyser les fichiers journaux de règles sur le serveur NetWorker à l’emplacement …/nsr/logs/policy/[nom de la règle]. Cependant, il peut parfois être nécessaire d’analyser les fichiers journaux sur l’appliance vProxy elle-même, voire d’augmenter le niveau de journalisation à « debug » afin d’identifier plus clairement la cause 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/logs

Il 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, le sous-répertoire vbackupd comprend les journaux :
[session-uuid].log                    Détails de traitement d’une session
vbackupd-engine.log                Événements liés aux demandes et problèmes, y compris les messages d’erreur et de fonctionnement inattendu du journal de session.
vbackupd-boost.log                 Journalisation DDBoost.
vbackupd-snapmgr.log             Journalisation des snapshots
vbackupd-vddk.log                   Journalisation VDDK -  VMware Virtual Disk Development Kit

Vous trouverez des informations supplémentaires sur la journalisation et la collecte vProxy dans : guide de tri NVP-vProxy : Guide de tri et de collecte des logs de vProxy NetWorker VMware Protection (en anglais)
 

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. Connectez-vous au 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. Exécutez la commande suivante pour le service que vous souhaitez déboguer (vbackupd, vflrd, vrapid, vrecoverd) :
 
./vProxy_debug.sh -s -d NOM_DU_SERVICE -p program -l debug

niveau moteur : {debug, trace, info, warn} (« trace » par défaut)

Exemple de mise en débogage de vflrd :

image.png

Remarque : les messages de débogage devraient s’afficher dans le fichier engine.log des services, comme indiqué ci-dessus.

Pour désactiver le débogage, vous pouvez rétablir le service sur « trace ».

./vProxy_debug.sh -s -d NOM_DU_SERVICE -p program -l trace

 

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

Les niveaux de journalisation disponibles sont les suivants : none, error, warn, info, trace, debug

Afin de définir le niveau de journalisation « debug » pour le processus vbackupd, procédez ainsi :
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. Accédez au répertoire systemd : cd /usr/lib/systemd/system/ 
Remarque : tous les fichiers de service se trouvent ici : vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service et ainsi de suite.
3. Ouvrez le fichier de service sur lequel vous souhaitez appliquer le débogage, par exemple : vi vbackupd.service 
4. Localisez la ligne avec ExecStart= et ajoutez-y --program-log-level=debug

Autres paramètres :
  --engine-log-level=string
        Niveau de journalisation du moteur vProxy 2.x : {debug, trace, info, warn}.
  --program-log-level=string (vbackupd)
        Niveau du moteur vProxy 3.x et versions supérieures : {debug, trace, info, warn} (« trace » par défaut)
  --version
        version d’affichage

Remarque : la version NVP-vProxy s’affiche dans l’onglet « Configuration » des propriétés Vproxy dans NetWorker Management Console :
              - NMC -> Devices -> VMware Proxies -> Clic droit sur l’appliance vProxy -> Properties -> Onglet Configuration -> VM proxy version

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 :

    systemctl restart vbackupd.service

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

 

Application du débogage VDDK :

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. Ajoutez la ligne suivante au fichier VixDiskLib.config : vi /opt/emc/vproxy/conf/VixDiskLib.config
vixDiskLib.transport.LogLevel=4

0 = Aucune journalisation
1 = Erreurs uniquement
2 = Avertissements et erreurs
3 = Messages d’information importants, erreurs et avertissements
4 = Données de débogage et toutes les autres informations 
   
3. Redémarrez le service concerné :
           systemctl restart [nom-du-service].service 
Par exemple :  systemctl restart vrecoverd.service

Une fois le niveau de journalisation défini sur débogage, vous pouvez vérifier dans le fichier journal correspondant que des messages commençant par le mot « debug » y figurent.

À la fin du processus de débogage, vous pouvez réinitialiser le niveau de journalisation selon la même procédure. Utilisez alors le mot « trace » après le signe égal au lieu du mot « debug ».  Pour que ce changement s’applique immédiatement, vous devez recharger et redémarrer le processus, comme indiqué ci-dessus.


Débogage DDBoost :

Ce processus peut être effectué en association avec les autres méthodes de débogage décrites ci-dessus.

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 vbackupd.service.xml : vi /usr/lib/systemd/system/SERVICE.service

Activez le débogage en fonction des actions en cours d’exécution qui nécessitent cette opération. Le débogage DDboost peut être activé sur les services suivants :

/usr/lib/systemd/system/vbackupd
/usr/lib/systemd/system/vflrd
/usr/lib/systemd/system/vrecoverd


3. Sur la ligne qui comprend « ExecStart », ajoutez : --boost-log-level=debug
  --boost-log-level=string
        Niveau de journalisation DD Boost : {none, error, warn, info, debug, trace, all} (« erreur » par défaut)

Exemple de service vbackupd :

ExecStart=/opt/emc/vproxy/bin/vbackupd --boost-log-level=debug​


4. Créez un fichier ddboost_precert.ini sous / : touch /ddboost_precert.ini
5. Créez le répertoire DDLog sous / : mkdir /DDLog
6. Rechargez le processus : systemctl daemon-reload
7. Redémarrez vbackupd.service : systemctl restart SERVICE.service

Redémarrez le service pour lequel le débogage a été activé, par exemple :

systemctl restart vbackupd.service

8. Vérifiez que le service est disponible : systemctl status SERVICE.service

Exemple :

systemctl status vbackupd.service

9. Vérifiez que le fichier vbackupd-ddboost.log affiche « debug » :

Exemple de vérification des paramètres appliqués à vbackupd :

cat /opt/emc/vproxy/runtime/logs/vbackupd/vbackupd-boost.log | grep "set to"

10. Vérifiez que le journal ddboost_precert.log est bien généré : ls -l /DDLog

image.png

Lorsque les opérations de débogage ne sont plus nécessaires, supprimez « --boost-log-leve=debug » du fichier de service, rechargez le processus et redémarrez le service.

 

 

Additional Information

Article Properties


Affected Product

NetWorker

Product

NetWorker, NetWorker Series

Last Published Date

16 Apr 2024

Version

9

Article Type

How To