Jak działa NWUI
Internetowy interfejs użytkownika NetWorker (NWUI) wykorzystuje następujące technologie: HTML5, Apache Tomcat, Spring Framework, Angular Framework i Representational State Transfer (REST) Application Programming Interface (API). 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.
Istnieją cztery ważne komponenty:
Komponenty te mogą znajdować się na tym samym hoście lub na oddzielnych hostach.
- Front-end sieci Web: Jest to warstwa prezentacji zapisana w formacie HTML5 i Angular Framework, która przedstawia operacje NetWorker użytkownikowi za pośrednictwem przeglądarki internetowej. Przeglądarka internetowa jest połączona z procesami zaplecza interfejsu użytkownika.
- Zaplecze interfejsuużytkownika: Aplikacja zaplecza jest zapisywana w programie Spring Framework. Używa języka java i Apache Tomcat. Komunikacja między front-end i zapleczem oraz między zapleczem a serwerem NetWorker odbywa się przy użyciu wewnętrznych wywołań interfejsu REST API. Proces NWUI wykorzystuje istniejącą instancję Apache Tomcat na serwerze NetWorker lub instaluje własną instancję Apache Tomcat, jeśli jest zainstalowana 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 podłączanie ich do podstawowych komponentów serwera NetWorker. Magistrala komunikatów NetWorker Server Do interakcji z nsrjobd służy również magistrala komunikatów NetWorker Server.
- Kontroler AuthC: Składnik authc NetWorker jest używany do wszystkich potrzeb w zakresie uwierzytelniania. Proces żądania kontaktuje się z firmą AuthC w celu zweryfikowania poświadczeń; po weryfikacji AuthC wystawia token jednorazowy, oparty, podpisany i zaszyfrowany. Komponenty NetWorker używają tego tokenu do weryfikacji użytkownika i autoryzowania żądanej operacji. Zazwyczaj znajduje się na serwerze NetWorker, ale można go zainstalować na oddzielnym hoście.
Większość komunikacji korzysta z interfejsu REST API
, który umożliwia interakcję z zasobami zidentyfikowanymi przez adresy Uniform Resource Identifier (URI). Używa czasowników HTTP (HEAD, GET, PUT, POST, DELETE) do interakcji z identyfikatorami zasobów (URI) w sposób bezstanowy. Te wywołania interfejsu REST API 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 do programowania niestandardowych operacji, które zostały opisane w podręczniku dewelopera interfejsu API REST NetWorker.
Rozwiązywanie problemów
Definiowanie problemu
SZCZEGÓŁY PROBLEMU
W celu wygenerowania pełnego opisu problemu należy wziąć pod uwagę następujące pytania:
- Jakie operacje są podejmowane, co nie działa?
- Czy ta operacja działa po zainicjowaniu spoza NWUI (na przykład: Z konsoli zarządzania NetWorker Management Console (NMC)?
- Czy problem jest spójny czy przejściowy?
- Czy w przypadku przerw występuje znany wyzwalacz?
- Czy rozwiązanie to działało wcześniej lepiej, a jeśli tak, czy zostały zastosowane jakiekolwiek zmiany przed i po pojawieniu się problemu?
- Kiedy problem wystąpił po raz pierwszy (i co zmieniło się od momentu pojawienia się problemu)?
- Czy problem występuje tylko w okresach dużego obciążenia środowiska tworzenia kopii zapasowych?
- Jaki jest zakres problemu (wszystkie operacje odzyskiwania /niektóre operacje odzyskiwania, niektóre karty nie działają, podczas gdy inne nie są zagrożone)?
- Co zostało dotychczas wypróbowane w celu rozwiązania problemu i jakie wnioski zostały z tego wyciągnięte?
SZCZEGÓŁY DOTYCZĄCE ŚRODOWISKA PRACY
- Jaka jest wersja serwera NetWorker i platforma systemu operacyjnego?
- Czy oprogramowanie NWUI jest zainstalowane na serwerze NetWorker lub na oddzielnym hoście?
- Jaka jest wersja NWUI, jeśli jest zainstalowana na hoście oddzielonym od serwera NetWorker?
- Jaki pakiet Java jest zainstalowany na serwerze NWUI; jest zainstalowanym środowiskiem NetWorker Runtime Environment (NRE) lub Oracle Java Runtime Environment (JRE).
Uwierzytelnianie
Uwierzytelnianie używa AuthC w taki sam sposób, jak NetWorker Management Console i polecenie
nsrlogin . W przypadku problemów z uwierzytelnianiem należy rozpocząć od przetestowania uwierzytelniania na samym serwerze NetWorker w celu oddzielenia, czy problem z uwierzytelnianiem jest związany z NWUI, czy nie. W przypadku korzystania 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 metody 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
Problemy z instalacją
Problemy po stronie przeglądarki
Jeśli zainstalowano wiele przeglądarek, przetestuj zaobserwowany problem w różnych przeglądarkach, aby sprawdzić, czy problem dotyczy konkretnej przeglądarki.
W przeglądarce należy kliknąć prawym przyciskiem myszy i sprawdzić, aby wyświetlić wywołania interfejsu REST API, które są wykonywane z przeglądarki, a także instrukcje dziennika i informacje o połączeniu sieciowym.
- Kliknij prawym przyciskiem myszy dowolne miejsce w oknie przeglądarki i wybierz opcję "sprawdź"
- Zostanie otwarte nowe okno z kilkoma kartami. Karty Console (Konsola) i Network (Sieć) będą prawdopodobnie najbardziej przydatne.
- Korzystając z tych kart, można zobaczyć dokładne wywołania interfejsu REST API, które są wykonywane na serwerze NetWorker.
- Na karcie Sieć można również zobaczyć metodę żądania i odpowiedź interfejsu REST API serwera NetWorker. W ten sposób można dokładnie sprawdzić, czego żąda serwer NetWorker i jak serwer NetWorker odpowiada na to żądanie.
Problemy z zapleczem interfejsu użytkownika
Ważne dzienniki zaplecza interfejsu użytkownika to:
catalina.log — rejestrowanie rejestrowania serwerów Tomcat i rejestrowania wdrożeń aplikacji.
nwui.log – rejestrowanie serwera aplikacji NWUI.
restapi.log – rejestrowanie interfejsu REST API NetWorker. INTERFEJS NWUI komunikuje się z serwerem NetWorker przy użyciu interfejsu NETWorker REST API.
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 jest lokalna dla serwera NetWorker, czy zdalnie. Jeśli interfejs NWUI znajduje się na serwerze NetWorker, współdzieli to samo wystąpienie tomcat z NetWorker.
Jeśli dostarczasz plik dziennika .raw do obsługi, zaleca się renderowanie pliku dziennika w systemie, z którego pochodzi. Zapewnia to renderowanie sygniatur czasowych w czasie lokalnym serwera:
NetWorker: Korzystanie z nsr_render_log
Pliki dziennika
Linux:
Procesy uruchomione dla zaplecza interfejsu użytkownika to: /opt/nwui/bin/nwuictld i jsvc.exec Możesz sprawdzić, czy są uruchomione przy użyciu polecenia ps:
Dzienniki znajdują się tutaj:
lokalnie do serwera NetWorker:
- /opt/nwui/dzienniki
- /nsr/authc/dzienniki/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
Tryb zdalny:
- /opt/nwui/dzienniki
- /nsr/nwui/dzienniki
Windows
Proces zaplecza NWUI systemu Windows, który musi być uruchomiony, nosi nazwę nwuictld.exe:
Zarządzanie tym można uzyskać z witryny services.msc:
Dzienniki znajdują się tutaj:
lokalnie do 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
Tryb zdalny:
- C:\Program Files\EMC NetWorker\nwui\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
Serwer NetWorker
Uruchom narzędzie nsrget na serwerze NetWorker, aby zebrać odpowiednie dzienniki:
Networker: Korzystanie z narzędzia do gromadzenia
danych NSRGet NetWorkerNajbardziej odpowiednie dzienniki zależą od wykonywanej operacji z NWUI. Aby uzyskać więcej informacji na temat dzienników NetWorker, zobacz:
Networker: Pliki dziennika i lokalizacje
Debugowanie
Aby debugować komunikację interfejsu REST API, zmień poziom debugowania w pliku logback.xml na serwerze NetWorker:
Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes
Usuń wykorzystanie wierszy dotyczących rejestrowania wywołań interfejsu API. Powoduje to, że poziom rejestrowania jest ustawiony na "trace" dla żądań i odpowiedzi interfejsu REST API.