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