Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products

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.

Instructions

Fonctionnement de la NWUI

L’interface utilisateur Web (NWUI) de NetWorker utilise les technologies suivantes : HTML5, Apache Tomcat, Spring Framework, Angular Framework et API (Representational State Transfer) 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 serveur NetWorker s’effectue à l’aide d’appels INTERNEs de l’API REST. Le processus NWUI utilise l’instance Apache Tomcat existante sur netWorker Server ou installe sa propre instance Apache Tomcat s’il est installé à distance à partir du serveur NetWorker.
  • Serveur NetWorker : Le framework REST de NetWorker Server est responsable de la réception des appels de l’API REST à partir du back-end de l’interface utilisateur et de leur connexion aux composants principaux de NetWorker Server. Le bus de messages RabbitMQ de NetWorker Server est également utilisé pour l’interaction 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 ; lors de la vérification, AuthC émet un token temporel, basé, signé et chiffré. Les composants NetWorker utilisent ce token pour vérifier l’utilisateur et autoriser ou non une opération demandée. Il s’agit généralement du serveur NetWorker, mais il peut être installé sur un hôte distinct. 
La plupart des communications utilisent l’API REST qui permet l’interaction avec les ressources identifiées par les adresses URI (Uniform Resource Identifier). Il utilise des verbes HTTP (HEAD, GET, PUT, POST, DELETE) pour interagir avec les identificateurs de ressources uniformes (URI) sans état. Ces appels API REST sont internes aux opérations NetWorker et NWUI. Il n’est pas nécessaire de les confondre avec l’interface de l’API REST NetWorker qui fournit un accès programmatique à NetWorker pour la programmation d’opérations personnalisées décrites dans le Guide de développement de l’API REST NetWorker.
 

Dépannage

Définition du problème

DÉTAILS
DU PROBLÈMEPour générer une description complète du problème, tenez compte des questions suivantes :
  • Quelle opération en cours de tentative ne fonctionne pas ?
  • Cette opération fonctionne-t-elle lorsqu’elle est lancée à partir d’une interface NWUI externe (par exemple : À partir de NetWorker Management Console (NMC) ?
  • Le problème est-il cohérent ou intermittent ?
  • En cas d’intermittence, existe-t-il un déclencheur connu ?
  • Cela a-t-il été plus efficace avant et, si c’est le cas, 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 en cas de charge importante sur l’environnement de sauvegarde ?
  • Quelle est la portée du problème (toutes les opérations de restauration/certaines opérations de restauration, certains onglets ne fonctionnent pas alors que d’autres ne sont pas affectés) ?
  • Qu’a-t-on essayé de résoudre jusqu’à présent et quelles conclusions en ont été tirées ?

DÉTAILS DE L’ENVIRONNEMENT
  • Quelle est la version du serveur NetWorker et la plate-forme du système d’exploitation ?
  • NWUI est-elle installée sur le serveur NetWorker ou sur un hôte distinct ?
    • Quelle est la version NWUI si elle est installée sur un hôte distinct du serveur NetWorker ?
  • Quel package Java est installé sur le serveur NWUI ? est NetWorker Runtime Environment (NRE) installé ou Oracle Java Runtime Environment (JRE).
Authentification
L’authentification utilise AuthC de la même manière que la console de gestion NetWorker 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 à l’interface utilisateur NWUI. Si vous utilisez une méthode d’authentification externe telle qu’AD ou LDAP, il est conseillé de tester d’abord l’authentification avec les comptes NetWorker locaux pour voir si le problème n’affecte que la méthode d’authentification externe.

Une commande classique utilisée pour tester si le processus d’authentification fonctionne comme prévu sur le serveur NetWorker est la suivante :  
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, son test et la réinitialisation d’un mot de passe si nécessaire.

Si un diagnostic d’authentification supplémentaire est requis, reportez-vous à :  NetWorker : Activation du débogage AUTHC à des fins de dépannage

Problèmes d’installation
Pour plus d’informations sur l’installation de la NWUI et les logs à consulter en cas de problème avec 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, utilisez le clic droit et « inspect » pour afficher les appels de l’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 « inspect » (inspecter).
  • Une nouvelle fenêtre s’ouvre avec plusieurs onglets.  Les onglets « Console » et « Réseau » sont probablement les plus utiles.
  • À l’aide de ces onglets, nous pouvons voir les appels d’API REST exacts qui sont effectués sur le serveur NetWorker. 
  • Dans l’onglet Réseau, vous pouvez également voir la méthode de demande et la réponse de l’API REST à partir du serveur NetWorker. De cette façon, nous pouvons suivre exactement ce qui est demandé du serveur NetWorker et la manière dont le serveur NetWorker répond à cette demande.
                   kA5f10000004LFmCAM_1_1
                   kA5f10000004LFmCAM_1_2
 
Problèmes de back-end de l’interface utilisateur

Les logs back-end importants de l’interface utilisateur sont les suivants :
    catalina.log : consignation du serveur Tomcat et consignation du déploiement d’applications.
    nwui.log : journalisation du serveur d’applications NWUI.
    restapi.log - Consignation 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 de l’installation de l’interface NWUI en local sur le serveur NetWorker ou à distance.  Si la NWUI se trouve sur le serveur NetWorker lui-même, elle partage la même instance tomcat avec NetWorker.
Si vous fournissez un fichier log .raw à prendre en charge, il est recommandé de restituer le fichier log sur le système d’où il provient. Cela garantit que les horodatages sont rendus à l’heure locale du serveur : NetWorker : Utilisation des nsr_render_log

Fichiers log

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 logs sont disponibles ici :

Local pour NetWorker Server :
  • /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 windows NWUI qui doit être en cours d’exécution est appelé nwuictld.exe :

                  kA5f10000004LFmCAM_1_5
Vous pouvez gérer cela à partir de services.msc :
                  kA5f10000004LFmCAM_1_6
 
Les logs sont disponibles ici :

Local pour NetWorker Server :
  • 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
Distant : 
  • C :\Program Files\EMC NetWorker\nwui\logs
  • %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[HORODATAGE].log
  • %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[HORODATAGE]_0_MCUI.log
Serveur NetWorker

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

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

Débogage

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

Windows : C :\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux : /nsr/authc/webapps/nwrestapi/WEB-INF/classes

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

Additional Information

Affected Products

NetWorker

Products

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