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.


                  kA5f10000004LFmCAM_1_0


Er zijn vier belangrijke componenten:
Deze onderdelen kunnen zich op dezelfde host of op afzonderlijke hosts bevinden.
  • Web front-end:  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 front-end 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. Ze moeten niet worden verward met de NetWorker REST API-interface die programmatische toegang tot NetWorker biedt voor het programmeren van op maat gemaakte bewerkingen, die wordt beschreven in de NetWorker REST API-ontwikkelaarshandleiding.
 

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/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 opdracht nsrlogin . Voor authenticatieproblemen test u eerst de authenticatie op de NetWorker-server zelf om te bepalen of het authenticatieprobleem al dan niet te maken heeft met de NWUI. Als u een externe verificatiemethode gebruikt, zoals AD of LDAP, is het raadzaam om eerst de verificatie te testen met lokale NetWorker-accounts om te zien of het probleem alleen van invloed is op de externe verificatiemethode.

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
 
Problemen aan de browserzijde
Als er meerdere browsers zijn geïnstalleerd, test dan het waargenomen probleem in verschillende browsers om te zien of het probleem specifiek is voor één browser.

Klik in de browser met de rechtermuisknop en 'inspect' om de REST API-aanroepen te zien die vanuit de browser worden gedaan, evenals logboekinstructies en netwerkverbindingsinformatie.
  • Klik met de rechtermuisknop ergens in het browservenster en selecteer 'inspecteren'
  • Er wordt een nieuw venster geopend met verschillende tabbladen.  De tabbladen 'Console' en 'Netwerk' zijn waarschijnlijk het handigst.
  • Op deze tabbladen zien we de exacte REST API-aanroepen die naar de NetWorker-server worden gedaan. 
  • Op het tabblad Netwerk zien we ook de aanvraagmethode en het REST API-antwoord van de NetWorker-server. Op deze manier kunnen we precies traceren wat er van de NetWorker-server wordt gevraagd en hoe de NetWorker-server precies op dit verzoek reageert.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Backendproblemen met de gebruikersinterface

De belangrijke UI backend logs zijn:
    catalina.log - Tomcat-serverlogging en logboekregistratie van applicatie-implementatie.
    nwui.log - NWUI-logboekregistratie van applicatieserver.
    restapi.log - NetWorker REST API-logboekregistratie.  NWUI communiceert met de NetWorker-server met behulp van de NetWorker REST API.
    daemon.raw - NetWorker-serverlogboekregistratie.

De locatie van deze logbestanden is afhankelijk van het besturingssysteem dat wordt gebruikt en of de installatie van de NWUI lokaal bij de NetWorker-server of op afstand plaatsvindt.  Als de NWUI zich op de NetWorker-server zelf bevindt, deelt deze dezelfde tomcat-instantie met NetWorker.
Als u een .raw logbestand ter ondersteuning aanbiedt, is het raadzaam 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 en jsvc.exec U kunt controleren of ze worden uitgevoerd met het ps-commando: 
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
De logboeken zijn hier:

Lokaal naar NetWorker server:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
Afgelegen:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Ramen

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


                  kA5f10000004LFmCAM_1_5

U kunt dit beheren via services.msc:

                  kA5f10000004LFmCAM_1_6
 

De logboeken zijn hier:

Lokaal naar NetWorker server:
  • 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
Afgelegen: 
  • C:Program FilesEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIJDSTEMPEL]_0_MCUI.log
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 het bestand logback.xml op de NetWorker-server:Windows:

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


                  kA5f10000004LFmCAM_1_7

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.

                  kA5f10000004LFmCAM_1_8

Additional Information

NWUI-bronnen


521712 : NetWorker Management Web UI (NWUI):  Het gebruik             
522859 : NetWorker Management Web UI (NWUI):  Hoe te installeren          
522949 :   
522959:  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: 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.