NetWorker Management Web UI (NWUI) : Guide de tri et de dépannage

Summary: NetWorker Management Web UI (NWUI) : Guide de tri et de dépannage

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

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.


                  kA5f10000004LFmCAM_1_0


Il existe quatre composants importants :
Ces composants peuvent se trouver sur le même hôte ou sur des hôtes distincts.
  • Front-end 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. Ils ne doivent pas être confondus avec l’interface de l’API REST NetWorker qui fournit un accès par programmation à NetWorker pour programmer des opérations personnalisées, comme décrit 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 l’apparition du problème) ?
  • 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/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 la commande nsrlogin . Pour les problèmes d’authentification, commencez par tester l’authentification sur le serveur NetWorker lui-même afin de déterminer si le problème d’authentification est lié ou non à NWUI. Si vous utilisez une méthode d’authentification externe telle qu’AD ou LDAP, il est conseillé de commencer par tester l’authentification auprès des comptes NetWorker locaux pour voir si le problème n’affecte que la méthode d’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 côté navigateur
Si plusieurs navigateurs sont installés, testez le problème observé dans différents navigateurs pour voir si le problème est spécifique à un navigateur.

Dans le navigateur, cliquez avec le bouton droit de la souris et cliquez sur « Inspect » afin de voir les appels d’API REST qui sont effectués à partir du navigateur, ainsi que les instructions de journal et les informations de connexion réseau.
  • Cliquez avec le bouton droit de la souris n’importe où dans la fenêtre du navigateur et sélectionnez « inspecter »
  • Une nouvelle fenêtre s’ouvre avec plusieurs onglets.  Les onglets « Console » et « Réseau » sont susceptibles d’être les plus utiles.
  • Ces onglets permettent de voir les appels d’API REST exacts qui sont adressés au serveur NetWorker. 
  • Dans l’onglet Network, nous pouvons également voir la méthode de demande et la réponse de l’API REST du serveur NetWorker. De cette façon, nous pouvons suivre exactement ce qui est demandé au serveur NetWorker et exactement comment le serveur NetWorker répond à cette demande.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

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

Les journaux back-end importants de l’interface utilisateur sont les suivants :
    catalina.log - Journalisation du serveur Tomcat et journalisation du déploiement d’applications.
    nwui.log - Journalisation du serveur d’applications NWUI.
    restapi.log - Journalisation de l’API REST NetWorker.  NWUI communique avec le serveur NetWorker à l’aide de l’API REST NetWorker.
    daemon.raw - Journalisation du serveur NetWorker.

L’emplacement de ces fichiers log dépend du système d’exploitation utilisé, ainsi que du fait que l’installation de NWUI soit locale au NetWorker Server ou distante.  Si l’interface NWUI se trouve sur le NetWorker Server lui-même, elle partage la même instance tomcat avec NetWorker.
Si vous fournissez un fichier log .raw au support, il est conseillé de le restituer 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 s’exécutent avec la commande ps : 
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
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
Distant :
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Windows

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


                  kA5f10000004LFmCAM_1_5

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

                  kA5f10000004LFmCAM_1_6
 

Les journaux sont disponibles ici :

Local pour le serveur NetWorker :
  • C :Program FilesEMC NetWorker wuilogs
  • C :Program FilesEMC NetWorker srauthc-serverlogs
  • C :Program FilesEMC NetWorker sr estapi estapi.log
  • C :Program FilesEMC NetWorker srlogsdaemon.raw
Distant : 
  • C :Program FilesEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[HORODATA].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[HORODATA]_0_MCUI.log
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 fichier logback.xml sur le NetWorker Server :

Windows : C :Program FilesEMC NetWorker srauthc-server omcatwebapps wrestapiWEB-INFclasses
Linux : /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  kA5f10000004LFmCAM_1_7

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.

                  kA5f10000004LFmCAM_1_8

Additional Information

Ressources NWUI


521712 : NetWorker Management Web UI (NWUI) :  Mode d’emploi             
522859 : NetWorker Management Web UI (NWUI) :  Procédure d’installation          
522949 :   
522959:  NetWorker Management Web UI (NWUI) : Guide de tri et de dépannage

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 08 May 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.