NetWorker Management Web UI (NWUI): Triage- und Fehlerbehebungshandbuch

Zusammenfassung: NetWorker Management Web UI (NWUI): Triage- und Fehlerbehebungshandbuch

Dieser Artikel gilt für Dieser Artikel gilt nicht für Dieser Artikel ist nicht an ein bestimmtes Produkt gebunden. In diesem Artikel werden nicht alle Produktversionen aufgeführt.
Andere Ressourcen ansehen

Weisungen

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.


                  Komponenten der NWUI 


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.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px Solid #e6e6e6; } tr th { background-color: #f5f5f5; } Verwechseln Sie diese nicht mit der NetWorker-REST-API, die nutzerdefinierte Vorgänge ermöglicht und im NetWorker-REST-API-Entwicklerhandbuch dokumentiert 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 oder 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 die nsrlogin . Testen Sie bei Authentifizierungsproblemen zunächst die Authentifizierung auf dem NetWorker-Server, um festzustellen, ob das Problem mit der NWUI oder dem Server selbst zusammenhängt. Wenn Sie AD oder LDAP für die Authentifizierung verwenden, testen Sie zunächst mit lokalen NetWorker-Konten, um zu bestätigen, ob sich das Problem nur auf die externe Authentifizierung 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                   

 

Probleme mit dem UI-Backend

Die wichtigsten UI-Back-end-Protokolle sind:
Linux-Pfad Windows-Pfad (Standardeinstellung) Funktion
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Protokollierung von Tomcat-Servern und Anwendungsbereitstellung.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Protokollierung des NWUI-Anwendungsservers.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log NetWorker-REST-API-Protokollierung. Die NWUI kommuniziert mit dem NetWorker-Server über die NetWorker REST API. Im Abschnitt REST API in diesem Artikel erfahren Sie, wie Sie diagnostizieren, welche REST API-Funktionen zusammen mit der entsprechenden Antwort verwendet werden.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw NetWorker-Serverprotokollierung.

Wenn sich der NWUI-Server auf dem NetWorker-Server selbst befindet, nutzt er dieselbe Tomcat-Instanz wie NetWorker.
Wenn Sie eine .raw Protokolldatei unterstützen, 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 überprüfen, ob sie mit dem ps Befehl durchgeführt: 
ps -ef | grep nwui
                  PS-Ausgabe mit NWUI-Back-End 
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
  • /nsr/nwui/monitoring/app/logs/
Remote (NWUI-Server befindet sich auf einem vom NetWorker-Server getrennten Host):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
Mit dem folgenden Befehl können Sie eine ZIP-Datei dieser Protokolle erstellen: 
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
HINWEIS: Je nachdem, ob die NWUI lokal oder remote für den NetWorker-Server ist, meldet der obige Befehl möglicherweise einige Verzeichnisse als fehlend. Dies ist zu erwarten. Der Hostname und das Datum müssen nicht geändert werden. Mit dem obigen Befehl wird automatisch das Bundle mit dem Hostnamen des Servers und dem aktuellen Datum (JJJJ-MM-TT) erstellt.
Fenster

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


                  Aufgabenliste mit NWUI-Service 

Sie können dies über services.mscaus:

                  Servicekonsole mit NWUI 
 

Die Protokolle sind hier:

Lokal auf dem NetWorker-Server
  • 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\
Remote: 
  • 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
HINWEIS: Die angezeigten Pfade sind der standardmäßige NetWorker-Installationspfad. Wenn NetWorker auf einem anderen Laufwerk installiert wurde oder einen anderen Pfad verwendet, passen Sie die Einstellungen entsprechend an.
 
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 im logback.xml Datei auf dem NetWorker-Server:

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


                  Logback-Datei 

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.

                  Debug-Einstellungen 

Siehe: NetWorker: So aktivieren Sie das REST-API-Debugging

 

REST-API

NWUI verwendet die REST API für die Schnittstelle zu NetWorker. NWUI- und REST API-Protokolle zeigen API-Funktionen und NetWorker-Antworten an, diese Informationen können aber auch direkt im Browser überprüft werden. Diese Methode ist nützlich, um Diskrepanzen zwischen Benutzeroberflächen und der NetWorker-CLI zu finden oder wenn die Benutzeroberfläche nicht die erwarteten Ergebnisse zurückgibt. 

 

  1. Klicken Sie beim Zugriff auf NWUI mit der rechten Maustaste in das Browserfenster und wählen Sie Überprüfen aus.

Überprüfen

  1. Klicken Sie im Browserfenster "Inspect" auf die Registerkarte Network :

Browser inspect network

  1. Beim Ausführen von Funktionen in NWUI werden die Vorgänge unter Name angezeigt. Die Spalte Status enthält den Abschlussstatus der REST API: API-Anfrage und -Antwort 
  2. Klicken Sie auf den Vorgang, den Sie weiter untersuchen möchten. Wenn Sie z. B. auf die oben gezeigte Backupfunktion klicken, werden auf der Registerkarte Kopfzeilen die folgenden Details angezeigt:

Daraus sind die Anforderungs-URL, die Anforderungsmethode und der Statuscode identifizierbar.

  1. Um die Antwort-Payload anzuzeigen, klicken Sie auf die Registerkarte Antworten .

 

Dieses Beispiel zeigt die REST API-Antwort, die zum Auffüllen der Registerkarte Recover und Savesets verwendet wird, nachdem Azure-Backups durchsucht und ein Saveset für die Wiederherstellung ausgewählt wurde.

Weitere Informationen

NWUI-Ressourcen

NetWorker Management Web UI (NWUI):  Wie benutzt man             
NetWorker Management Web UI (NWUI):  Anleitung zur Installation          
NetWorker Management Web UI (NWUI): Triage- und Fehlerbehebungshandbuch

Betroffene Produkte

NetWorker

Produkte

NetWorker, NetWorker Series
Artikeleigenschaften
Artikelnummer: 000010592
Artikeltyp: How To
Zuletzt geändert: 19 Dez. 2025
Version:  5
Antworten auf Ihre Fragen erhalten Sie von anderen Dell NutzerInnen
Support Services
Prüfen Sie, ob Ihr Gerät durch Support Services abgedeckt ist.