Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products

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

Summary: NetWorker Management Web UI (NWUI): Selektierungs- und Fehlerbehebungshandbuch

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

Funktionsweise der NWUI

Die NetWorker Web User Interface (NWUI) verwendet die folgenden Technologien: HTML5, Apache Tomcat, Spring Framework, Programming Framework und Representational State Transfer (REST) 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, der nicht der NetWorker-Server ist.

                  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 Präsentationsebene, die in HTML5 und Dem Framework geschrieben wurde, die NetWorker-Vorgänge über einen Webbrowser für den Benutzer darstellt. Der Webbrowser ist mit den Back-end-Prozessen der Benutzeroberfläche verbunden.
  • Back-end der Benutzeroberfläche:  Die Back-end-Anwendung wird im Spring Framework geschrieben.  Es verwendet Java und Apache Tomcat. Die Kommunikation zwischen front-end und back-end und zwischen dem Back-end 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 Back-end der Benutzeroberfläche 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 Anmeldedaten zu überprüfen. nach der Überprüfung gibt AuthC ein zeitbasiertes, signiertes und verschlüsseltes Token aus. NetWorker-Komponenten verwenden dieses Token, um den Benutzer zu überprüfen und einen angeforderten Vorgang zu autorisieren oder nicht. Dies befindet sich in der Regel auf dem NetWorker-Server, kann aber 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 statuslos mit den Uniform Resource Identifiers (URI) zu interagieren. Diese REST-API-Aufrufe sind in NetWorker- und NWUI-Vorgängen enthalten. Sie dürfen nicht mit der NetWorker REST API-Schnittstelle verwechselt werden, die programmatischen Zugriff auf NetWorker für die Programmierung von benutzerdefinierten Vorgängen bietet, die im NetWorker REST API Developer Guide beschrieben werden.
 

Troubleshooting

Definieren des Problems

PROBLEMDETAILS
Um eine vollständige Problembeschreibung zu erzeugen, berücksichtigen Sie die folgenden Fragen:
  • 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 konsistent oder zeitweilig?
  • Wenn gelegentlich, gibt es einen bekannten Auslöser?
  • Hat dies früher besser funktioniert, und wenn ja, gibt es bekannte Änderungen, die vor und nach auftreten des Problems angewendet wurden?
  • Wann trat das Problem erstmals auf (und was hat sich seit dem Auftreten des Problems geändert)?
  • Tritt das Problem nur in Zeiten hoher Belastung in 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 korrigieren und welche Schlussfolgerungen wurden daraus gezogen?

UMGEBUNGSDETAILS
  • Was ist die NetWorker-Serverversion und Betriebssystemplattform?
  • Ist NWUI auf dem NetWorker-Server oder einem separaten Host installiert?
    • Was ist die NWUI-Version, wenn sie auf einem Host installiert ist, der vom NetWorker-Server getrennt ist?
  • Welches Java-Paket ist auf dem NWUI-Server installiert? ist NetWorker Runtime Environment (NRE) installiert oder Oracle Java Runtime Environment (JRE).
Authentifizierung
Die Authentifizierung verwendet AuthC auf die gleiche Weise wie die NetWorker Management Console und den Befehl nsrlogin . Bei Authentifizierungsproblemen testen Sie zunächst die Authentifizierung auf dem NetWorker-Server selbst, um zu trennen, 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, ist:  
authc_mgmt -u [user name] -p [password] -e find-all-users.

Oder:

Lokales NetWorker-Konto:

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

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

Installationsprobleme
Weitere Informationen zur Installation der NWUI und zu den zu konsultierenden Protokollen 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.

Verwenden Sie im Browser mit der rechten Maustaste und "untersuchen", um die REST-API-Aufrufe, die über den Browser erfolgen, sowie Protokollanweisungen und Netzwerkverbindungsinformationen anzuzeigen.
  • Klicken Sie mit der rechten Maustaste auf eine beliebige Stelle im Browserfenster und wählen Sie "untersuchen" aus.
  • Ein neues Fenster wird mit mehreren Registerkarten geöffnet.  Die Registerkarten "Konsole" und "Netzwerk" sind wahrscheinlich die nützlichsten.
  • Auf diesen Registerkarten sehen wir die genauen REST API-Aufrufe, die an den NetWorker-Server vorgenommen werden. 
  • Auf der Registerkarte "Network" (Netzwerk) sehen wir auch die Anforderungsmethode und die REST API-Antwort vom NetWorker-Server. Auf diese Weise können wir genau nachverfolgen, was vom NetWorker-Server angefordert wird und wie der NetWorker-Server auf diese Anforderung reagiert.
                   kA5f10000004LFmCAM_1_1
                   kA5f10000004LFmCAM_1_2
 
Back-end-Probleme der Benutzeroberfläche

Die wichtigsten Back-end-Protokolle der Benutzeroberfläche sind:
    catalina.log : Tomcat-Serverprotokollierung und Anwendungsbereitstellungsprotokollierung.
    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 und davon ab, ob die Installation der NWUI lokal auf dem NetWorker-Server oder remote erfolgt.  Wenn sich die NWUI auf dem NetWorker-Server selbst befindet, wird dieselbe Tomcat-Instanz mit NetWorker gemeinsam verwendet.
Wenn Sie eine .raw Protokolldatei zur Unterstützung bereitstellen, wird empfohlen, die Protokolldatei auf dem System zu rendern, von dem sie stammt. Dadurch wird sichergestellt, dass die Zeitstempel in der lokalen Uhrzeit des Servers dargestellt werden: NetWorker: Verwendung von nsr_render_log

Protokolldateien

Linux:

Die Prozesse, die für das Ui-Back-end ausgeführt werden, sind:  /opt/nwui/bin/nwuictld und jsvc.exec Sie können überprüfen, ob sie mit dem befehl ps ausgeführt werden:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
Die Protokolle sind 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, wird als nwuictld.exe bezeichnet:

                  kA5f10000004LFmCAM_1_5
Sie können dies über services.msc managen:
                  kA5f10000004LFmCAM_1_6
 
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
Remote: 
  • 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
NetWorker-Server

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

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 Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes

                   kA5f10000004LFmCAM_1_7
Kommentieren Sie die Zeilen aus, die mit der API-Aufrufprotokollierung zu tun haben. Dies führt dazu, dass die Protokollierungsebene für die REST-API-Anforderungen und -Antworten auf "trace" festgelegt wird.
                   kA5f10000004LFmCAM_1_8

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 19 Jan 2024
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.