NetWorker Management Web UI (NWUI): Triage en probleemoplossingsgids

Summary: NetWorker Management Web UI (NWUI): Triage en probleemoplossingsgids

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

Hoe de NWUI werkt

De NetWorker Web User Interface (NWUI) maakt gebruik van de volgende technologieën: HTML5, Apache Tomcat, Spring Framework, Angular Framework en Representational State Transfer (REST) Application Programming Interface (API). De NWUI-applicatie kan worden geïnstalleerd op Linux- of Windows-besturingssystemen. Het kan rechtstreeks op de NetWorker-server worden geïnstalleerd of op een host die niet de NetWorker-server is.


                  Componenten van NWUI 


Er zijn vier belangrijke componenten:
Deze onderdelen kunnen zich op dezelfde host of op afzonderlijke hosts bevinden.
  • Webfrontend:  Dit is de presentatielaag die is geschreven in HTML5 en Angular Framework en die NetWorker-bewerkingen via een webbrowser aan de gebruiker presenteert. De webbrowser is verbonden met de UI-backendprocessen.
  • UI-backend:  De backend applicatie is geschreven in Spring Framework.  Het maakt gebruik van Java en Apache Tomcat. Communicatie tussen de frontend en backend en tussen de backend en de NetWorker-server wordt uitgevoerd met behulp van interne REST API-aanroepen. Het NWUI-proces maakt gebruik van de bestaande Apache Tomcat-instantie op de NetWorker-server of installeert een eigen Apache Tomcat-instantie als deze op afstand vanaf de NetWorker-server is geïnstalleerd.
  • NetWorker Server: Het REST-framework van NetWorker Server is verantwoordelijk voor het ontvangen van de REST API-aanroepen van de UI-back-end en het verbinden ervan met de kerncomponenten van de NetWorker Server. De NetWorker Server RabbitMQ-berichtenbus wordt ook gebruikt voor interactie met nsrjobd.
  • AUTHC: De AUTHC-component van NetWorker wordt gebruikt voor alle verificatiebehoeften. Het aanvraagproces neemt contact op met AuthC om referenties te verifiëren; na verificatie geeft AuthC een tijd-, gebaseerd, ondertekend en versleuteld token uit. NetWorker-onderdelen gebruiken dit token om de gebruiker te verifiëren en een aangevraagde bewerking al dan niet te autoriseren. Dit is meestal op de NetWorker-server, maar kan ook op een afzonderlijke host worden geïnstalleerd. 
De meeste communicatie vindt plaats via REST API, waardoor interactie mogelijk is met resources die zijn geïdentificeerd door URI-adressen (Uniform Resource Identifier). Het gebruikt HTTP-werkwoorden (HEAD, GET, PUT, POST, DELETE) om op een staatloze manier te communiceren met de Uniform Resource Identifiers (URI). Deze REST API-aanroepen zijn intern voor NetWorker- en NWUI-bewerkingen.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solide #e6e6e6; } tr th { background-color: #f5f5f5; } Verwar deze niet met de NetWorker REST API, die aangepaste bewerkingen mogelijk maakt en wordt gedocumenteerd in de NetWorker REST API Developer Guide.

Probleemoplossing

Het probleem definiëren

DETAILS
VAN HET PROBLEEMOm een volledige probleembeschrijving te genereren, moet u de volgende vragen stellen:
  • Welke operatie wordt geprobeerd die niet werkt?
  • Werkt deze bewerking wanneer deze wordt gestart van buiten NWUI (bijvoorbeeld: Komt u via de NetWorker Management Console (NMC)?
  • Is het probleem consistent of periodiek?
  • Is er, indien intermitterend, een bekende trigger?
  • Werkte dit eerder beter en zo ja, zijn er voor zover bekend wijzigingen toegepast voor en nadat het probleem zich voordeed?
  • Wanneer deed het probleem zich voor het eerst voor (en wat is er veranderd sinds het probleem zich voordeed)?
  • Doet het probleem zich alleen voor bij zware belasting van de back-upomgeving?
  • Wat is de omvang van het probleem (alle herstelbewerkingen of sommige herstelbewerkingen, sommige tabbladen werken niet en andere worden niet beïnvloed)?
  • Wat is er tot nu toe geprobeerd op te lossen en welke conclusies zijn daaruit getrokken?

OMGEVINGSDETAILS
  • Wat is de NetWorker-serverversie en het besturingssysteemplatform?
  • Wordt NWUI geïnstalleerd op de NetWorker-server of op een afzonderlijke host?
    • Wat is de NWUI-versie als deze is geïnstalleerd op een host los van de NetWorker-server?
  • Welk Java-pakket is geïnstalleerd op de NWUI-server; NetWorker Runtime Environment (NRE) of Oracle Java Runtime Environment (JRE) is geïnstalleerd.
Verificatie
Authenticatie gebruikt AUTHC op dezelfde manier als de NetWorker Management Console en de nsrlogin Opdracht. Voor authenticatieproblemen test u eerst de verificatie op de NetWorker-server om te bepalen of het probleem te maken heeft met NWUI of de server zelf. Als u AD of LDAP gebruikt voor authenticatie, test dan eerst met lokale NetWorker-accounts om te bevestigen of het probleem alleen van invloed is op externe authenticatie.

Een typische opdracht die wordt gebruikt om te testen of het verificatieproces werkt zoals verwacht op de NetWorker-server is:   
authc_mgmt -u [user name] -p [password] -e find-all-users.

Of:

Lokaal NetWorker-account:

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Extern (AD/LDAP) account: 
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
De NetWorker Security Configuration Guide bevat volledige informatie over hoe NetWorker-authenticatie werkt, hoe u deze kunt testen en hoe u een wachtwoord opnieuw kunt instellen indien nodig.

Als verdere authenticatiediagnose vereist is, raadpleegt u:  NetWorker: AUTHC-foutopsporing inschakelen voor probleemoplossingsdoeleinden

Installation Issues
Voor meer informatie over het installeren van de NWUI en welke logboeken u moet raadplegen als er een probleem is met de installatie, raadpleegt u het volgende artikel:
NetWorker Management Web UI (NWUI): Hoe te installeren                   

 

Backendproblemen met de gebruikersinterface

De belangrijke UI backend logs zijn:
Linux-pad Windows-pad (standaard) Functie
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Tomcat-serverlogging en logboekregistratie van applicatie-implementatie.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Logboekregistratie van NWUI-toepassingsserver.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log NetWorker REST API-logging. NWUI communiceert met de NetWorker-server met behulp van de NetWorker REST API. Zie de REST API-sectie in dit artikel om te zien hoe u kunt vaststellen welke REST API-functies worden gebruikt, samen met het bijbehorende antwoord.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw NetWorker-serverlogboekregistratie.

Als de NWUI-server zich op de NetWorker-server zelf bevindt, deelt deze dezelfde tomcat-instantie met NetWorker.
Als u een .raw logbestand om support te bieden, is het aan te raden om het logbestand weer te geven op het systeem waarvan het afkomstig is. Dit zorgt ervoor dat de tijdstempels worden weergegeven in de lokale tijd van de server: NetWorker: Hoe nsr_render_log

te gebruikenLogboekbestanden

Linux:

De processen die worden uitgevoerd voor de UI-backend zijn:  /opt/nwui/bin/nwuictld als jsvc.exec U kunt controleren of ze actief zijn met de ps Opdracht: 
ps -ef | grep nwui
                  ps-uitgang met NWUI-backend 
De logboeken zijn hier:

Lokaal naar NetWorker server:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
Extern (NWUI-server bevindt zich op een host los van de NetWorker-server):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
De volgende opdracht kan worden gebruikt om een zip van deze logbestanden te maken 
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
OPMERKING: Afhankelijk van of NWUI lokaal of extern naar de NetWorker-server is, kan de bovenstaande opdracht sommige mappen als ontbrekend melden. Dit wordt verwacht. De hostnaam en datum hoeven niet te worden gewijzigd, de bovenstaande opdracht maakt automatisch de bundel met de hostnaam en de huidige datum van de server (YYYY-MM-DD).
Windows

Het Windows NWUI-backendproces dat moet worden uitgevoerd, heet nwuictld.exe:


                  Takenlijst met NWUI-service 

U kunt dit beheren vanuit services.msc:

                  servicesconsole met NWUI 
 

De logboeken zijn hier:

Lokaal naar 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
  • C:\Program Files\EMC NetWorker\nwui\monitoring\app\logs\
Externe: 
  • 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
OPMERKING: De weergegeven paden zijn het standaard installatiepad van NetWorker. Als NetWorker op een andere schijf of via een ander pad is geïnstalleerd, pas het dan dienovereenkomstig aan.
 
NetWorker Server

Voer de nsrget-tool uit op de NetWorker-server om de relevante logboeken te verzamelen:
Networker: De NSRGet NetWorker Data Collection Tool

gebruikenDe meest relevante logboeken zijn afhankelijk van de bewerking die wordt geprobeerd vanuit de NWUI. Zie voor meer informatie over NetWorker-logboeken:
Networker: Logbestanden en locaties

Fouten opsporen

Als u fouten wilt opsporen in de REST API-communicatie, wijzigt u het foutopsporingsniveau in de logback.xml bestand op de NetWorker-server:

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


                  Logback-bestand 

Maak opmerkingen ongedaan voor de regels die te maken hebben met het loggen van API-oproepen. Dit zorgt ervoor dat het logboekregistratieniveau wordt ingesteld op 'trace' voor de REST API-aanvragen en -antwoorden.

                  Foutopsporingsinstellingen 

Zie: NetWorker: Hoe REST API-foutopsporing in te schakelen

 

REST API

NWUI gebruikt REST API om te communiceren met NetWorker. NWUI- en REST API-logboeken tonen API-functies en NetWorker-reacties, maar deze informatie kan ook rechtstreeks in de browser worden gecontroleerd. Deze methode is handig voor het vinden van verschillen tussen UI's en NetWorker CLI of wanneer de UI geen verwachte resultaten retourneert. 

 

  1. Klik tijdens het openen van NWUI met de rechtermuisknop in het browservenster en selecteer Inspecteren.

Inspecteren

  1. Klik in het venster "Inspect" van de browser op het tabblad Netwerk :

Browser inspecteren netwerk

  1. Bij het uitvoeren van functies in NWUI worden bewerkingen weergegeven onder Naam. De kolom Status bevat de voltooiingsstatus van de REST API: API-aanvraag en -antwoord 
  2. Klik op de bewerking die u verder wilt onderzoeken. Als u bijvoorbeeld op de hierboven weergegeven back-upfunctie klikt, worden de volgende gegevens weergegeven op het tabblad Kopteksten :

Hieruit kunt u de aanvraag-URL, aanvraagmethode en statuscode afleiden.

  1. Klik op het tabblad Reacties om de payload van het antwoord te bekijken.

 

In dit voorbeeld ziet u het REST API-antwoord dat wordt gebruikt om het tabblad Herstellen en opslaan in te vullen na het bladeren door Azure-back-ups en het selecteren van een opslagset voor herstel.

Additional Information

NWUI-bronnen

NetWorker Management Web UI (NWUI):  Het gebruik             
NetWorker Management Web UI (NWUI):  Hoe te installeren          
NetWorker Management Web UI (NWUI): Triage en probleemoplossingsgids

Affected Products

NetWorker

Products

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