NetWorker Management Web UI (NWUI): Leitfaden für Selektierung und Troubleshooting

Summary: NetWorker Management Web UI (NWUI): Leitfaden für Selektierung und Troubleshooting

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

Funktionsweise der NWUI

Die NetWorker-Webnutzeroberfläche (NWUI) verwendet die folgenden Technologien: HTML5, Apache Tomcat, Spring Framework, Angular Framework und REST (Representational State Transfer) Application Programming Interface (API). Die NWUI-Anwendung kann auf Linux- oder Windows-Betriebssystemen installiert werden. Sie kann entweder direkt auf dem NetWorker-Server oder auf einem Host installiert werden, bei dem es sich nicht um den NetWorker-Server handelt.


                  kA5f10000004LFmCAM_1_0


Es gibt vier wichtige Komponenten:
Diese Komponenten können sich auf demselben Host oder auf separaten Hosts befinden.
  • Web-Front-end:  Dies ist die in HTML5 und Angular Framework geschriebene Darstellungsschicht, die dem Nutzer NetWorker-Vorgänge über einen Webbrowser präsentiert. Der Webbrowser ist mit den Backend-Prozessen der Benutzeroberfläche verbunden.
  • UI-Back-end:  Die Backend-Anwendung ist im Spring Framework geschrieben.  Es verwendet Java und Apache Tomcat. Die Kommunikation zwischen Front-end und Back-end sowie zwischen Back-end und NetWorker-Server erfolgt über interne REST API-Aufrufe. Der NWUI-Prozess verwendet entweder die vorhandene Apache Tomcat-Instanz auf dem NetWorker-Server oder installiert eine eigene Apache Tomcat-Instanz, wenn sie remote vom NetWorker-Server installiert wird.
  • NetWorker-Server: Das REST-Framework des NetWorker-Servers ist dafür verantwortlich, die REST-API-Aufrufe vom UI-Back-end zu empfangen und sie mit den Kernkomponenten des NetWorker-Servers zu verbinden. Der RabbitMQ-Nachrichtenbus des NetWorker-Servers wird auch für die Interaktion mit nsrjobd verwendet.
  • AuthC: Die authc-Komponente von NetWorker wird für alle Authentifizierungsanforderungen verwendet. Der anfordernde Prozess kontaktiert AuthC, um die Anmeldeinformationen zu überprüfen. Nach der Überprüfung gibt AuthC ein zeitbasiertes, signiertes und verschlüsseltes Token aus. NetWorker-Komponenten verwenden dieses Token, um den Nutzer zu überprüfen und einen angeforderten Vorgang zu autorisieren oder nicht. Dies befindet sich in der Regel auf dem NetWorker-Server, kann aber auch auf einem separaten Host installiert werden. 
Der Großteil der Kommunikation erfolgt über die REST API, die die Interaktion mit Ressourcen ermöglicht, die durch URI-Adressen (Uniform Resource Identifier) identifiziert werden. Es verwendet HTTP-Verben (HEAD, GET, PUT, POST, DELETE), um zustandslos mit den Uniform Resource Identifiers (URI) zu interagieren. Diese REST API-Aufrufe sind intern für NetWorker- und NWUI-Vorgänge. Sie sind nicht zu verwechseln mit der NetWorker REST API-Schnittstelle, die programmatischen Zugriff auf NetWorker zum Programmieren nutzerdefinierter Vorgänge bietet, die im NetWorker REST API-Entwicklerhandbuch beschrieben ist.
 

Troubleshooting

Definieren des Problems

DETAILS
ZUM PROBLEMUm eine vollständige Problembeschreibung zu erstellen, sollten Sie die folgenden Fragen berücksichtigen:
  • Welcher Vorgang wird versucht, der nicht funktioniert?
  • Funktioniert dieser Vorgang, wenn er von außerhalb der NWUI initiiert wird (z. B.: Über die NetWorker Management Console (NMC)?
  • Ist das Problem beständig oder periodisch?
  • Gibt es einen bekannten Auslöser, wenn es zeitweilig auftritt?
  • Hat das vorher besser funktioniert und wenn ja, gibt es bekannte Änderungen, die vor und nach dem Auftreten des Problems angewendet wurden?
  • Wann trat das Problem zum ersten Mal auf (und was hat sich seitdem geändert)?
  • Tritt das Problem nur bei hoher Auslastung der Backupumgebung auf?
  • Was ist der Umfang des Problems (alle Recovery-Vorgänge/einige Recovery-Vorgänge, einige Registerkarten funktionieren nicht, während andere nicht betroffen sind)?
  • Was wurde bisher versucht zu beheben und welche Schlüsse wurden daraus gezogen?

UMGEBUNGSDETAILS
  • Was ist die NetWorker-Serverversion und Betriebssystemplattform?
  • Ist die NWUI auf dem NetWorker-Server oder auf einem separaten Host installiert?
    • Was ist die NWUI-Version, wenn sie auf einem vom NetWorker-Server getrennten Host installiert ist?
  • Welches Java-Paket ist auf dem NWUI-Server installiert? NetWorker Runtime Environment (NRE) oder Oracle Java Runtime Environment (JRE) installiert ist.
Authentifizierung
Die Authentifizierung verwendet AuthC auf die gleiche Weise wie die NetWorker Management Console und der Befehl nsrlogin . Testen Sie bei Authentifizierungsproblemen zunächst die Authentifizierung auf dem NetWorker-Server selbst, um festzustellen, ob das Authentifizierungsproblem mit der NWUI zusammenhängt oder nicht. Wenn Sie eine externe Authentifizierungsmethode wie AD oder LDAP verwenden, wird empfohlen, zunächst die Authentifizierung mit lokalen NetWorker-Konten zu testen, um festzustellen, ob sich das Problem nur auf die externe Authentifizierungsmethode auswirkt.

Ein typischer Befehl, mit dem getestet wird, ob der Authentifizierungsprozess auf dem NetWorker-Server wie erwartet funktioniert, lautet:   
authc_mgmt -u [user name] -p [password] -e find-all-users.

Oder:

Lokales NetWorker-Konto:

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Externes Konto (AD/LDAP): 
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
Der NetWorker-Sicherheitskonfigurationsleitfaden enthält alle Details zur Funktionsweise der NetWorker-Authentifizierung, zum Testen und zum Zurücksetzen eines Kennworts, falls erforderlich.

Wenn eine weitere Authentifizierungsdiagnose erforderlich ist, siehe:  NetWorker: So aktivieren Sie AUTHC DEBUG zu Troubleshooting-Zwecken

Installationsprobleme
Weitere Informationen zur Installation der NWUI und zum Abfragen der Protokolle bei Problemen mit der Installation finden Sie im folgenden Artikel:
NetWorker Management Web UI (NWUI): Anleitung zur Installation
 
Browserseitige Probleme
Wenn mehrere Browser installiert sind, testen Sie das beobachtete Problem in verschiedenen Browsern, um festzustellen, ob das Problem spezifisch für einen Browser ist.

Klicken Sie im Browser mit der rechten Maustaste auf "inspect", um die REST API-Aufrufe anzuzeigen, die vom Browser durchgeführt werden, sowie Protokollanweisungen und Netzwerkverbindungsinformationen.
  • Klicken Sie mit der rechten Maustaste auf eine beliebige Stelle im Browserfenster und wählen Sie "Prüfen" aus.
  • Es öffnet sich ein neues Fenster mit mehreren Tabs.  Die Registerkarten "Konsole" und "Netzwerk" sind wahrscheinlich am nützlichsten.
  • Auf diesen Registerkarten können wir die genauen REST API-Aufrufe sehen, die an den NetWorker-Server gehen. 
  • Auf der Registerkarte "Network" werden außerdem die Anforderungsmethode und die REST API-Antwort vom NetWorker-Server angezeigt. Auf diese Weise können wir genau nachvollziehen, was vom NetWorker-Server angefordert wird und wie der NetWorker-Server auf diese Anforderung reagiert.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Probleme mit dem UI-Backend

Die wichtigsten UI-Back-end-Protokolle sind:
    catalina.log – Protokollierung von Tomcat-Servern und Anwendungsbereitstellungen.
    nwui.log – Protokollierung des NWUI-Anwendungsservers.
    restapi.log – NetWorker-REST-API-Protokollierung.  Die NWUI kommuniziert mit dem NetWorker-Server über die NetWorker REST API.
    daemon.raw – NetWorker-Serverprotokollierung.

Der Speicherort dieser Protokolldateien hängt vom verwendeten Betriebssystem ab und davon, ob die Installation der NWUI lokal auf dem NetWorker-Server oder remote erfolgt.  Wenn sich die NWUI auf dem NetWorker-Server selbst befindet, nutzt sie dieselbe Tomcat-Instanz wie NetWorker.
Wenn Sie dem Support eine .raw Protokolldatei zur Verfügung stellen, wird empfohlen, die Protokolldatei auf dem System zu rendern, von dem sie stammt. Dadurch wird sichergestellt, dass die Zeitstempel in der lokalen Zeit des Servers gerendert werden: NetWorker: Verwendung von nsr_render_log

Protokolldateien

Linux:

Die Prozesse, die für das UI-Backend ausgeführt werden, sind:  /opt/nwui/bin/nwuictld und jsvc.exec Sie können mit dem Befehl ps überprüfen, ob sie ausgeführt werden: 
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
Die Protokolle befinden sich hier:

Lokal auf dem NetWorker-Server:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
Remote:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Fenster

Der Windows-NWUI-Back-end-Prozess, der ausgeführt werden muss, heißt nwuictld.exe:


                  kA5f10000004LFmCAM_1_5

Sie können dies über services.msc verwalten:

                  kA5f10000004LFmCAM_1_6
 

Die Protokolle befinden sich hier:

Lokal auf dem NetWorker-Server:
  • C:ProgrammeEMC NetWorker-Wuilogs
  • C:ProgrammeEMC NetWorker srauthc-serverlogs
  • C:ProgrammeEMC NetWorker SR estapi estapi.log
  • C:ProgrammeEMC NetWorker srlogsdaemon.raw
Remote: 
  • C:ProgrammeEMC NetWorker-Wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ZEITSTEMPEL].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ZEITSTEMPEL]_0_MCUI.log
NetWorker-Server

Führen Sie das nsrget-Tool auf dem NetWorker-Server aus, um die relevanten Protokolle zu erfassen:
NetWorker: Verwendung des NSRGet NetWorker-Datenerhebungstools

Die relevantesten Protokolle hängen vom Vorgang ab, der über die NWUI versucht wird. Weitere Informationen zu NetWorker-Protokollen finden Sie unter:
NetWorker: Protokolldateien und Speicherorte

Debugging

Um die REST API-Kommunikation zu debuggen, ändern Sie das Debug-Level in der logback.xml Datei auf dem NetWorker-Server:

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


                  kA5f10000004LFmCAM_1_7

Kommentieren Sie die Zeilen aus, die sich mit der Protokollierung von API-Aufrufen befassen. Dies führt dazu, dass die Protokollierungsebene für die REST API-Anforderungen und -Antworten auf "trace" festgelegt wird.

                  kA5f10000004LFmCAM_1_8

Additional Information

NWUI-Ressourcen


521712 : NetWorker Management Web UI (NWUI):  Wie benutzt man             
522859 : NetWorker Management Web UI (NWUI):  Anleitung zur Installation          
522949 :   
522959:  NetWorker Management Web UI (NWUI): Leitfaden für Selektierung und Troubleshooting

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.