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.


                  kA5f10000004LFmCAM_1_0


Ci sono quattro componenti importanti:
Questi componenti possono trovarsi sullo stesso host o su host diversi.
  • Front-end 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. Non devono essere confuse con l'interfaccia API REST di NetWorker che fornisce l'accesso programmatico a NetWorker per la programmazione di operazioni personalizzate, descritta 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 è apparso il problema)?
  • Il problema si verifica solo nei momenti di carico intenso sull'ambiente di backup?
  • Qual è l'ambito del problema (tutte le operazioni di ripristino/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 del comando nsrlogin . Per i problemi di autenticazione, iniziare testando l'autenticazione sul server NetWorker stesso per distinguere se il problema di autenticazione è correlato o meno a NWUI. Se si utilizza un metodo di autenticazione esterno, ad esempio AD o LDAP, si consiglia di testare prima l'autenticazione con gli account NetWorker locali per verificare se il problema influisce solo sul metodo di autenticazione esterno.

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 lato browser
Se sono installati più browser, testare il problema riscontrato in browser diversi per verificare se il problema è specifico di un browser.

Nel browser, cliccare con il pulsante destro del mouse e selezionare "inspect" per visualizzare le chiamate API REST effettuate dal browser, nonché le istruzioni di log e le informazioni sulla connessione di rete.
  • Fare clic con il pulsante destro del mouse in un punto qualsiasi della finestra del browser e selezionare "ispeziona"
  • Si apre una nuova finestra con diverse schede.  Le schede "Console" e "Network" sono probabilmente le più utili.
  • Utilizzando queste schede, è possibile visualizzare le chiamate API REST esatte che vengono effettuate al server NetWorker. 
  • Nella scheda Network è inoltre possibile visualizzare il metodo di richiesta e la risposta API REST del server NetWorker. In questo modo, è possibile tracciare esattamente ciò che viene richiesto al server NetWorker e il modo esatto in cui il server NetWorker risponde a questa richiesta.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Problemi di back-end dell'interfaccia utente

I registri importanti del back-end dell'interfaccia utente sono:
    catalina.log - Registrazione del server Tomcat e registrazione del deployment delle applicazioni.
    nwui.log - Registrazione del server delle applicazioni NWUI.
    restapi.log - Registrazione dell'API REST di NetWorker.  NWUI comunica con il server NetWorker tramite l'API REST di NetWorker.
    daemon.raw - Registrazione del server NetWorker.

La posizione di questi file di log dipende dal sistema operativo in uso, nonché dal fatto che l'installazione di NWUI sia locale o remota sul server NetWorker.  Se NWUI si trova sul server NetWorker, condivide la stessa istanza Tomcat con NetWorker.
Se si fornisce un file di registro .raw al supporto, 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 e jsvc.exec È possibile verificare se sono in esecuzione con il comando ps:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
I log si trovano qui:

Locale sul server NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
Remoto:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Finestre

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


                  kA5f10000004LFmCAM_1_5

È possibile gestire questa operazione da services.msc:

                  kA5f10000004LFmCAM_1_6
 

I log si trovano qui:

Locale sul server NetWorker:
  • C:Program FilesWuilog di EMC NetWorker
  • C:Program FilesEMC NetWorker srauthc-serverlogs
  • C:Program FilesEMC NetWorker sr estapi estapi.log
  • C:Program FilesEMC NetWorker srlogsdaemon.raw
Remoto: 
  • C:Program FilesWuilog di EMC NetWorker
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
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 nel file logback.xml sul server NetWorker:

Windows: C:Program FilesEMC NetWorker srauthc-server omcatwebapps wrestapiWEB-INFclasses
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  kA5f10000004LFmCAM_1_7

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.

                  kA5f10000004LFmCAM_1_8

Additional Information

Affected Products

NetWorker

Products

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