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-Webbenutzeroberfläche (NetWorker Web User Interface, 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, bei dem es sich nicht um den NetWorker-Server handelt, installiert werden.


                  NWUI-Komponenten 


Es gibt vier wichtige Komponenten:
Diese Komponenten können sich auf demselben Host oder auf separaten Hosts befinden.
  • Web-Frontend:  Dies ist die in HTML5 und Angular Framework geschriebene Darstellungsschicht, die NutzerInnen die NetWorker-Vorgänge in einem Webbrowser anzeigt. Der Webbrowser ist mit den Backend-Prozessen der Benutzeroberfläche verbunden.
  • UI-Backend:  Die Backend-Anwendung ist im Spring Framework geschrieben.  Sie verwendet Java und Apache Tomcat. Die Kommunikation zwischen Frontend und Backend sowie zwischen Backend und dem 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-Backend zu empfangen und sie mit den Kernkomponenten des NetWorker-Servers zu verbinden. Der RabbitMQ-Nachrichtenbus des NetWorker-Servers wird ebenfalls 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 Zugangsdaten zu überprüfen. Nach der Überprüfung gibt AuthC ein zeitbasiertes, signiertes und verschlüsseltes Token aus. Die NetWorker-Komponenten verwenden dieses Token, um NutzerInnen zu verifizieren und einen angeforderten Vorgang zu autorisieren oder abzulehnen. Sie 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 Interaktionen mit Ressourcen ermöglicht, die durch URI-Adressen (Uniform Resource Identifier) identifiziert werden. Sie verwendet HTTP-Verben (HEAD, GET, PUT, POST, DELETE), um mit den Uniform Resource Identifiers (URI) statuslos zu interagieren. Diese REST-API-Aufrufe erfolgen für NetWorker- und NWUI-Vorgänge intern.

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 REST-API-Entwicklerhandbuch für NetWorker dokumentiert ist.

Troubleshooting

Definieren des Problems

PROBLEMDETAILS
Um eine vollständige Problembeschreibung zu erstellen, sollten Sie die folgenden Fragen berücksichtigen:
  • Welcher Vorgang wird versucht und funktioniert nicht?
  • Funktioniert dieser Vorgang, wenn er außerhalb der NWUI initiiert wird (z. B.: über die NetWorker Management Console (NMC))?
  • Ist das Problem dauerhaft oder vorübergehend?
  • Gibt es bei vorübergehendem Auftreten einen bekannten Auslöser?
  • Hat der Vorgang vorher besser funktioniert und wenn ja, gibt es bekannte Änderungen, die vor und nach dem Auftreten des Problems durchgeführt wurden?
  • Wann ist das Problem zum ersten Mal aufgetreten (und was hat sich seitdem geändert)?
  • Tritt das Problem nur bei hoher Auslastung der Backupumgebung auf?
  • Wie ist der Problemumfang (alle Recovery-Vorgänge oder nur bestimmte, einige Registerkarten funktionieren nicht, während andere nicht betroffen sind)?
  • Was wurde bisher für die Problemlösung versucht und welche Schlüsse wurden daraus gezogen?

UMGEBUNGSDETAILS
  • Wie lautet die NetWorker-Serverversion und die Betriebssystemplattform?
  • Ist die NWUI auf dem NetWorker-Server oder auf einem separaten Host installiert?
    • Wie lautet die NWUI-Version, falls sie auf einem vom NetWorker-Server getrennten Host installiert ist?
  • Welches Java-Paket ist auf dem NWUI-Server installiert? Ist die NetWorker Runtime Environment (NRE) oder Oracle Java Runtime Environment (JRE) installiert?
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, um festzustellen, ob das Problem mit der NWUI oder dem Server selbst zusammenhängt. Wenn Sie für die Authentifizierung AD oder LDAP verwenden, testen Sie zunächst mit lokalen NetWorker-Konten, um zu überprüfen, ob das Problem nur die externe Authentifizierung betrifft.

Ein typischer Befehl zum Testen, 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 der Authentifizierung und zum Zurücksetzen eines Kennworts, sofern erforderlich.

Wenn weitere Authentifizierungsdiagnosen erforderlich sind, siehe:  NetWorker: Aktivieren von AUTHC DEBUG zu Fehlerbehebungszwecken

Installationsprobleme
Weitere Informationen zur Installation der NWUI und zu den Protokollen, die bei Installationsproblemen überprüft werden sollten, finden Sie im Artikel:
NetWorker Management Web UI (NWUI): Anleitung zur Installation                   

 

Probleme mit dem UI-Backend

Zu den wichtigsten UI-Backend-Protokollen gehören:
Linux-Pfad Windows-Pfad (Standardeinstellung) Funktion
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Protokollierung für Tomcat-Server und Anwendungsbereitstellung
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Protokollierung für NWUI-Anwendungsserver
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log Protokollierung für NetWorker-REST-API. Die NWUI kommuniziert mit dem NetWorker-Server über die NetWorker-REST-API. Im Abschnitt zur REST API in diesem Artikel erfahren Sie, wie Sie herausfinden, welche REST-API-Funktionen verwendet werden. Außerdem werden die entsprechenden Antworten angezeigt.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Protokollierung für den NetWorker-Server

Wenn sich der NWUI-Server auf dem NetWorker-Server selbst befindet, nutzt er dieselbe Tomcat-Instanz wie NetWorker.
Wenn Sie eine .raw -Protokolldatei für den Support bereitstellen, sollten Sie die Protokolldatei auf dem System 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 ps -Befehl überprüfen, ob sie ausgeführt werden: 
ps -ef | grep nwui
                  PS-Ausgabe für NWUI-Backend 
Die Protokolle befinden sich an folgenden Speicherorten:

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 für den NetWorker-Server lokal oder remote 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 das Bundle automatisch mit dem Hostnamen des Servers und dem aktuellen Datum (JJJJ-MM-TT) erstellt.
Windows

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


                  Taskliste mit NWUI-Service 

Sie können dies über services.mscverwalten:

                  Servicekonsole mit NWUI 
 

Die Protokolle befinden sich an folgenden Speicherorten:

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 die standardmäßigen NetWorker-Installationspfade. Passen Sie die Einstellungen entsprechend an, wenn NetWorker auf einem anderen Laufwerk installiert wurde oder einen anderen Pfad verwendet.
 
NetWorker-Server

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

Welche Protokolle relevant sind, hängt 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 in der Datei logback.xml auf dem NetWorker-Server die Debug-Ebene:

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


                  Logback-Datei 

Heben Sie die Kommentierung der Zeilen für die Protokollierung der API-Aufrufe auf. Dadurch wird die Protokollierungsebene für die REST-API-Anforderungen und -Antworten auf „trace“ festgelegt.

                  Debug-Einstellungen 

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

 

REST-API

Die NWUI verwendet die REST API als Schnittstelle zu NetWorker. Die NWUI- und REST-API-Protokolle zeigen die 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 nach dem Zugriff auf die NWUI mit der rechten Maustaste in das Browserfenster und wählen Sie Überprüfen aus.

Überprüfen

  1. Klicken Sie im Browserfenster „Überprüfen“ auf die Registerkarte Netzwerk:

Browser-Überprüfung-Netzwerk

  1. Beim Ausführen von Funktionen in der 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 Funktion Backups klicken, werden auf der Registerkarte Kopfzeilen die folgenden Details angezeigt:

Hier sind die Anfrage-URL, die Anfragemethode und der Statuscode enthalten.

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

 

Dieses Beispiel zeigt die REST-API-Antwort, die auf der Registerkarte Wiederherstellen und Savesets angezeigt wird, nachdem Azure-Backups durchsucht und ein Saveset für die Wiederherstellung ausgewählt wurde.

Weitere Informationen

Ressourcen zur NWUI

NetWorker Management Web UI (NWUI):  Verwendung             
NetWorker Management Web UI (NWUI):  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.