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.
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
Problèmes 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.
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 :
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 :
Vous pouvez gérer cela à partir de services.msc :
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 NetWorkerLes 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
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](https://supportkb.dell.com/img/ka06P000000kKqZQAU/ka06P000000kKqZQAU_fr_8.jpeg)