Jak funguje nwui
Webové uživatelské rozhraní NetWorker (NWUI) používá následující technologie: HTML5, Apache Tomcat, Spring Framework, Angular Framework a Representational State Transfer (REST) Application Programming Interface (API). Aplikaci NWUI lze nainstalovat v operačních systémech Linux nebo Windows. Lze jej nainstalovat přímo na server NetWorker nebo na hostitele, který není serverem NetWorker.
Existují čtyři důležité součásti:
Tyto součásti mohou být na stejném hostiteli nebo na samostatných hostitelích.
- Webový front-end: Jedná se o prezentační vrstvu se souborem HTML5 a Angular Framework, která uživateli prostřednictvím webového prohlížeče představuje operace NetWorker. Webový prohlížeč je připojen k backendovacím procesům uživatelského rozhraní.
- Backend uživatelského rozhraní: Backendová aplikace je napsána v jarním rámci. Využívá java a Apache Tomcat. Komunikace mezi front-endem a backendem a mezi backendem a serverem NetWorker se provádí pomocí interních volání REST API. Proces NWUI používá buď stávající instanci Apache Tomcat na serveru NetWorker, nebo nainstaluje vlastní instanci Apache Tomcat, pokud je nainstalována vzdáleně ze serveru NetWorker.
- Server NetWorker: Rozhraní NetWorker Server REST odpovídá za příjem volání REST API z backendu uživatelského rozhraní a jejich připojení k základním komponentám serveru NetWorker. Sběrnice zpráv NetWorker Server DefragmentMQ se také používá k interakci s funkcí nsrjobd.
- Ověření: Komponenta authc nástroje NetWorker se používá pro všechny potřeby ověřování. Proces, který vyžaduje ověření přihlašovacích údajů, se obrátí na společnost AuthC. Po ověření vydá ověření ověření čas, na základě, podpisu a šifrovaného tokenu. Součásti NetWorker používají tento token k ověření uživatele a autorizaci či nejedná se o požadovanou operaci. Obvykle se jedná o server NetWorker, ale lze ho nainstalovat na samostatného hostitele.
Většina komunikace využívá rozhraní REST API
, které umožňuje interakci se zdroji identifikými adresami identifikátoru UNIFORM (Uniform Resource Identifier). K interakci s identifikátory UNIFORM Resource Identifier (URI) bezstavovým způsobem využívá příkazy HTTP (HEAD, GET, PUT, POST, DELETE). Tato volání REST API jsou interní v operacích NetWorker a NWUI. Není třeba je zaměňovat s rozhraním NetWorker REST API, které poskytuje programový přístup k nástroji NetWorker za účelem programování operací vytvořených na míru, které jsou popsány v příručce pro vývojáře rozhraní NetWorker REST API.
Odstraňování problémů
Definování problému
PODROBNOSTI O
PROBLÉMUChcete-li vygenerovat úplný popis problému, zvažte následující otázky:
- Jaká operace nefunguje?
- Funguje tato operace při spuštění mimo NWUI (například: Z konzole NetWorker Management Console (NMC)?
- Je problém konzistentní nebo občasný?
- Pokud se přerušovaně, existuje známý spouštěč?
- Fungovalo to lépe dříve, a pokud ano, došlo k jakýmkoli známým změnám před a po tomuto problému?
- Kdy se problém vyskytl poprvé (a co se změnilo od okamžiku, kdy se problém objevil)?
- Dochází k problému pouze v případě vysokého zatížení v prostředí zálohování?
- Jaký je rozsah problému (všechny operace obnovení / některé operace obnovení, některé karty nefungují, zatímco jiné nejsou ovlivněny)?
- Co bylo dosud napraveno a jaké závěry bylo z toho vyvodeno?
PODROBNOSTI O PROSTŘEDÍ
- Co je verze serveru NetWorker a platforma operačního systému?
- Je rozhraní NWUI nainstalováno na server NetWorker nebo na samostatném hostiteli?
- Jaká je verze NWUI, pokud je nainstalována v hostiteli odděleném od serveru NetWorker?
- Jaký balíček Java je nainstalován na serveru NWUI; je nainstalované prostředí NetWorker Runtime Environment (NRE) nebo Oracle Java Runtime Environment (JRE).
Ověřování
Ověřování používá ověřování ověřování stejným způsobem jako konzole NetWorker Management Console a příkaz
nsrlogin . U problémů s ověřováním začněte testováním ověřování na samotném serveru NetWorker, aby bylo možné oddělit, zda problém s ověřováním souvisí s NWUI, či nikoli. Pokud používáte externí metodu ověřování, například AD nebo LDAP, doporučujeme nejprve otestovat ověřování s místními účty NetWorker a zjistit, zda má problém vliv pouze na externí metodu ověřování.
Typický příkaz používaný k testování, zda proces ověřování na serveru NetWorker funguje očekávaným způsobem:
authc_mgmt -u [user name] -p [password] -e find-all-users.
Nebo:
Místní účet NetWorker:
nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Externí účet (AD/LDAP):
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
Problémy s instalací
Problémy na straně prohlížeče
Pokud je nainstalováno více prohlížečů, otestujte zjištěný problém v různých prohlížečích a zjistěte, zda se problém týká pouze jednoho prohlížeče.
V prohlížeči klikněte pravým tlačítkem myši a vyberte možnost "inspect", chcete-li zobrazit volání REST API uskutečňovaná v prohlížeči, a také příkazy protokolů a informace o síťovém připojení.
- Klikněte pravým tlačítkem kamkoli v okně prohlížeče a vyberte možnost "Zkontrolovat".
- Otevře se nové okno s několika kartami. Nejužitečnější jsou karty "Console" a "Network".
- Na těchto kartách vidíme přesné volání REST API, která se uskutečňují na serveru NetWorker.
- Na kartě Network je také vidět metoda požadavku a odpověď rozhraní REST API ze serveru NetWorker. Tímto způsobem můžeme přesně sledovat, co je požadováno pro server NetWorker a jak přesně server NetWorker na tento požadavek reaguje.
Problémy s backendem uživatelského rozhraní
Důležité protokoly backendového uživatelského rozhraní:
catalina.log – Protokolování serveru Tomcat a protokolování implementace aplikací.
nwui.log – protokolování aplikačního serveru NWUI.
restapi.log – Protokolování NetWorker REST API. Rozhraní NWUI komunikuje se serverem NetWorker pomocí rozhraní NetWorker REST API.
daemon.raw – Protokolování serveru NetWorker.
Umístění těchto souborů protokolu závisí na používaném operačním systému a také na tom, zda je instalace nwui místní na server NetWorker nebo je vzdálená. Pokud se rozhraní NWUI nachází přímo na serveru NetWorker, sdílí stejnou instanci tomcat s nástrojem NetWorker.
Pokud poskytujete pro podporu soubor protokolu .raw, doporučujeme vykreslit soubor protokolu v systému, ze kterého pochází. Tím zajistíte, že se časová razítka vykreslují v místním čase serveru:
NetWorker: Jak používat nsr_render_log
Soubory protokolu
Linux:
Procesy spuštěné pro backend uživatelského rozhraní: /opt/nwui/bin/nwuictld a jsvc.exec Můžete zkontrolovat, zda jsou spuštěny pomocí příkazu ps:
Protokoly jsou zde:
Místní na server NetWorker:
- /opt/nwui/logs
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
Vzdálené:
- /opt/nwui/logs
- /nsr/nwui/logs
Windows
Proces backendu NWUI systému Windows, který musí být spuštěn, se nazývá nwuictld.exe:
Tuto možnost můžete spravovat v souboru services.msc:
Protokoly jsou zde:
Místní na server NetWorker:
- 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
Vzdálené:
- C:\Program Files\EMC NetWorker\nwui\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[ČASOVÉ RAZÍTKO].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[ČASOVÉ RAZÍTKO]_0_MCUI.log
NetWorker Server
Spusťte nástroj nsrget na serveru NetWorker a získejte příslušné protokoly:
Networker: Jak používat nástroj
NSRGet NetWorker Data CollectionNejrelevantnější protokoly závisí na pokusu o provoz nástroje NWUI. Další informace o protokolech NetWorker naleznete v části:
Networker: Soubory protokolu a umístění
Ladění
Chcete-li ladit komunikaci ROZHRANÍ REST API, změňte úroveň ladění v souboru logback.xml na serveru NetWorker:
Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes
Zrušte přidělení zdroje řádků, které se týkají protokolování hovorů rozhraní API. To způsobí, že úroveň protokolování bude nastavena na hodnotu "trace" pro požadavky a odpovědi rozhraní REST API.