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.
Check out other resources

Instructions

Jak działa NWUI

Sieciowy interfejs użytkownika NetWorker (NWUI) korzysta z następujących technologii: HTML5, Apache Tomcat, Spring Framework, Angular Framework i REST (Representational State Transfer) API (Application Programming Interface). Aplikację NWUI można zainstalować w systemach operacyjnych Linux i Windows. Można ją zainstalować bezpośrednio na serwerze NetWorker lub na hoście, który nie jest serwerem NetWorker.


                  Komponenty NWUI 


Istnieją cztery ważne komponenty:
mogą one znajdować się na tym samym hoście lub na różnych hostach.
  • Sieciowy frontend:  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 backend interfejsu użytkownika.
  • Backend interfejsu użytkownika:  Aplikacja backend jest napisana w Spring Framework.  Korzysta z Java 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 REST API. Proces NWUI używa istniejącego wystąpienia Apache Tomcat na serwerze NetWorker lub instaluje własne wystąpienie Apache Tomcat w przypadku instalacji zdalnej z serwera NetWorker.
  • Serwer NetWorker: Struktura REST serwera NetWorker jest odpowiedzialna za odbieranie wywołań interfejsu REST API z backendu interfejsu użytkownika i łączenie ich z podstawowymi komponentami serwera NetWorker. Magistrala komunikatów serwera NetWorker RabbitMQ jest również używana do interakcji z nsrjobd.
  • AUTHC: Komponent NetWorker AUTHC spełnia wszystkie potrzeby związane z uwierzytelnianiem. Proces wysyłający żądanie kontaktuje się z AuthC w celu zweryfikowania poświadczeń; po weryfikacji AuthC wystawia podpisany i zaszyfrowany token czasowy. Komponenty 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 REST API, który umożliwia interakcję z zasobami identyfikowanymi na podstawie adresów Uniform Resource Identifier (URI). Używa poleceń HTTP (HEAD, GET, PUT, POST, DELETE) do interakcji z identyfikatorami Uniform Resource Identifiers (URI) w sposób bezstanowy. Te wywołania interfejsu REST API są wewnętrzne dla operacji NetWorker i NWUI.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } Nie należy mylić ich z interfejsem REST API 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 odpowiedzieć na następujące pytania:
  • Jaka podejmowana operacja nie działa?
  • Czy ta operacja działa, gdy jest inicjowana spoza NWUI (na przykład: z konsoli NetWorker Management Console (NMC))?
  • Czy problem występuje regularnie, czy sporadycznie?
  • Jeśli występuje sporadycznie, to czy istnieje znany czynnik wyzwalający?
  • Czy wcześniej wszystko działało lepiej, a jeśli tak, to czy są znane zmiany zastosowane przed i po pojawieniu się problemu?
  • Kiedy problem wystąpił 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 tworzenia kopii zapasowych?
  • Jaki jest zakres problemu (wszystkie lub tylko niektóre operacje odzyskiwania, nie działają tylko niektóre karty)?
  • Co do tej pory wypróbowano i jakie wnioski 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 osobnym hoście względem serwera NetWorker?
  • Jaki pakiet Java jest zainstalowany na serwerze NWUI; czy jest zainstalowane środowisko wykonawcze NetWorker (NRE) lub środowisko wykonawcze Oracle Java (JRE)?
Uwierzytelnianie
Uwierzytelnianie korzysta z AUTHC w taki sam sposób jak konsola NetWorker Management Console i polecenie 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ą AD lub LDAP najpierw przeprowadź 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:   
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 w razie potrzeby.

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ł:
Sieciowy interfejs użytkownika NetWorker Management (NWUI): jak zainstalować                   

 

Problemy z backendem interfejsu użytkownika

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

Jeśli serwer NWUI działa na samym serwerze NetWorker, współdzieli to samo wystąpienie tomcat z NetWorker.
Jeśli udostępniasz plik dziennika .raw obsłudze, zaleca się jego renderowanie w systemie, z którego pochodzi. Dzięki temu znaczniki czasowe są renderowane w czasie lokalnym serwera: NetWorker: korzystanie z

plików dziennika nsr_render_log

Linux:

Procesy uruchamiane na potrzeby backendu interfejsu użytkownika to:  /opt/nwui/bin/nwuictld i jsvc.exec Można sprawdzić, czy są one uruchomione za pomocą polecenia ps : 
ps -ef | grep nwui
                  dane wyjściowe ps pokazujące backend NWUI 
Dzienniki znajdują się tutaj:

Lokalne dla serwera NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
Zdalne (serwer NWUI działa 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 interfejs NWUI jest lokalny, czy zdalny dla serwera NetWorker, powyższe polecenie może zgłaszać brakujące niektóre katalogi. Jest to normalne. Nazwa hosta i data nie wymagają zmiany; powyższe polecenie automatycznie tworzy pakiet z nazwą hosta serwera i aktualną datą (RRRR-MM-DD).
Windows

Proces backendu NWUI w systemie Windows, 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:

Lokalne 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 to domyślne ścieżki 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: Korzystanie z narzędzia gromadzenia danych NetWorker NSRGet

Najistotniejsze dzienniki zależą od operacji podejmowanej z poziomu 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 pliku logback.xml na serwerze NetWorker:

Windows (domyślnie): 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ń znaki komentarza z wierszy dotyczących rejestrowania wywołań interfejsu API w dzienniku. Powoduje to ustawienie poziomu rejestrowania w dzienniku na „trace” dla żądań i odpowiedzi interfejsu REST API.

                  Ustawienia debugowania 

Patrz: NetWorker: Włączanie debugowania interfejsu REST API

 

Interfejs REST API

NWUI używa interfejsu REST API do komunikacji z NetWorker. Dzienniki interfejsu NWUI i REST API pokazują funkcje 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 polecenia 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ę Inspect.

Inspect

  1. W oknie Inspect przeglądarki kliknij kartę Network:

browser inspect network

  1. Podczas wykonywania funkcji w interfejsie NWUI operacje są wyświetlane w obszarze Name. Kolumna Status zawiera stan ukończenia zadania interfejsu REST API: Żądanie i odpowiedź interfejsu API 
  2. Kliknij operację, którą chcesz dokładniej zbadać. Na przykład po kliknięciu funkcji backups pokazanej powyżej na karcie Headers 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ć dane użyteczne odpowiedzi, kliknij kartę Responses.

 

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

Additional Information

Materiały dotyczące NWUI

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

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.