Så här fungerar NWUI
NetWorker-webbanvändargränssnittet (NWUI) använder följande teknik: HTML5, Apache Tomcat, Spring Framework, Angular Framework och REST (Representational State Transfer) Application Programming Interface (API). NWUI-programmet kan installeras på Linux- eller Windows-operativsystem. Den kan installeras antingen direkt på NetWorker-servern eller på en värd som inte är NetWorker-servern.
Det finns fyra viktiga komponenter:
Dessa komponenter kan finnas på samma värd eller på separata värdar.
- Webbfrontend: Det här är presentationsskiktet i HTML5 och Angular Framework som presenterar NetWorker-åtgärder för användaren via en webbläsare. Webbläsaren är ansluten till backend-processerna i användargränssnittet.
- Användargränssnittetsserverdel: Backend-programmet är skrivet i Spring Framework. Java och Apache Tomcat används. Kommunikationen mellan klientdelen och serverdelen samt mellan serverdelen och NetWorker-servern sker med hjälp av interna REST API-anrop. NWUI-processen använder antingen den befintliga Apache Tomcat-instansen på NetWorker-servern eller installerar sin egen Apache Tomcat-instans om den installeras på distans från NetWorker-servern.
- NetWorker-server: NetWorker Server REST Framework ansvarar för att ta emot REST API-anrop från användargränssnittets serverdel och ansluta dem till NetWorker-serverns kärnkomponenter. NetWorker Server RabbitMQ-meddelandebussen används också för interaktion med nsrjobd.
- Auktorisering: Authc-komponenten i NetWorker används för alla autentiseringsbehov. Den begärande processen kontaktar AuthC för att verifiera inloggningsuppgifter; vid verifiering utfärdar AuthC en tid, baserad, signerad och krypterad token. NetWorker-komponenter använder denna token för att verifiera användaren och godkänna eller inte begärda åtgärder. Detta finns vanligtvis på NetWorker-servern, men kan installeras på en separat värd.
I de flesta meddelanden används REST API
som gör det möjligt att interagera med resurser som identifieras av URI-adresser (Uniform Resource Identifier). Den använder HTTP-verb (HEAD, GET, PUT, POST, DELETE) för att interagera med URI (Uniform Resource Identifiers) på ett tillståndslöst sätt. REST API-anropen är interna för NetWorker- och NWUI-åtgärder. De ska inte förväxlas med NetWorker REST API-gränssnittet som ger programmatisk åtkomst till NetWorker för programmering av specialbyggda åtgärder som beskrivs i Utvecklarmanualen för NetWorker REST API.
Felsökning
Definiera problemet
INFORMATION OM PROBLEMET
Du kan skapa en fullständig problembeskrivning genom att titta på följande frågor:
- Vilken åtgärd görs, vilket fungerar inte?
- Fungerar den här åtgärden när den initieras utanför NWUI (till exempel: Från NetWorker Management Console (NMC)?
- Är problemet konsekvent eller tillfälligt?
- Finns det en känd utlösare om det är intermittent?
- Fungerade detta bättre tidigare, och i så fall tillämpades några kända ändringar före och efter att problemet visades?
- När uppstod problemet först (och vad ändrades sedan problemet uppstod)?
- Inträffar problemet endast vid hög belastning i säkerhetskopieringsmiljön?
- Vad är problemets omfattning (alla återställningsåtgärder/vissa återställningsåtgärder, vissa flikar fungerar inte medan andra inte påverkas)?
- Vad har vi försökt att åtgärda hittills och vilka slutsatser har dragits av detta?
MILJÖDETALJER
- Vad är NetWorker-serverversionen och operativsystemsplattformen?
- Är NWUI installerat på NetWorker-servern eller en separat värd?
- Vilken är NWUI-versionen om den är installerad på en värd separat från NetWorker-servern?
- Vilket Java-paket är installerat på NWUI-servern? är NetWorker Runtime Environment (NRE) installerat eller Oracle Java Runtime Environment (JRE).
Autentisering
Autentisering använder AuthC på samma sätt som NetWorker Management Console och
kommandot nsrlogin . För autentiseringsproblem börjar du med att testa autentiseringen på själva NetWorker-servern för att separera om autentiseringsproblemet är relaterat till NWUI eller inte. Om du använder en extern autentiseringsmetod som AD eller LDAP rekommenderar vi att du först testar autentiseringen med lokala NetWorker-konton för att se om problemet bara påverkar den externa autentiseringsmetoden.
Ett typiskt kommando som används för att testa om autentiseringsprocessen fungerar som förväntat på NetWorker-servern är:
authc_mgmt -u [user name] -p [password] -e find-all-users.
Eller:
Lokalt NetWorker-konto:
nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Externt konto (AD/LDAP):
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
Installationsproblem
Problem på webbläsarsidan
Om flera webbläsare är installerade testar du det observerade problemet i olika webbläsare för att se om problemet är specifikt för en webbläsare.
I webbläsaren använder du högerklicka och "inspektera" för att se REST API-anropen som görs från webbläsaren samt loggutdrag och information om nätverksanslutning.
- Högerklicka var som helst i webbläsarfönstret och välj "Inspektera"
- Ett nytt fönster öppnas med flera flikar. Flikarna "Console" och "Network" är troligtvis de mest användbara.
- Med hjälp av de här flikarna kan vi se exakt vilka REST API-anrop som görs till NetWorker-servern.
- På fliken Nätverk kan vi också se begärandemetoden och REST API-svaret från NetWorker-servern. På så sätt kan vi spåra exakt vad som begärs av NetWorker-servern och exakt hur NetWorker-servern svarar på den här förfrågan.
Problem med gränssnitts backend
Viktiga loggar för användargränssnittets backend är:
catalina.log – Tomcat-serverloggning och loggning av programdriftsättning.
nwui.log – loggning av NWUI-programserver.
restapi.log – NetWorker REST API-loggning. NWUI kommunicerar med NetWorker-servern med NetWorker REST API.
daemon.raw – NetWorker-serverloggning.
Var dessa loggfiler finns beror på vilket operativsystem som används, samt om installationen av NWUI är lokal för NetWorker-servern eller fjärrstyrd. Om NWUI finns på själva NetWorker-servern delar det samma tomcat-instans med NetWorker.
Om du tillhandahåller en .raw loggfil till supporten rekommenderar vi att du återger loggfilen på det system som den kommer från. Detta säkerställer att tidsstämplarna tillhandahålls i serverns lokala tid:
NetWorker: Använda nsr_render_log
Loggfiler
Linux:
Processerna som körs för användargränssnittets serverdel är: /opt/nwui/bin/nwuictld och jsvc.exec Du kan kontrollera om de körs med ps-kommandot:
Loggarna finns här:
Lokal till NetWorker-server:
- /opt/nwui/loggar
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
Fjärr:
- /opt/nwui/loggar
- /nsr/nwui/logs
Windows
Windows NWUI-backend-process som måste köras kallas nwuictld.exe:
Du kan hantera detta från services.msc:
Loggarna finns här:
Lokal till NetWorker-server:
- C:\Program Files\EMC NetWorker\nwui\logs
- C:\Program Files\EMC NetWorker\nsr\authc-server\logs
- C:\Program\EMC NetWorker\nsr\restapi\restapi.log
- C:\Program\EMC NetWorker\nsr\logs\daemon.raw
Fjärr:
- C:\Program Files\EMC NetWorker\nwui\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIDSSTÄMPEL].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIDSSTÄMPEL]_0_MCUI.log
NetWorker-server
Kör nsrget-verktyget på NetWorker-servern för att samla in relevanta loggar:
Networker: Använda NSRGet NetWorker Data Collection Tool
De mest relevanta loggarna beror på åtgärden som försöker utföras från NWUI. Mer information om NetWorker-loggar finns i:
Networker: Loggfiler och platser
Felsökning
Om du vill felsöka REST API-kommunikationen ändrar du felsökningsnivå i filen logback.xml på NetWorker-servern:
Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes
Koppla bort de rader som hanterar API-anropsloggning. Det gör att loggningsnivån ställs in på "trace" för REST API-begäranden och -svar.