Sieciowy interfejs użytkownika NetWorker Management (NWUI): Przewodnik weryfikacji i rozwiązywania problemów

Summary: Sieciowy interfejs użytkownika NetWorker Management (NWUI): Przewodnik weryfikacji i rozwiązywania 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.


                  kA5f10000004LFmCAM_1_0


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 frontonem 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.
  • Autoryzacja: 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. Nie należy ich mylić z interfejsem API REST NetWorker, który zapewnia programowy dostęp do NetWorker na potrzeby programowania niestandardowych operacji, co opisano w podręczniku programisty interfejsu API REST NetWorker.
 

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 / 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 używa AuthC w taki sam sposób jak konsola NetWorker Management Console i polecenie nsrlogin . W przypadku problemów z uwierzytelnianiem zacznij od przetestowania uwierzytelniania na samym serwerze NetWorker, aby określić, czy problem z uwierzytelnianiem jest związany z interfejsem NWUI. Jeśli korzystasz z zewnętrznej metody uwierzytelniania, takiej jak AD lub LDAP, zaleca się najpierw przetestować uwierzytelnianie przy użyciu lokalnych kont NetWorker, aby sprawdzić, czy problem dotyczy tylko zewnętrznej metody uwierzytelniania.

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 po stronie przeglądarki
Jeśli zainstalowanych jest wiele przeglądarek, przetestuj zaobserwowany problem w różnych przeglądarkach, aby sprawdzić, czy problem dotyczy tylko jednej przeglądarki.

W przeglądarce kliknij prawym przyciskiem myszy i wybierz polecenie "inspect", aby zobaczyć wywołania interfejsu API REST, które są wykonywane z przeglądarki, a także instrukcje dziennika i informacje o połączeniu sieciowym.
  • Kliknij prawym przyciskiem myszy w dowolnym miejscu okna przeglądarki i wybierz "sprawdź"
  • Otworzy się nowe okno z kilkoma kartami.  Karty "Konsola" i "Sieć" mogą być najbardziej przydatne.
  • Korzystając z tych kart, możemy zobaczyć dokładne wywołania interfejsu API REST, które są wykonywane na serwerze NetWorker. 
  • Na karcie sieć możemy również zobaczyć metodę żądania oraz odpowiedź REST API z serwera NetWorker. W ten sposób możemy dokładnie prześledzić, czego żąda serwer NetWorker i w jaki sposób serwer NetWorker odpowiada na to żądanie.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Problemy z zapleczem interfejsu użytkownika

Ważne dzienniki zaplecza interfejsu użytkownika to:
    catalina.log — rejestrowanie serwera Tomcat oraz rejestrowanie wdrażania aplikacji.
    nwui.log — rejestrowanie serwera aplikacji NWUI.
    restapi.log — rejestrowanie interfejsu API REST NetWorker.  NWUI komunikuje się z serwerem NetWorker za pomocą interfejsu API REST NetWorker.
    daemon.raw — rejestrowanie serwera NetWorker.

Lokalizacja tych plików dziennika zależy od używanego systemu operacyjnego, a także od tego, czy instalacja NWUI odbywa się lokalnie na serwerze NetWorker, czy zdalnie.  Jeśli interfejs NWUI znajduje się na serwerze NetWorker, współdzieli tę samą instancję tomcat z NetWorker.
W przypadku dostarczania .raw pliku dziennika do pomocy technicznej 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 oraz jsvc.exec Możesz sprawdzić, czy są uruchomione, używając polecenia ps:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
Dzienniki znajdują się tutaj:

Lokalnie dla serwera NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
Tryb zdalny:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Windows

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


                  kA5f10000004LFmCAM_1_5

Można tym zarządzać z poziomu services.msc:

                  kA5f10000004LFmCAM_1_6
 

Dzienniki znajdują się tutaj:

Lokalnie dla serwera 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
Tryb zdalny: 
  • C:Program FilesEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ZNACZNIK CZASU].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ZNACZNIK CZASU]_0_MCUI.log
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ę interfejsu API REST, zmień poziom debugowania w pliku logback.xml na serwerze NetWorker:

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


                  kA5f10000004LFmCAM_1_7

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.

                  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.