Sådan fungerer NWUI
NetWorker Web User Interface (NWUI) anvender følgende teknologier: HTML5, Apache Tomcat, Spring Framework, Angular Framework og REST (Representational State Transfer) API (Application Programming Interface). NWUI-programmet kan installeres på Linux- eller Windows-operativsystemer. Det kan installeres enten direkte på NetWorker-serveren eller på en vært, som ikke er NetWorker-serveren.
Der er fire vigtige komponenter:
Disse komponenter kan være på samme vært eller på separate værter.
- Front-end på internettet: Dette er det præsentationslag, der er skrevet i HTML5 og Angular Framework, og som præsenterer NetWorker-handlinger for brugeren via en webbrowser. Webbrowseren har forbindelse til backend-processerne i brugergrænsefladen.
- UI-backend: Backend-applikationen er skrevet i Spring Framework. Den bruger Java og Apache Tomcat. Kommunikation mellem front-end og backend og mellem backend og NetWorker-serveren foregår ved hjælp af interne REST API-opkald. NWUI-processen bruger enten den eksisterende Apache Tomcat-forekomst på NetWorker-serveren eller installerer sin egen Apache Tomcat-forekomst, hvis den installeres eksternt fra NetWorker-serveren.
- NetWorker-server: NetWorker Server REST Framework er ansvarlig for at modtage REST API-opkald fra UI-backend og tilslutte dem til NetWorker-serverens kernekomponenter. NetWorker Server WarnMQ-meddelelsesbussen bruges også til interaktion med nsrjobd.
- Godkendelse: Authc-komponenten i NetWorker bruges til alle godkendelsesbehov. Den anmodende proces kontakter AuthC for at bekræfte legitimationsoplysninger. efter bekræftelse udsteder AuthC et tids-, baseret, signeret og krypteret token. NetWorker-komponenter bruger dette token til at verificere brugeren og godkende eller ikke en anmodet handling. Dette er normalt på NetWorker-serveren, men kan installeres på en separat vært.
Det meste af kommunikationen bruger REST API
, som tillader interaktion med ressourcer identificeret af URI-adresser (Uniform Resource Identifier). Den bruger HTTP-verber (HEAD, GET, PUT, POST, DELETE) til at interagere med URI (Uniform Resource Identifiers) på en tilstandsløs måde. Disse REST API-opkald er interne i NetWorker- og NWUI-handlinger. De må ikke forveksles med NetWorker REST API-grænsefladen, der giver programmatisk adgang til NetWorker til programmering af brugerdefinerede handlinger, som er beskrevet i NetWorker REST API Developer Guide.
Fejlfinding
Definition af problemet
OPLYSNINGER OM
PROBLEMETFor at generere en komplet problembeskrivelse skal du overveje følgende spørgsmål:
- Hvilken handling forsøges, som ikke virker?
- Fungerer denne handling, når den påbegyndes fra en ekstern NWUI (f.eks.: Fra NetWorker Management Console (NMC)?
- Er problemet konsistent eller sporadisk?
- Er der en kendt udløser, hvis det er forbigående?
- Fungerede dette bedre før, og hvis det er tilfældet, anvendes der så nogen kendte ændringer før og efter, at problemet opstod?
- Hvornår opstod problemet først (og hvad ændredes, siden problemet opstod)?
- Opstår problemet kun i tilfælde af kraftig belastning af sikkerhedskopieringsmiljøet?
- Hvad er omfanget af problemet (alle gendannelseshandlinger/visse gendannelseshandlinger, nogle faner fungerer ikke, mens andre ikke er berørt)?
- Hvad har man indtil videre forsøgt at løse, og hvilke konklusioner er der draget af dette?
DETALJER OM MILJØ
- Hvad er NetWorker-serverversionen og operativsystemets platform?
- Er NWUI installeret på NetWorker-serveren eller en separat vært?
- Hvad er NWUI-versionen, hvis den installeres på en vært, der er adskilt fra NetWorker-serveren?
- Hvilken Java-pakke er installeret på NWUI-serveren. er NetWorker Runtime Environment (NRE) installeret eller Oracle Java Runtime Environment (JRE).
Autentificering
Godkendelse bruger AuthC på samme måde som NetWorker Management Console og
nsrlogin-kommandoen . For godkendelsesproblemer skal du starte med at teste godkendelsen på NetWorker-serveren for at se nærmere på, om godkendelsesproblemet er relateret til NWUI eller ej. Hvis du bruger en ekstern godkendelsesmetode som f.eks. AD eller LDAP, anbefales det først at teste godkendelse med lokale NetWorker-konti for at se, om problemet kun påvirker den eksterne godkendelsesmetode.
En typisk kommando, der bruges til at teste, om godkendelsesprocessen fungerer som forventet på NetWorker-serveren, er:
authc_mgmt -u [user name] -p [password] -e find-all-users.
Eller:
Lokal NetWorker-konto:
nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Ekstern (AD/LDAP)-konto:
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
Installationsproblemer
Problemer på browsersiden
Hvis der er installeret flere browsere, skal du teste det observerede problem i forskellige browsere for at se, om problemet er specifikt for én browser.
I browseren skal du bruge højreklik og "inspicere" for at se DE REST API-opkald, der foretages fra browseren, samt log-meddelelser og oplysninger om netværksforbindelse.
- Højreklik et vilkårligt sted i browservinduet, og vælg "Undersøg"
- Der åbnes et nyt vindue med flere faner. Fanerne "Konsol" og "Netværk" er sandsynligvis de mest nyttige.
- Ved hjælp af disse faner kan vi se de nøjagtige REST API-opkald, der foretages til NetWorker-serveren.
- På fanen Netværk kan vi også se anmodningsmetoden og REST API-svaret fra NetWorker-serveren. På denne måde kan vi præcist spore, hvad der anmodes om af NetWorker-serveren, og nøjagtigt hvordan NetWorker-serveren svarer på denne anmodning.
Problemer med ui-backend
De vigtige ui-backend-logfiler er:
catalina.log – Tomcat-serverlogføring og logføring af programimplementering.
nwui.log - NWUI-logføring af programserver.
restapi.log - NetWorker REST API-logføring. NWUI kommunikerer med NetWorker-serveren ved hjælp af NetWorker REST API.
daemon.raw - NetWorker-serverlogføring.
Placeringen af disse logfiler afhænger af det anvendte operativsystem, samt om installationen af NWUI er lokal for NetWorker-serveren eller ekstern. Hvis NWUI er på Selve NetWorker-serveren, deler den samme tomcat-forekomst med NetWorker.
Hvis du leverer en .raw logfil til understøttelse, anbefales det at gengive logfilen på det system, den stammer fra. Dette sikrer, at tidsstemplerne gengives lokalt på serveren:
NetWorker: Sådan bruges nsr_render_log
Logfiler
Linux:
De processer, der kører for UI-backend, er: /opt/nwui/bin/nwuictld og jsvc.exec Du kan kontrollere, om de kører med ps-kommandoen:
Logfilerne er her:
Lokal til NetWorker-server:
- /opt/nwui/logs
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
Fjernbetjening:
- /opt/nwui/logs
- /nsr/nwui/logs
Windows
Windows NWUI backend-processen, som skal køre, kaldes nwuictld.exe:
Du kan administrere dette fra services.msc:
Logfilerne er her:
Lokal til 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
Fjernbetjening:
- 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
Kør nsrget-værktøjet på NetWorker-serveren for at indsamle de relevante logfiler:
Networker: Sådan bruges NSRGet NetWorker-dataindsamlingsværktøjet
De mest relevante logfiler afhænger af den handling, der forsøges fra NWUI. Du kan få flere oplysninger om NetWorker-logfiler under:
Networker: Logfiler og placeringer
Fejlfinding
For at foretage fejlfinding af REST API-kommunikationen skal du ændre fejlfindingsniveauet i logback.xml-filen på NetWorker-serveren:
Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes
Frigør de linjer, der håndterer logføring af API-opkald. Dette medfører, at logføringsniveauet indstilles til "trace" for REST API-anmodninger og -svar.