Sieciowy interfejs użytkownika NetWorker Management (NWUI): podręcznik weryfikacji i rozwiązywanie problemów

Summary: Sieciowy interfejs użytkownika NetWorker Management (NWUI): podręcznik weryfikacji i rozwiązywanie problemów

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 działa NWUI

Sieciowy interfejs użytkownika NetWorker (NWUI) wykorzystuje następujące technologie: Interfejs programowania aplikacji (API) HTML5, Apache Tomcat, Spring Framework, Angular Framework i Representational State Transfer (REST). Aplikację NWUI można zainstalować w systemach operacyjnych Linux lub Windows. Można go zainstalować bezpośrednio na serwerze NetWorker lub na hoście, który nie jest serwerem NetWorker.


                  Elementy składowe NWUI 


Składa się ona z czterech ważnych elementów:
Elementy te mogą znajdować się na tym samym hoście lub na różnych hostach.
  • Interfejs sieciowy:  Jest to warstwa prezentacji napisana w HTML5 i Angular Framework, która prezentuje użytkownikowi operacje NetWorker za pośrednictwem przeglądarki internetowej. Przeglądarka internetowa jest połączona z procesami zaplecza interfejsu użytkownika.
  • Backend interfejsu użytkownika:  Aplikacja zaplecza jest napisana w programie Spring Framework.  Wykorzystuje Javę i Apache Tomcat. Komunikacja między frontendem a backendem oraz między backendem a serwerem NetWorker odbywa się za pomocą wewnętrznych wywołań interfejsu API REST. Proces NWUI używa istniejącej instancji Apache Tomcat na serwerze NetWorker lub instaluje własną instancję Apache Tomcat, jeśli jest instalowany zdalnie z serwera NetWorker.
  • Serwer NetWorker: Struktura REST serwera NetWorker jest odpowiedzialna za odbieranie wywołań interfejsu API REST z zaplecza interfejsu użytkownika i łączenie ich z podstawowymi składnikami serwera NetWorker. Magistrala komunikatów serwera NetWorker RabbitMQ jest również używana do interakcji z nsrjobd.
  • AUTHC: Komponent AUTHC NetWorker jest używany do wszystkich potrzeb związanych z uwierzytelnianiem. Proces żądania kontaktuje się z AuthC w celu zweryfikowania poświadczeń; po weryfikacji AuthC wystawia token oparty na czasie, podpisany i zaszyfrowany. Składniki NetWorker używają tego tokenu do weryfikacji użytkownika i autoryzowania żądanej operacji. Zwykle znajduje się on na serwerze NetWorker, ale można go zainstalować na innym hoście. 
Większość komunikacji odbywa się przy użyciu interfejsu API REST, który umożliwia interakcję z zasobami identyfikowanymi przez adresy Uniform Resource Identifier (URI). Używa czasowników HTTP (HEAD, GET, PUT, POST, DELETE) do interakcji z identyfikatorami Uniform Resource Identifiers (URI) w sposób bezstanowy. Te wywołania interfejsu API REST są wewnętrzne dla operacji NetWorker i NWUI.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solidny #e6e6e6; } tr th { kolor-tła: #f5f5f5; } Nie należy mylić ich z interfejsem API REST NetWorker, który umożliwia wykonywanie operacji niestandardowych i jest udokumentowany w podręczniku programisty interfejsu NetWorker REST API.

Rozwiązywanie problemów

Definiowanie problemu

SZCZEGÓŁY PROBLEMU
Aby wygenerować pełny opis problemu, należy wziąć pod uwagę następujące pytania:
  • Jaka operacja jest podejmowana, ale nie działa?
  • Czy ta operacja działa, gdy jest inicjowana spoza NWUI (na przykład: Z poziomu konsoli NetWorker Management Console (NMC)?
  • Czy problem występuje regularnie, czy sporadycznie?
  • Jeśli występują sporadycznie, czy istnieje znany czynnik wyzwalający?
  • Czy to działało lepiej wcześniej, a jeśli tak, to czy są jakieś znane zmiany zastosowane przed i po pojawieniu się problemu?
  • Kiedy problem pojawił się po raz pierwszy (i co się zmieniło od czasu jego pojawienia się)?
  • Czy problem występuje tylko w okresach dużego obciążenia środowiska zapasowego?
  • Jaki jest zakres problemu (wszystkie operacje odzyskiwania lub niektóre operacje odzyskiwania, niektóre karty nie działają, a inne nie)?
  • Co do tej pory próbowano naprawić i jakie wnioski z tego wyciągnięto?

SZCZEGÓŁY ŚRODOWISKA
  • Jaka jest wersja serwera NetWorker i platforma systemu operacyjnego?
  • Czy interfejs NWUI jest zainstalowany na serwerze NetWorker, czy na osobnym hoście?
    • Jaka jest wersja NWUI w przypadku zainstalowania na hoście innym niż serwer NetWorker?
  • Jaki pakiet Java jest zainstalowany na serwerze NWUI; Czy jest zainstalowane środowisko NetWorker Runtime Environment (NRE) lub Oracle Java Runtime Environment (JRE).
Uwierzytelnianie
Uwierzytelnianie korzysta z AUTHC w taki sam sposób jak konsola NetWorker Management Console i nsrlogin . W przypadku problemów z uwierzytelnianiem najpierw przetestuj uwierzytelnianie na serwerze NetWorker, aby ustalić, czy problem dotyczy interfejsu NWUI, czy samego serwera. W przypadku uwierzytelniania za pomocą protokołu AD lub LDAP należy najpierw przeprowadzić test na lokalnych kontach NetWorker, aby potwierdzić, czy problem dotyczy tylko uwierzytelniania zewnętrznego.

Typowe polecenie używane do sprawdzenia, czy proces uwierzytelniania działa zgodnie z oczekiwaniami na serwerze NetWorker, to:  
authc_mgmt -u [user name] -p [password] -e find-all-users.

lub:

Lokalne konto NetWorker:

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Konto zewnętrzne (AD/LDAP):
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
Podręcznik konfiguracji zabezpieczeń NetWorker zawiera szczegółowe informacje na temat działania uwierzytelniania NetWorker, testowania go oraz resetowania hasła, jeśli jest to wymagane.

Jeśli wymagana jest dalsza diagnostyka uwierzytelniania, zobacz:  NetWorker: Włączanie funkcji AUTHC DEBUG w celu rozwiązywania problemów

Problemy z instalacją
Aby uzyskać szczegółowe informacje na temat instalowania interfejsu NWUI i dzienników, z którymi należy się zapoznać w przypadku wystąpienia problemu z instalacją, zobacz następujący artykuł:
NetWorker Management Web UI (NWUI): Jak zainstalować                   

 

Problemy z zapleczem interfejsu użytkownika

Ważne dzienniki zaplecza interfejsu użytkownika to:
Ścieżka systemu Linux Ścieżka systemu Windows (domyślnie) Funkcja
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Rejestrowanie serwera Tomcat i rejestrowanie wdrażania aplikacji.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Rejestrowanie serwera aplikacji NWUI.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log Rejestrowanie interfejsu API REST NetWorker. NWUI komunikuje się z serwerem NetWorker za pomocą interfejsu API REST NetWorker. Zapoznaj się z sekcją interfejsu API REST w tym artykule, aby dowiedzieć się, jak zdiagnozować, jakie funkcje interfejsu API REST są używane, wraz z odpowiednią odpowiedzią.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Rejestrowanie serwera NetWorker.

Jeśli serwer NWUI znajduje się na serwerze NetWorker, współdzieli tę samą instancję tomcat z NetWorker.
Jeśli udostępniasz .raw do obsługi, zaleca się renderowanie pliku dziennika w systemie, z którego pochodzi. Dzięki temu znaczniki czasowe są renderowane w czasie lokalnym serwera: NetWorker: Sposób użycia nsr_render_log

Pliki dziennika

Linux:

Procesy, które są uruchamiane dla backendu interfejsu użytkownika to:  /opt/nwui/bin/nwuictld jsvc.exec Można sprawdzić, czy są one uruchomione za pomocą ps :
ps -ef | grep nwui
                  Wyjście ps pokazujące backend NWUI 
Dzienniki znajdują się tutaj:

Lokalnie dla serwera NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
Zdalny (serwer NWUI znajduje się na hoście innym niż serwer NetWorker):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
Do utworzenia pliku zip tych dzienników można użyć następującego polecenia
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
UWAGA: W zależności od tego, czy NWUI jest lokalne, czy zdalne dla serwera NetWorker, powyższe polecenie może zgłaszać brakujące niektóre katalogi. Jest to normalne. Nazwa hosta i data nie muszą być zmieniane, powyższe polecenie automatycznie tworzy pakiet z nazwą hosta serwera i aktualną datą (RRRR-MM-DD).
Windows

Proces zaplecza Windows NWUI, który musi być uruchomiony, nazywa się nwuictld.exe:


                  Lista zadań przedstawiająca usługę NWUI 

Możesz zarządzać tym w services.msc:

                  konsola usług wyświetlająca interfejs NWUI 
 

Dzienniki znajdują się tutaj:

Lokalnie dla serwera 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\
Tryb zdalny: 
  • 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
UWAGA: Pokazane ścieżki są domyślną ścieżką instalacji NetWorker. Jeśli oprogramowanie NetWorker zostało zainstalowane na innym dysku lub przy użyciu innej ścieżki, dostosuj je odpowiednio.
 
Serwer NetWorker

Uruchom narzędzie nsrget na serwerze NetWorker, aby zebrać odpowiednie dzienniki:
Networker: Jak korzystać z narzędzia

do zbierania danych NSRGet NetWorkerNajistotniejsze dzienniki zależą od operacji podejmowanej z NWUI. Aby uzyskać więcej informacji na temat dzienników NetWorker, zobacz:
Networker: Pliki dziennika i lokalizacje

Debugowanie

Aby debugować komunikację REST API, zmień poziom debugowania w logback.xml plik na serwerze NetWorker:

Windows (ustawienie domyślne): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  Plik logback 

Usuń komentarz z wierszy dotyczących rejestrowania wywołań interfejsu API. Powoduje to, że poziom rejestrowania jest ustawiony na "trace" dla żądań i odpowiedzi interfejsu API REST.

                  Ustawienia debugowania 

Patrz: NetWorker: Jak włączyć debugowanie interfejsu API REST

 

Interfejs REST API

NWUI używa interfejsu API REST do komunikacji z NetWorker. Dzienniki interfejsu API NWUI i REST pokazują funkcje interfejsu API i odpowiedzi NetWorker, ale informacje te można również sprawdzić bezpośrednio w przeglądarce. Ta metoda jest przydatna do znajdowania rozbieżności między interfejsami użytkownika a interfejsem wiersza poleceń NetWorker lub gdy interfejs użytkownika nie zwraca oczekiwanych wyników. 

 

  1. Podczas uzyskiwania dostępu do NWUI kliknij prawym przyciskiem myszy w oknie przeglądarki i wybierz opcję Sprawdź.

Sprawdzić

  1. W oknie "Inspekcja" przeglądarki kliknij kartę Sieć :

Inspekcja sieci w przeglądarce

  1. Podczas wykonywania funkcji w interfejsie NWUI operacje są wyświetlane w obszarze Nazwa. Kolumna Stan zawiera stan ukończenia interfejsu API REST: Żądanie i odpowiedź interfejsu API 
  2. Kliknij operację, którą chcesz dokładniej zbadać. Na przykład po kliknięciu funkcji tworzenia kopii zapasowych pokazanej powyżej na karcie Nagłówki zostaną wyświetlone następujące szczegóły:

Na tej podstawie można zidentyfikować adres URL żądania, metodę żądania i kod stanu.

  1. Aby wyświetlić ładunek odpowiedzi, kliknij kartę Odpowiedzi .

 

W tym przykładzie przedstawiono odpowiedź interfejsu API REST używaną do wypełniania karty Odzyskiwanie i zestawy zapisów po przeglądaniu kopii zapasowych platformy Azure i wybraniu zestawu zapisu do przywrócenia.

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.