NetWorker Management Web UI (NWUI): guida alla valutazione e alla risoluzione dei problemi

Summary: NetWorker Management Web UI (NWUI): guida alla valutazione e alla risoluzione dei problemi

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

Come funziona NWUI

L'interfaccia utente web di NetWorker (NWUI) utilizza le seguenti tecnologie: HTML5, Apache Tomcat, Spring Framework, Angular Framework e API (Application Programming Interface) REST (Representational State Transfer). L'applicazione NWUI può essere installata sui sistemi operativi Linux o Windows. Può essere installato direttamente sul server NetWorker o su un host che non è il server NetWorker.


                  Componenti di NWUI 


Ci sono quattro componenti importanti:
Questi componenti possono trovarsi sullo stesso host o su host diversi.
  • Frontend web:  Si tratta del livello di presentazione, scritto in HTML5 e Angular Framework, che presenta le operazioni di NetWorker all'utente tramite un web browser. Il web browser è connesso ai processi back-end dell'interfaccia utente.
  • Back-end interfaccia utente:  L'applicazione back-end è scritta in Spring Framework.  Utilizza Java e Apache Tomcat. La comunicazione tra front-end e back-end e tra back-end e server NetWorker avviene tramite chiamate API REST interne. Il processo NWUI utilizza l'istanza di Apache Tomcat esistente sul server NetWorker o installa la propria istanza di Apache Tomcat se installata in remoto dal server NetWorker.
  • Server NetWorker: Il framework REST del server NetWorker è responsabile della ricezione delle chiamate API REST dal back-end dell'interfaccia utente e della connessione ai componenti core del server NetWorker. Il bus di messaggi RabbitMQ del server NetWorker viene usato anche per l'interazione con nsrjobd.
  • AUTHC: Il componente AUTHC di NetWorker viene utilizzato per tutte le esigenze di autenticazione. Il processo di richiesta contatta AuthC per verificare le credenziali; al momento della verifica, AuthC emette un token a tempo, basato sulla firma e crittografato. I componenti di NetWorker utilizzano questo token per verificare l'utente e autorizzare o meno un'operazione richiesta. In genere si trova sul server NetWorker, ma può essere installato su un host separato. 
La maggior parte delle comunicazioni avviene tramite API REST che consente l'interazione con le risorse identificate da indirizzi URI (Uniform Resource Identifier). Utilizza verbi HTTP (HEAD, GET, PUT, POST, DELETE) per interagire con gli URI (Uniform Resource Identifier) in modo senza stato. Queste chiamate API REST sono interne alle operazioni di NetWorker e NWUI.

a { text-decoration: nessuna; colore: #464feb; } tr th, tr td { confine: 1px #e6e6e6 solido; } tr th { colore di sfondo: #f5f5f5; } Da non confondere con NetWorker REST API, che consente operazioni personalizzate ed è documentata nella NetWorker REST API Developer Guide.

Risoluzione dei problemi

Definizione del problema

DETTAGLI DEL
PROBLEMAPer generare una descrizione completa del problema, considerare le seguenti domande:
  • Quale operazione si sta tentando che non funziona?
  • Questa operazione funziona quando viene avviata dall'esterno di NWUI (ad esempio: Da NetWorker Management Console (NMC))?
  • Il problema persiste o è intermittente?
  • Se intermittente, c'è un fattore scatenante noto?
  • Ha funzionato meglio prima e, in caso affermativo, sono state apportate modifiche note prima e dopo la comparsa del problema?
  • Quando si è verificato per la prima volta il problema (e cosa è cambiato da quando è comparso)?
  • Il problema si verifica solo nei momenti di carico intenso sull'ambiente di backup?
  • Qual è l'ambito del problema (tutte le operazioni di ripristino o alcune operazioni di ripristino, alcune schede non funzionano mentre altre non sono interessate)?
  • Che cosa si è cercato di risolvere finora e quali conclusioni se ne sono tratte?

DETTAGLI DELL'AMBIENTE
  • Quali sono la versione del server NetWorker e la piattaforma del sistema operativo?
  • NWUI è installato sul server NetWorker o su un host separato?
    • Qual è la versione di NWUI se installata su un host separato dal server NetWorker?
  • Quale pacchetto Java è installato sul server NWUI; è installato NetWorker Runtime Environment (NRE) o Oracle Java Runtime Environment (JRE).
Authentication
L'autenticazione utilizza AUTHC nello stesso modo di NetWorker Management Console e di nsrlogin . Per i problemi di autenticazione, testare prima l'autenticazione sul server NetWorker per determinare se il problema è correlato a NWUI o al server stesso. Se si utilizza AD o LDAP per l'autenticazione, testare prima con gli account NetWorker locali per verificare se il problema riguarda solo l'autenticazione esterna.

Un comando tipico utilizzato per verificare se il processo di autenticazione funziona come previsto sul server NetWorker è:  
authc_mgmt -u [user name] -p [password] -e find-all-users.

Oppure:

Account NetWorker locale:

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Account esterno (AD/LDAP):
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
La Guida alla configurazione della sicurezza di NetWorker contiene dettagli completi sul funzionamento dell'autenticazione di NetWorker, su come testarla e su come reimpostare una password, se necessario.

Se è necessaria un'ulteriore diagnosi dell'autenticazione, consultare:  NetWorker: Come abilitare AUTHC DEBUG per la risoluzione dei problemi

Problemi di installazione
Per informazioni dettagliate su come installare NWUI e sui registri da consultare in caso di problemi con l'installazione, consultare il seguente articolo:
NetWorker Management Web UI (NWUI): Come installare                   

 

Problemi di back-end dell'interfaccia utente

I registri importanti del back-end dell'interfaccia utente sono:
Percorso Linux Windows Path (impostazione predefinita) Funzione
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Registrazione del server Tomcat e registrazione del deployment delle applicazioni.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Registrazione del server delle applicazioni NWUI.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log Registrazione dell'API REST di NetWorker. NWUI comunica con il server NetWorker tramite l'API REST di NetWorker. Vedere la sezione API REST in questo articolo per informazioni su come diagnosticare le funzioni API REST utilizzate, insieme alla risposta corrispondente.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Registrazione del server NetWorker.

Se il server NWUI si trova sul server NetWorker stesso, condivide la stessa istanza Tomcat con NetWorker.
Se si sta fornendo un .raw file di registro per supportare, si consiglia di eseguire il rendering del file di registro sul sistema da cui ha origine. In questo modo si garantisce che il rendering dei timestamp venga eseguito nell'ora locale del server: NetWorker: Come usare nsr_render_log

File di registro

Linux:

I processi eseguiti per il back-end dell'interfaccia utente sono:  /opt/nwui/bin/nwuictld jsvc.exec È possibile verificare se sono in esecuzione con il comando ps :
ps -ef | grep nwui
                  Output ps che mostra il back-end NWUI 
I log si trovano qui:

Locale sul server NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
Remoto (il server NWUI si trova su un host separato dal server NetWorker):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
Per creare un file ZIP di questi registri è possibile utilizzare il seguente comando:
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
NOTA: A seconda che NWUI sia locale o remoto rispetto al server NetWorker, il comando precedente potrebbe segnalare alcune directory come mancanti. In tal caso, è normale che il ciclo di apprendimento venga eseguito. Il nome host e la data non devono essere modificati, il comando precedente crea automaticamente il pacchetto con il nome host del server e la data corrente (AAAA-MM-GG).
Finestre

Il processo back-end NWUI di Windows che deve essere in esecuzione è denominato nwuictld.exe:


                  Elenco delle attività che mostra il servizio NWUI 

Puoi gestire tutto questo da services.msc:

                  console dei servizi che mostra NWUI 
 

I log si trovano qui:

locali al server NetWorker
  • 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\
Remoto: 
  • 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
NOTA: I percorsi mostrati sono il percorso di installazione predefinito di NetWorker. Se NetWorker è stato installato su un'altra unità o utilizzando un percorso diverso, regolare le modifiche di conseguenza.
 
Server NetWorker

Eseguire lo strumento nsrget sul server NetWorker per raccogliere i log pertinenti:
Networker: Come utilizzare lo strumento

di data collection NSRGet NetWorkerI log più rilevanti dipendono dall'operazione tentata da NWUI. Per ulteriori informazioni sui registri di NetWorker, consultare:
Networker: file e posizioni dei registri

Debug

Per eseguire il debug della comunicazione API REST, modificare il livello di debug in logback.xml sul server NetWorker:

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


                  File di logback 

Rimuovere i commenti dalle righe relative alla registrazione delle chiamate API. In questo modo, il livello di registrazione viene impostato su "traccia" per le richieste e le risposte API REST.

                  Impostazioni di debug 

Vedere: NetWorker: Come abilitare il debug API REST

 

API REST

NWUI utilizza l'API REST per interfacciarsi con NetWorker. I registri NWUI e API REST mostrano le funzioni API e le risposte di NetWorker, ma queste informazioni possono anche essere controllate direttamente nel browser. Questo metodo è utile per individuare discrepanze tra le interfacce utente e la CLI di NetWorker o quando l'interfaccia utente non restituisce i risultati previsti. 

 

  1. Durante l'accesso a NWUI, cliccare con il pulsante destro del mouse nella finestra del browser e selezionare Inspect.

Ispezionare

  1. Nella finestra "Inspect" del browser, fare clic sulla scheda Network :

Browser Inspect Network

  1. Quando si eseguono funzioni in NWUI, le operazioni vengono visualizzate in Name. La colonna Status include lo stato di completamento dell'API REST: Richiesta e risposta API 
  2. Cliccare sull'operazione che si desidera analizzare ulteriormente. Ad esempio, cliccando sulla funzione di backup mostrata sopra, nella scheda Headers vengono visualizzati i seguenti dettagli:

Da questo, l'URL della richiesta, il metodo di richiesta e il codice di stato sono tutti identificabili.

  1. Per visualizzare il payload di risposta, fai clic sulla scheda Risposte .

 

Questo esempio mostra la risposta API REST usata per popolare la scheda Recover and Savesets dopo aver esplorato i backup di Azure e aver selezionato un saveset per il ripristino.

Additional Information

Affected Products

NetWorker

Products

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