NetWorker Management Web UI (NWUI) : guide de tri et de dépannage (en anglais)

Résumé: NetWorker Management Web UI (NWUI) : guide de tri et de dépannage (en anglais)

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.
Consulter d’autres ressources

Instructions

Fonctionnement de NWUI

NetWorker Web User Interface (NWUI) utilise les technologies suivantes : HTML5, Apache Tomcat, Spring Framework, Angular Framework et API (Representational State Transfer) Application Programming Interface (API). L’application NWUI peut être installée sur les systèmes d’exploitation Linux ou Windows. Il peut être installé directement sur le serveur NetWorker ou sur un hôte qui n’est pas le serveur NetWorker.


                  Composants de NWUI 


Il existe quatre composants importants :
Ces composants peuvent se trouver sur le même hôte ou sur des hôtes distincts.
  • Frontend Web :  Il s’agit de la couche de présentation écrite en HTML5 et Angular Framework qui présente les opérations NetWorker à l’utilisateur via un navigateur Web. Le navigateur Web est connecté aux processus back-end de l’interface utilisateur.
  • Back-end de l’interface utilisateur:  L’application back-end est écrite dans Spring Framework.  Il utilise java et Apache Tomcat. La communication entre le front-end et le back-end et entre le back-end et le NetWorker Server s’effectue à l’aide d’appels d’API REST internes. Le processus NWUI utilise l’instance Apache Tomcat existante sur le NetWorker Server ou installe sa propre instance Apache Tomcat si elle est installée à distance à partir du NetWorker Server.
  • NetWorker Server: Le cadre REST de NetWorker Server est chargé de recevoir les appels de l’API REST du back-end de l’interface utilisateur et de les connecter aux composants principaux de NetWorker Server. Le bus de messages RabbitMQ du serveur NetWorker est également utilisé pour interagir avec nsrjobd.
  • AUTHC : Le composant AUTHC de NetWorker est utilisé pour tous les besoins d’authentification. Le processus de demande contacte AuthC pour vérifier les informations d’identification ; après vérification, AuthC émet un jeton temporel, signé, chiffré et basé sur le temps. Les composants NetWorker utilisent ce token pour vérifier l’utilisateur et autoriser ou non une opération demandée. Cette option est généralement installée sur le serveur NetWorker, mais elle peut être installée sur un hôte distinct. 
La plupart des communications s’effectuent à l’aide de l’API REST, qui permet d’interagir avec les ressources identifiées par des adresses URI (Uniform Resource Identifier). Il utilise des verbes HTTP (HEAD, GET, PUT, POST, DELETE) pour interagir avec les URI (Uniform Resource Identifiers) sans état. Ces appels d’API REST sont internes aux opérations NetWorker et NWUI.

a { text-decoration : none ; color : #464feb ; } tr th, tr td { border : 1px #e6e6e6 solide ; } tr th { background-color : #f5f5f5 ; } Ne les confondez pas avec l’API REST NetWorker, qui permet des opérations personnalisées et est documentée dans le NetWorker REST API Developer Guide.

Dépannage

Définition du problème

DÉTAILS DU
PROBLÈMEAfin de générer une description complète du problème, posez-vous les questions suivantes :
  • Quelle opération est tentée et ne fonctionne pas ?
  • Cette opération fonctionne-t-elle lorsqu’elle est lancée depuis l’extérieur de NWUI (par exemple : À partir de NetWorker Management Console (NMC) ?
  • Le problème est-il persistant ou intermittent ?
  • S’il est intermittent, existe-t-il un déclencheur connu ?
  • Cela fonctionnait-il mieux avant, et si oui, y a-t-il des modifications connues appliquées avant et après l’apparition du problème ?
  • Quand le problème s’est-il produit pour la première fois (et qu’est-ce qui a changé depuis son apparition) ?
  • Le problème se produit-il uniquement lors de périodes de charge importante sur l’environnement de sauvegarde ?
  • Quelle est l’étendue du problème (toutes les opérations de récupération ou certaines opérations de récupération, certains onglets ne fonctionnent pas tandis que d’autres ne sont pas affectés) ?
  • Qu’a-t-on essayé de corriger jusqu’à présent et quelles conclusions en a-t-on tirées ?

DÉTAILS DE L’ENVIRONNEMENT
  • Quelle est la version de NetWorker Server et la plate-forme de système d’exploitation ?
  • NWUI est-il installé sur le serveur NetWorker ou sur un hôte distinct ?
    • Quelle est la version de NWUI s’il est installé sur un hôte distinct du NetWorker Server ?
  • Quel package Java est installé sur le serveur NWUI ? NetWorker Runtime Environment (NRE) est-il installé ou Oracle Java Runtime Environment (JRE).
Authentification
L’authentification utilise AUTHC de la même manière que NetWorker Management Console et nsrlogin . Pour les problèmes d’authentification, commencez par tester l’authentification sur le NetWorker Server afin de déterminer si le problème est lié à NWUI ou au serveur lui-même. Si vous utilisez AD ou LDAP pour l’authentification, commencez par effectuer un test avec les comptes NetWorker locaux pour vérifier si le problème affecte uniquement l’authentification externe.

Voici une commande classique utilisée pour tester que le processus d’authentification fonctionne comme prévu sur le serveur NetWorker :   
authc_mgmt -u [user name] -p [password] -e find-all-users.

ou :

Compte NetWorker local :

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Compte externe (AD/LDAP) : 
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
Le Guide de configuration de la sécurité de NetWorker contient des informations détaillées sur le fonctionnement de l’authentification NetWorker, sur la façon de la tester et sur la façon de réinitialiser un mot de passe si nécessaire.

Si un diagnostic d’authentification plus approfondi est nécessaire, consultez :  NetWorker : Activation du débogage AUTHC à des fins de dépannage

Problèmes d’installation
Pour plus d’informations sur l’installation de NWUI et sur les journaux à consulter en cas de problème lors de l’installation, reportez-vous à l’article suivant :
NetWorker Management Web UI (NWUI) : Procédure d’installation                   

 

Problèmes liés au back-end de l’interface utilisateur

Les journaux back-end importants de l’interface utilisateur sont les suivants :
Chemin Linux Chemin Windows (par défaut) Fonction
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Journalisation du serveur Tomcat et journalisation du déploiement d’applications.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Journalisation du serveur d’applications NWUI.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log Journalisation de NetWorker REST API. NWUI communique avec le serveur NetWorker à l’aide de l’API REST NetWorker. Reportez-vous à la section API REST de cet article pour savoir comment diagnostiquer les fonctions de l’API REST utilisées, ainsi que la réponse correspondante.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Journalisation du NetWorker Server

Si le serveur NWUI se trouve sur le NetWorker Server lui-même, il partage la même instance tomcat avec NetWorker.
Si vous fournissez un .raw Fichier log à supporter, il est conseillé de restituer le fichier log sur le système d’où il provient. Cela garantit que les horodatages sont affichés à l’heure locale du serveur : NetWorker : Comment utiliser nsr_render_log

Fichiers journaux

Linux :

Les processus qui s’exécutent pour le back-end de l’interface utilisateur sont les suivants :  /opt/nwui/bin/nwuictld et jsvc.exec Vous pouvez vérifier s’ils fonctionnent avec l’option ps WMIC suivante : 
ps -ef | grep nwui
                  Sortie ps affichant le back-end NWUI 
Les journaux sont disponibles ici :

Local pour le serveur NetWorker :
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
À distance (le serveur NWUI se trouve sur un hôte distinct du serveur NetWorker) :
  • /opt/nwui/logs
  • /nsr/nwui/logs   
La commande suivante peut être utilisée pour créer un fichier zip de ces journaux 
tar cvzfP /tmp/$(hostname)_$(date -I).tgz  /opt/nwui/logs  /nsr/nwui/logs  /nsr/authc/logs  /nsr/logs/daemon.raw  /nsr/logs/restapi  /nsr/nwui/monitoring/app/logs/ ; chmod 777 /tmp/$(hostname)_$(date -I).tgz ; ls -lth /tmp/$(hostname)_$(date -I).tgz
Remarque : Selon que NWUI est locale ou distante du serveur NetWorker, la commande ci-dessus peut signaler que certains répertoires sont manquants. Ce comportement est normal. Le nom d’hôte et la date n’ont pas besoin d’être modifiés. La commande ci-dessus crée automatiquement le bundle avec le nom d’hôte du serveur et la date du jour (AAAA-MM-JJ).
Windows

Le processus back-end NWUI Windows qui doit être en cours d’exécution est appelé nwuictld.exe :


                  Liste des tâches affichant le service NWUI 

Vous pouvez gérer cela à partir de services.msc:

                  Console des services affichant NWUI 
 

Les journaux se trouvent ici :

Local sur le serveur NetWorker
  • C:\Program Files\EMC NetWorker\nwui\logs\
  • C:\Program Files\EMC NetWorker\nsr\authc-server\logs
  • C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log
  • C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • C:\Program Files\EMC NetWorker\nwui\monitoring\app\logs\
Distant : 
  • C:\Program Files\EMC NetWorker\nwui\logs
  • %LOCALAPPDATA%\TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%\TempNetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
Remarque : Les chemins indiqués correspondent au chemin d’installation par défaut de NetWorker. Si NetWorker a été installé sur un autre disque ou via un autre chemin, ajustez en conséquence.
 
Serveur NetWorker

Exécutez l’outil nsrget sur le NetWorker Server pour collecter les logs pertinents :
Networker: Utilisation de l’outil

de collecte de données NSRGet NetWorkerLes journaux les plus pertinents dépendent de l’opération tentée à partir de NWUI. Pour plus d’informations sur les journaux NetWorker, consultez :
Networker: Fichiers journaux et emplacements

Débogage

Afin de déboguer la communication de l’API REST, modifiez le niveau de débogage dans le logback.xml fichier sur le serveur NetWorker :

Windows (par défaut) : C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux : /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  Fichier logback 

Supprimez les commentaires des lignes relatives à la journalisation des appels d’API. Cela entraîne la définition du niveau de journalisation sur « trace » pour les demandes et les réponses de l’API REST.

                  Paramètres de débogage 

Voir : NetWorker : Activation du débogage de l’API REST

 

API REST

NWUI utilise l’API REST pour interagir avec NetWorker. Les logs des API NWUI et REST affichent les fonctions de l’API et les réponses NetWorker, mais ces informations peuvent également être consultées directement dans le navigateur. Cette méthode est utile pour rechercher des divergences entre les interfaces utilisateur et l’interface de ligne de commande NetWorker ou lorsque l’interface utilisateur ne renvoie pas les résultats attendus. 

 

  1. Lorsque vous accédez à NWUI, cliquez avec le bouton droit de la souris dans la fenêtre du navigateur et sélectionnez Inspect.

Inspecter

  1. Dans la fenêtre « Inspect » du navigateur, cliquez sur l’onglet Network :

Navigateur Inspecter le réseau

  1. Lors de l’exécution de fonctions dans NWUI, les opérations s’affichent sous Name. La colonne État inclut l’état d’achèvement de l’API REST : Demande et réponse de l’API 
  2. Cliquez sur l’opération que vous souhaitez examiner plus en détail. Par exemple, en cliquant sur la fonction de sauvegarde illustrée ci-dessus, les détails suivants s’affichent dans l’onglet En-têtes :

À partir de là, l’URL de la demande, la méthode de demande et le code d’état sont tous identifiables.

  1. Pour afficher la charge utile de réponse, cliquez sur l’onglet Responses .

 

Cet exemple illustre la réponse de l’API REST utilisée pour renseigner l’onglet Restauration et savesets après avoir parcouru les sauvegardes Azure et sélectionné un saveset à restaurer.

Informations supplémentaires

Ressources NWUI

NetWorker Management Web UI (NWUI) :  Mode d’emploi             
NetWorker Management Web UI (NWUI) :  Procédure d’installation          
NetWorker Management Web UI (NWUI) : guide de tri et de dépannage (en anglais)

Produits concernés

NetWorker

Produits

NetWorker, NetWorker Series
Propriétés de l’article
Numéro d’article: 000010592
Type d’article: How To
Dernière modification: 19 Dec 2025
Version:  5
Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
Services de support
Vérifiez si votre appareil est couvert par les services de support.