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): Handleiding voor triage en probleemoplossing

Summary: NetWorker Management Web UI (NWUI): Handleiding voor triage en probleemoplossing

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

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 of op een host worden geïnstalleerd 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.
  • Front-end web:  Dit is de presentatielaag die wordt geschreven in HTML5 en Angular Framework, die NetWorker-bewerkingen aan de gebruiker presenteert via een webbrowser. De webbrowser is verbonden met de back-endprocessen van de gebruikersinterface.
  • UI-backend:  De backend-applicatie wordt geschreven in Spring Framework.  Het maakt gebruik van Java en Apache Tomcat. Communicatie tussen front-end en backend en tussen de backend en de NetWorker server wordt uitgevoerd met behulp van interne REST API-oproepen. Het NWUI-proces gebruikt de bestaande Apache Tomcat-instantie op de NetWorker-server of installeert een eigen Apache Tomcat-instantie als deze extern vanaf de NetWorker-server is geïnstalleerd.
  • NetWorker Server: Het REST-framework van de NetWorker Server is verantwoordelijk voor het ontvangen van de REST API-oproepen van de UI-backend en het verbinden ervan met de kerncomponenten van de NetWorker Server. De NetWorker Server RabbitMQ-berichtbus wordt ook gebruikt voor interactie met nsrjobd.
  • AuthC: De authc-component van NetWorker wordt gebruikt voor alle authenticatiebehoeften. Het aanvraagproces neemt contact op met AuthC om de referenties te verifiëren; bij verificatie geeft AuthC een tijd, gebaseerd, ondertekend en versleuteld token uit. NetWorker-componenten gebruiken dit token om de gebruiker te verifiëren en een aangevraagde bewerking te autoriseren of niet. Dit is meestal op de NetWorker-server, maar kan op een afzonderlijke host worden geïnstalleerd. 
Het grootste deel van de communicatie maakt gebruik van REST API waarmee interactie kan worden uitgevoerd met bronnen die worden 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 mogen niet worden verward met de NetWorker REST API-interface die programmatische toegang biedt tot NetWorker voor het programmeren van aangepaste bewerkingen die worden beschreven in de NetWorker REST API Developer Guide.
 

Probleemoplossing

Het probleem definiëren

DETAILS VAN HET
PROBLEEMOm een volledige probleembeschrijving te genereren, kunt u de volgende vragen overwegen:
  • Welke bewerking wordt uitgevoerd die niet werkt?
  • Werkt deze bewerking wanneer deze wordt gestart vanaf een externe NWUI (bijvoorbeeld: Vanuit de NetWorker Management Console (NMC)?
  • Is het probleem consistent of onregelmatig?
  • Is er bij af en toe een bekende trigger?
  • Werkt dit beter voordat en zo ja, zijn er bekende wijzigingen toegepast vóór en na het verschijnen van het probleem?
  • Wanneer is het probleem voor het eerst opgetreden (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 het bereik van het probleem (alle herstelbewerkingen/sommige herstelbewerkingen, sommige tabbladen werken niet terwijl andere niet worden beïnvloed)?
  • Wat is er tot nu toe geprobeerd om het probleem op te lossen en welke conclusies zijn hieruit getrokken?

OMGEVINGSDETAILS
  • Wat is de NetWorker serverversie en het besturingssysteemplatform?
  • Is NWUI geïnstalleerd op de NetWorker-server of een afzonderlijke host?
    • Wat is de NWUI-versie als deze is geïnstalleerd op een host die los staat van de NetWorker-server?
  • Welk Java-pakket is geïnstalleerd op de NWUI-server; is NetWorker Runtime Environment (NRE) geïnstalleerd of Oracle Java Runtime Environment (JRE).
Verificatie
Authenticatie gebruikt AuthC op dezelfde manier als de NetWorker Management Console en de opdracht nsrlogin . Voor verificatieproblemen test u eerst de authenticatie op de NetWorker-server zelf om te bepalen of het authenticatieprobleem betrekking heeft op de NWUI of niet. Als u een externe verificatiemethode gebruikt, zoals AD of LDAP, wordt aangeraden om eerst authenticatie te testen met lokale NetWorker-accounts om te zien of het probleem alleen van invloed is op de externe verificatiemethode.

Een veelgebruikte opdracht die wordt gebruikt om te testen of het verificatieproces werkt zoals verwacht op de NetWorker Server:  
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 indien nodig opnieuw kunt instellen.

Als verdere verificatiediagnose vereist is, raadpleegt u:  NetWorker: AUTHC DEBUG inschakelen voor probleemoplossing

Installatieproblemen
Zie het volgende artikel: NetWorker Management Web UI (NWUI) voor meer informatie over het installeren van de NWUI en welke logboeken u moet raadplegen als er een probleem is met de installatie:
NetWorker Management Web UI (NWUI): Installeren
 
Problemen met de browser
Als meerdere browsers zijn geïnstalleerd, test u het waargenomen probleem in verschillende browsers om te zien of het probleem specifiek is voor één browser.

Gebruik in de browser de rechtermuisknop en 'inspect' om de REST API-oproepen te zien die vanuit de browser worden gemaakt, evenals logboekverklaringen en informatie over de netwerkverbinding.
  • Klik met de rechtermuisknop ergens in het browservenster en selecteer 'inspect'
  • Er wordt een nieuw venster geopend met verschillende tabbladen.  De tabbladen 'Console' en 'Network' zijn waarschijnlijk het handigst.
  • Met behulp van deze tabbladen kunnen we de exacte REST API-oproepen zien die worden uitgevoerd naar de NetWorker-server. 
  • Op het tabblad Netwerk kunnen we ook de aanvraagmethode en de REST API-respons van de NetWorker-server zien. Op deze manier kunnen we precies traceren wat er wordt gevraagd van de NetWorker-server en precies hoe de NetWorker-server op deze aanvraag reageert.
                   kA5f10000004LFmCAM_1_1
                   kA5f10000004LFmCAM_1_2
 
Problemen met de ui-backend

De belangrijke back-endlogboeken van de gebruikersinterface zijn:
    catalina.log - Tomcat server logging en application deployment logging.
    nwui.log - Logboekregistratie van NWUI-applicatieservers.
    restapi.log - NetWorker REST API-logboekregistratie.  NWUI communiceert met de NetWorker-server met behulp van de NetWorker REST API.
    daemon.raw - Logboekregistratie van NetWorker-server.

De locatie van deze logbestanden is afhankelijk van het besturingssysteem dat wordt gebruikt en of de installatie van de NWUI lokaal is voor de NetWorker-server of op afstand.  Als de NWUI zich op de NetWorker-server zelf bevindt, deelt deze dezelfde tomcat-instantie met NetWorker.
Als u een .raw logboekbestand ter ondersteuning aanbiedt, wordt aangeraden om het logboekbestand te renderen op het systeem waarvan het afkomstig is. Dit zorgt ervoor dat de tijdstempels worden weergegeven in de lokale tijd van de server: NetWorker: Het gebruik van nsr_render_log

Logboekbestanden

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 de ps-opdracht:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
De logboeken zijn hier:

Lokaal voor NetWorker server:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
Externe:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Windows

Het back-endproces van Windows NWUI dat moet worden uitgevoerd, wordt nwuictld.exe genoemd:

                  kA5f10000004LFmCAM_1_5
U kunt dit beheren via services.msc:
                  kA5f10000004LFmCAM_1_6
 
De logboeken zijn hier:

Lokaal voor 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
Externe: 
  • C:\Program Files\EMC NetWorker\nwui\logs
  • %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP]_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: Logboekbestanden en -locaties

Fouten opsporen

Om de REST API-communicatie op te sporen, wijzigt u het foutopsporingsniveau in het logback.xml-bestand op de NetWorker-server:

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
Ontkoppel de regels die te maken hebben met API-aanroepregistratie. Hierdoor wordt het logboekniveau ingesteld op 'trace' voor de REST API-aanvragen en -antwoorden.
                   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.