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

Fonctionnement de NWUI

• Front-end Web :  il s’agit de la couche de présentation écrite en HTML5 et en 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.  Elle 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 d’API REST internes. Le processus NWUI utilise l’instance Apache Tomcat existante sur le serveur NetWorker ou installe sa propre instance Apache Tomcat si elle est installée à distance à partir du serveur NetWorker.
• Serveur NetWorker : le framework REST du serveur NetWorker est chargé de recevoir les appels d’API REST du back-end de l’interface utilisateur et de les connecter aux composants principaux du serveur NetWorker. Le message bus RabbitMQ du serveur NetWorker 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 jeton temporel, signé et chiffré. Les composants NetWorker utilisent ce jeton pour authentifier l’utilisateur et autoriser ou non une opération demandée. Cela se fait généralement sur le serveur NetWorker, mais peut être installé sur un hôte séparé. 

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #F5F5F5; } À ne pas confondre avec l’API REST NetWorker, qui permet des opérations personnalisées et est décrite dans le Guide du développeur de l’API REST de NetWorker.

Dépannage

Définition du problème

• Quelle opération est en cours d’exécution et ne fonctionne pas ?
• Cette opération fonctionne-t-elle lorsqu’elle est lancée en dehors de NWUI (par exemple : à partir de NetWorker Management Console [NMC]) ?
• Le problème est-il constant ou intermittent ?
• S’il est intermittent, y a-t-il un déclencheur connu ?
• Cette opération fonctionnait-elle mieux auparavant et, le cas échéant, quelles modifications connues ont été apporté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 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) ?
• Quelles actions ont déjà été tentées pour corriger le problème et quelles conclusions en ont été tirées ?

• Quelle est la version et la plateforme du système d’exploitation du serveur NetWorker ?

• NetWorker Web User Interface (NWUI) est-elle installée sur le serveur NetWorker ou sur un hôte distinct ?
  • Quelle est la version de NWUI si elle est installée sur un hôte distinct du serveur NetWorker ?
• Quel package Java est installé sur le serveur NWUI ; NetWorker Runtime Environment (NRE) ou Oracle Java Runtime Environment (JRE) ?

authc_mgmt -u [user name] -p [password] -e find-all-users.

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout

nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout

ps -ef | grep nwui

                   

• /opt/nwui/logs
• /nsr/authc/logs/
• /nsr/logs/restapi/restapi.log
• /nsr/logs/daemon.raw
• /nsr/nwui/monitoring/app/logs/

• /opt/nwui/logs
• /nsr/nwui/logs   

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

• 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\

• 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

Exécutez l’outil nsrget sur le serveur NetWorker pour collecter les journaux appropriés :
NetWorker : comment utiliser l’outil de collecte de données NSRGet de NetWorker (en anglais)

Les journaux les plus pertinents dépendent de l’opération tentée à partir de NWUI. Pour plus d’informations sur les logs NetWorker, voir :
NetWorker : Fichiers journaux et emplacements

Débogage

Voir : NetWorker : comment activer le débogage de l’API REST

API REST

NWUI utilise l’API REST pour communiquer avec NetWorker. Les journaux de NWUI et de l’API REST affichent les fonctions de l’API et les réponses de NetWorker, mais ces informations peuvent également être vérifiées directement dans le navigateur. Cette méthode est utile pour trouver 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. Lors de l’accès à NWUI, cliquez avec le bouton droit de la souris dans la fenêtre du navigateur et sélectionnez Inspect.

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

3. Lors de l’exécution de fonctions dans NWUI, les opérations s’affichent sous Name. La colonne Status indique l’état d’exécution de l’API REST : Demande et réponse de l’API 
4. 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 informations suivantes s’affichent dans l’onglet Headers :

L’URL de la demande, la méthode de la demande et le code d’état sont tous identifiables.

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

Cet exemple montre la réponse de l’API REST utilisée pour renseigner l’onglet Recover and Savesets après avoir parcouru les sauvegardes Azure et sélectionné un jeu de sauvegarde à restaurer.

Ressources NWUI

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