NetWorker VMware Protection (NVP)-vProxy : Activation de la journalisation de débogage
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.
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
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 :
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 :
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)
10. Vérifiez que le journal ddboost_precert.log est bien généré : ls -l /DDLog
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.