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

Summary: NetWorker Management Web UI (NWUI): Průvodce posouzení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.


                  Součásti NWUI 


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ý frontend:  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 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 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.

a { text-decoration: none; color: #464feb; } tr th, tr td { hranice: 1px plný #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 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é 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 operace obnovení nebo 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í využívá nástroj AUTHC stejným způsobem jako konzole NetWorker Management Console a 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á 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 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 s backendovým uživatelským rozhraním

Důležité back-endové protokoly uživatelského rozhraní jsou:
Cesta k systému Linux Cesta k 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í REST API platformy NetWorker. 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 .raw protokolu, 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 jsvc.exec Jejich spuštění můžete zkontrolovat pomocí příkazu ps :
ps -ef | grep nwui
                  ps výstup zobrazující backend NWUI 
Protokoly jsou zde:

Místní na server 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í zipu 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 NWUI místní nebo vzdálený pro server NetWorker, 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 systému Windows, který musí být spuštěn, se nazývá nwuictld.exe:


                  Seznam úkolů se službou NWUI 

Můžete to spravovat z services.msc:

                  konzola služeb zobrazující NWUI 
 

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
  • 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 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

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 logback.xml soubor 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


                  Logback soubor 

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.

                  Nastavení ladění 

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

 

REST API

NWUI používá k propojení s NetWorker rozhraní REST API. Protokoly 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 NWUI klikněte pravým tlačítkem myši do okna prohlížeče a vyberte Zkontrolovat.

Zkontrolovat

  1. V okně "Zkontrolovat" prohlížeče klikněte na kartu Síť :

Prohlížeč Inspect Network

  1. Při provádění funkcí v NWUI se operace zobrazí pod položkou Name. Sloupec Stav 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ě Záhlaví 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 Odpovědi .

 

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

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 19 ديسمبر 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.