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

Shrnutí: NetWorker Management Web UI (NWUI): Průvodce posouzením a odstraňováním problémů

Tento článek se vztahuje na Tento článek se nevztahuje na Tento článek není vázán na žádný konkrétní produkt. V tomto článku nejsou uvedeny všechny verze produktu.

Pokyny

Jak funguje rozhraní NWUI

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


                  Součásti rozhraní NWUI 


Obsahuje čtyři důležité součásti:
Tyto součásti mohou být na stejném hostiteli nebo na různých hostitelích.
  • Webový frontend:  Jedná se o prezentační vrstvu napsanou v 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 backendovým procesům uživatelského rozhraní.
  • Backendové uživatelské rozhraní:  Backendová aplikace je napsaná ve Spring Framework.  Používá jazyk java a software Apache Tomcat. Komunikace mezi frontendem 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 k instalaci dojde 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 součástem serveru NetWorker. Sběrnice zpráv NetWorker Server RabbitMQ se také používá k interakci s nástrojem nsrjobd.
  • AUTHC: Komponenta AUTHC nástroje NetWorker se používá pro všechny potřeby ověřování. Žádající proces kontaktuje komponentu AuthC za účelem ověření přihlašovacích údajů. Po ověření vydá komponenta AuthC časový, podepsaný a šifrovaný token. Komponenty NetWorker používají tento token k ověření uživatele a autorizaci či zamítnutí 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.

{ text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } Nezaměňujte je s rozhraním NetWorker REST API, které umožňuje vlastní operace a je zdokumentováno v příručce k rozhraní REST API pro vývojáře.

Odstraňování problémů

Definování problému

PODROBNOSTI O PROBLÉMU
Chcete-li vytvořit úplný popis problému, zvažte následující otázky:
  • Která nefunkční operace se pokouší spustit?
  • Funguje tato operace, když je inicializována z vnějšku rozhraní NWUI (například: z konzole NetWorker Management Console – NMC)?
  • Jde o trvalý nebo občasný problém?
  • Pokud k němu dochází občas, je znám nějaký spouštěč?
  • Fungovala předtím operace lépe a pokud ano, jsou známy nějaké změny, které byly provedeny před a po objevení problému?
  • Kdy se problém poprvé vyskytl (a co se změnilo od doby, kdy se problém objevil)?
  • Dochází k problému pouze v době velkého zatížení zálohovacího prostředí?
  • Jaký je rozsah problému (všechny nebo jen některé operace obnovení, nefungují jen některé karty a ostatní jsou v pořádku)?
  • Jaká řešení byla vyzkoušena 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 rozhraní NWUI nainstalováno na serveru NetWorker nebo na samostatném hostiteli?
    • Jaká je verze rozhraní NWUI, pokud je nainstalována na hostiteli odděleném od serveru 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í využívá nástroj AUTHC stejným způsobem jako konzole NetWorker Management Console a příkaz nsrlogin . V případě problémů s ověřováním nejprve otestujte ověřování na serveru NetWorker, abyste zjistili, zda se problém týká rozhraní NWUI nebo samotného serveru. Pokud k ověřování používáte službu AD nebo LDAP, nejprve proveďte test s místními účty NetWorker, abyste zjistili, zda se problém týká pouze externího 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 nástroj AUTHC DEBUG pro účely odstraňování problémů

Problémy s instalací
Podrobnosti o instalaci rozhraní NWUI a protokolech, které je třeba konzultovat v případě potíží s instalací, naleznete v následujícím článku:
Rozhraní NWUI (NetWorker Management Web UI): Jak provést instalaci                   

 

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

Důležité backendové protokoly uživatelského rozhraní:
Cesta v systému Linux Cesta v systému Windows (výchozí) Funkce
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Protokolování serveru Tomcat a protokolování nasazení aplikace.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Protokolování aplikačního serveru NWUI.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log Protokolování rozhraní NetWorker REST API. Rozhraní NWUI komunikuje se serverem NetWorker pomocí rozhraní NetWorker REST API. Informace o tom, jak diagnostikovat, jaké funkce rozhraní REST API se používají, spolu s odpovídající odpovědí najdete v části REST API v tomto článku.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Protokolování serveru NetWorker.

Pokud se server NWUI nachází na samotném serveru NetWorker, sdílí stejnou instanci tomcat s nástrojem NetWorker.
Pokud poskytujete soubor protokolu .raw , doporučujeme renderovat soubor protokolu v systému, ze kterého pochází. Tím zajistíte, že se časová razítka vyrenderují v místním čase serveru: NetWorker: Jak používat protokol nsr_render_log

Soubory protokolu

Linux:

Procesy, které běží pro backend uživatelského rozhraní:  /opt/nwui/bin/nwuictld jsvc.exec Jejich spuštění můžete zkontrolovat pomocí příkazu ps :
ps -ef | grep nwui
                  výstup ps zobrazující backend NWUI 
Protokoly najdete zde:

Místní na serveru NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
Vzdálené (server NWUI se nachází na hostiteli odděleném od serveru NetWorker):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
K vytvoření souboru ZIP z těchto protokolů lze použít následující příkaz:
tar cvzfP /tmp/$(hostname)_$(date -I).tgz  /opt/nwui/logs  /nsr/nwui/logs  /nsr/authc/logs  /nsr/logs/daemon.raw  /nsr/logs/restapi  /nsr/nwui/monitoring/app/logs/ ; chmod 777 /tmp/$(hostname)_$(date -I).tgz ; ls -lth /tmp/$(hostname)_$(date -I).tgz
POZNÁMKA: V závislosti na tom, zda je rozhraní NWUI pro server NetWorker místní nebo vzdálené, může výše uvedený příkaz hlásit některé adresáře jako chybějící. To se očekává. Název hostitele a datum není nutné měnit. Výše uvedený příkaz automaticky vytvoří balíček s názvem hostitele serveru a aktuálním datem (RRRR-MM-DD).
Windows

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


                  seznam úloh, který obsahuje službu NWUI 

Ten lze spravovat z services.msc:

                  konzola služeb, která zobrazuje rozhraní NWUI 
 

Protokoly najdete zde:

Místní na serveru 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
  • C:\Program Files\EMC NetWorker\nwui\monitoring\app\logs\
Vzdálené: 
  • C:\Program Files\EMC NetWorker\nwui\logs
  • %LOCALAPPDATA%\TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%\TempNetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
POZNÁMKA: Zobrazené cesty jsou výchozí cestou instalace nástroje NetWorker. Pokud byl nástroj NetWorker nainstalován na jiném disku nebo pomocí jiné cesty, proveďte odpovídající úpravy.
 
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 NSRGet na shromažďování dat v prostředí NetWorker

Nejrelevantnější protokoly závisí na operaci, o kterou se pokoušíte z rozhraní NWUI. Další informace o protokolech NetWorker naleznete v části:
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 (výchozí): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  soubor logback 

Zrušte komentáře řádků, 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.

                  Nastavení ladění 

Viz: NetWorker: Jak povolit ladění rozhraní REST API

 

REST API

Rozhraní NWUI používá k propojení s nástrojem NetWorker rozhraní REST API. Protokoly rozhraní NWUI a REST API zobrazují funkce API a odpovědi NetWorker, ale tyto informace lze také zkontrolovat přímo v prohlížeči. Tato metoda je užitečná při hledání nesrovnalostí mezi uživatelským rozhraním a rozhraním příkazového řádku NetWorker nebo v případě, že uživatelské rozhraní nevrací očekávané výsledky. 

 

  1. Při přístupu k rozhraní NWUI klikněte pravým tlačítkem myši do okna prohlížeče a vyberte možnost Inspect.

Inspect

  1. V okně „Inspect“ prohlížeče klikněte na kartu Network:

prohlížeč – Inspect, Network

  1. Při provádění funkcí v rozhraní NWUI se operace zobrazí v poli Name. Sloupec Status obsahuje stav dokončení rozhraní REST API: Požadavek a odpověď rozhraní API 
  2. Klikněte na operaci, kterou chcete dále prozkoumat. Když například kliknete na výše uvedenou funkci zálohování, zobrazí se na kartě Headers následující podrobnosti:

Z toho lze identifikovat adresu URL požadavku, metodu požadavku a stavový kód.

  1. Chcete-li zobrazit datovou část odpovědi, klikněte na kartu Responses.

 

Tento příklad ukazuje odpověď rozhraní REST API, která se používá k vyplnění karty Recover and Savesets po procházení záloh Azure a výběru sady uložení pro obnovení.

Další informace

Dotčené produkty

NetWorker

Produkty

NetWorker, NetWorker Series
Vlastnosti článku
Číslo článku: 000010592
Typ článku: How To
Poslední úprava: 19 pro 2025
Verze:  5
Najděte odpovědi na své otázky od ostatních uživatelů společnosti Dell
Služby podpory
Zkontrolujte, zda se na vaše zařízení vztahují služby podpory.