NetWorker Management Web UI (NWUI): Průvodce tříděním problémů a odstraňováním problémů

Summary: NetWorker Management Web UI (NWUI): Průvodce tříděním problémů a odstraňováním problémů

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

Jak NWUI funguje

Webové uživatelské rozhraní NetWorker (NWUI) využívá následující technologie: HTML5, Apache Tomcat, Spring Framework, Angular Framework a rozhraní API (Application Programming Interface) REST (Representational State Transfer). Aplikaci NWUI lze nainstalovat na operační systémy Linux nebo Windows. Lze jej nainstalovat buď přímo na server NetWorker, nebo na hostitele, který není serverem NetWorker.


                  kA5f10000004LFmCAM_1_0


Existují čtyři důležité komponenty:
Tyto součásti mohou být na stejném hostiteli nebo na různých hostitelích.
  • Webový front-end:  Jedná se o prezentační vrstvu napsanou v prostředí HTML5 a Angular Framework, která uživateli prezentuje operace NetWorker prostřednictvím webového prohlížeče. Webový prohlížeč je připojen k back-endovým procesům uživatelského rozhraní.
  • Backendové uživatelské rozhraní:  Back-endová aplikace je napsaná ve Spring Frameworku.  Používá Javu a Apache Tomcat. Komunikace mezi front-endem a backendem a mezi backendem a serverem NetWorker probíhá pomocí interních volání rozhraní REST API. Proces NWUI používá 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: Prostředí REST serveru NetWorker je zodpovědné za příjem volání rozhraní 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 RabbitMQ se také používá k interakci s nsrjobd.
  • AuthC: Komponenta authc nástroje NetWorker se používá pro všechny potřeby ověřování. Žádající proces kontaktuje AuthC za účelem ověření přihlašovacích údajů. Po ověření vydá AuthC časový, podepsaný a šifrovaný token. Komponenty NetWorker používají tento token k ověření uživatele a autorizaci nebo neprovedení požadované operace. Obvykle se nachází na serveru NetWorker, ale lze jej nainstalovat i na samostatného hostitele. 
Většina komunikace využívá rozhraní REST API, které umožňuje interakci se zdroji identifikovanými adresami URI (Uniform Resource Identifier). Používá příkazy HTTP (HEAD, GET, PUT, POST, DELETE) k interakci s identifikátory URI (Uniform Resource Identifiers) bezstavovým způsobem. Tato volání rozhraní REST API jsou interní pro operace NetWorker a NWUI. Nesmí být zaměňovány s rozhraním NetWorker REST API, které poskytuje programový přístup k nástroji NetWorker pro programování vlastních operací, což je popsáno 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 vytvořit úplný popis problému, zvažte následující otázky:
  • Nefunguje žádná operace?
  • Funguje tato operace, když je inicializována z vnějšku NWUI (například: Z konzole NetWorker Management Console (NMC))?
  • Jde o trvalý nebo občasný problém?
  • Pokud k občasným výpadkům, je znám nějaký spouštěč?
  • Fungovalo to lépe a pokud ano, jsou známy nějaké změny, které se objevily před a po výskytu problému?
  • Kdy se problém poprvé objevil (a co se od jeho objevení změnilo)?
  • Dochází k problému pouze v době velkého zatížení zálohovacího prostředí?
  • Jaký je rozsah problému (všechny operace obnovení / některé operace obnovení, některé karty nefungují a jiné nejsou dotčeny)?
  • Co bylo dosud vyzkoušeno a jaké závěry z toho byly vyvozeny?

PODROBNOSTI O PROSTŘEDÍ
  • Jaká je verze serveru NetWorker a platforma operačního systému?
  • Je nástroj NWUI nainstalován na serveru NetWorker nebo na samostatném hostiteli?
    • Jaká je verze NWUI, pokud je nainstalována na hostiteli neexistujícím než server NetWorker?
  • Jaký balíček Java je nainstalován na serveru NWUI; je nainstalováno prostředí NetWorker Runtime Environment (NRE) nebo prostředí Oracle Java Runtime Environment (JRE).
Ověřování
Ověřování používá AuthC stejným způsobem jako konzoli NetWorker Management Console a příkaz nsrlogin . V případě problémů s ověřováním začněte testováním ověřování na samotném serveru NetWorker, abyste oddělili, 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í pomocí místních účtů NetWorker, abyste zjistili, zda problém ovlivňuje pouze externí metodu ověřování.

Typický příkaz, který slouží k otestování, zda proces ověřování na serveru NetWorker funguje podle očekávání, je:  
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
 
Průvodce konfigurací zabezpečení NetWorker obsahuje veškeré podrobnosti o tom, jak funguje ověřování NetWorker, jak je otestovat a jak v případě potřeby resetovat heslo.

Pokud je vyžadována další diagnostika ověřování, přečtěte si článek:  NetWorker: Jak povolit AUTHC DEBUG pro účely odstraňování problémů

Problémy s instalací
Podrobnosti o instalaci NWUI a protokolech, které je třeba konzultovat v případě potíží s instalací, naleznete v následujícím článku:
Webové uživatelské rozhraní NetWorker Management (NWUI): Jak nainstalovat
 
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, abyste zjistili, zda je problém specifický pro jeden prohlížeč.

V prohlížeči klikněte pravým tlačítkem myši a "zkontrolujte", abyste viděli volání rozhraní REST API, která jsou prováděna z prohlížeče, a také příkazy protokolu a informace o síťovém připojení.
  • Klikněte pravým tlačítkem kamkoli do okna prohlížeče a vyberte možnost "zkontrolovat".
  • Otevře se nové okno s několika kartami.  Nejužitečnější budou pravděpodobně karty "Konzole" a "Síť".
  • Na těchto kartách jsou uvedena přesná volání rozhraní REST API na server NetWorker. 
  • Na kartě Network se také zobrazí metoda požadavku a odpověď rozhraní REST API ze serveru NetWorker. Tímto způsobem lze přesně sledovat, co je od serveru NetWorker požadováno a jak přesně server NetWorker na tento požadavek reaguje.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Problémy s backendovým uživatelským rozhraním

Důležité back-endové protokoly uživatelského rozhraní jsou:
    catalina.log – Protokolování serveru Tomcat a protokolování nasazení aplikace.
    nwui.log – Protokolování aplikačního serveru NWUI.
    restapi.log – Protokolování rozhraní REST API platformy NetWorker.  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žitém operačním systému a také na tom, zda je instalace NWUI místní pro server NetWorker, nebo vzdálená.  Pokud se NWUI nachází na samotném serveru NetWorker, sdílí stejnou instanci tomcat s nástrojem NetWorker.
Pokud poskytuje .raw soubor protokolu pro podporu, doporučuje se vykreslit soubor protokolu v systému, ze kterého pochází. Tím zajistíte, že se časová razítka vykreslí v místním čase serveru: NetWorker: Návod k použití nsr_render_log

Soubory protokolu

Linux:

Procesy, které běží pro back-end uživatelského rozhraní, jsou:  /opt/nwui/bin/nwuictld a jsvc.exec Spuštění , můžete zkontrolovat pomocí příkazu ps:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
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

Backendový proces NWUI systému Windows, který musí být spuštěn, se nazývá nwuictld.exe:


                  kA5f10000004LFmCAM_1_5

Můžete to spravovat z services.msc:

                  kA5f10000004LFmCAM_1_6
 

Protokoly jsou zde:

Místní na server NetWorker:
  • C:Program FilesEMC NetWorker wuilogs
  • C:Program FilesEMC NetWorker srauthc-serverlogs
  • C:Program FilesEMC NetWorker sr estapi estapi.log
  • C:Program FilesEMC NetWorker srlogsdaemon.raw
Vzdálené: 
  • C:Program FilesEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ČASOVÉ RAZÍTKO].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ČASOVÉ RAZÍTKO]_0_MCUI.log
Server NetWorker

Spuštěním nástroje nsrget na serveru NetWorker shromážděte příslušné protokoly:
NetWorker: Jak používat nástroj

shromažďování dat NSRGet NetWorker
Nejrelevantnější protokoly závisí na operaci, o kterou se pokoušíte z NWUI. Další informace o protokolech NetWorker naleznete v tématu:
NetWorker: Soubory a umístění protokolu

Ladění

Chcete-li ladit komunikaci rozhraní REST API, změňte úroveň ladění v souboru logback.xml na serveru NetWorker:

Windows: C:Program FilesEMC NetWorker srauthc-server omcatwebapps wrestapiWEB-INFclasses
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  kA5f10000004LFmCAM_1_7

Odkomentujte řádky, které se zabývají protokolováním volání rozhraní API. To způsobí, že úroveň protokolování bude nastavena na trasování pro požadavky a odpovědi rozhraní REST API.

                  kA5f10000004LFmCAM_1_8

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 08 May 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.