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.
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
Installationsprobleme
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.
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:
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:
Sie können dies über services.msc managen:
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
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](https://supportkb.dell.com/img/ka06P000000kKqoQAE/ka06P000000kKqoQAE_de_8.jpeg)