Funzionamento di NWUI
L'interfaccia utente web di NetWorker utilizza le seguenti tecnologie: HTML5, Apache Tomcat, Spring Framework, Angular Framework e API 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.
Ci sono quattro componenti importanti:
Questi componenti possono trovarsi sullo stesso host o su host separati.
- Front-end web: Questo è il 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 dell'interfaccia utente: L'applicazione back-end viene scritta in Spring Framework. Utilizza Java e Apache Tomcat. La comunicazione tra front-end e back-end e tra il back-end e il server NetWorker viene eseguita utilizzando le chiamate API REST interne. Il processo NWUI utilizza l'istanza Apache Tomcat esistente sul server NetWorker o installa la propria istanza Apache Tomcat se installata in remoto dal server NetWorker.
- Server NetWorker: Il framework REST di NetWorker Server è responsabile della ricezione delle chiamate API REST dal back-end dell'interfaccia utente e della relativa connessione ai componenti core del server NetWorker. Il bus di messaggi RabbitMQ del server NetWorker viene utilizzato 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; dopo la verifica, AuthC emette un token orario, basato, firmato 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 utilizza l'API REST
che consente l'interazione con le risorse identificate dagli indirizzi URI (Uniform Resource Identifier). Utilizza verbi HTTP (HEAD, GET, PUT, POST, DELETE) per interagire con l'URI (Uniform Resource Identifier) in modo stateless. Queste chiamate API REST sono interne alle operazioni di NetWorker e NWUI. Non devono essere confusi con l'interfaccia API REST di NetWorker che fornisce l'accesso a livello di programmazione a NetWorker per la programmazione di operazioni personalizzate descritte nella Guida per gli sviluppatori di API REST di NetWorker.
Risoluzione dei problemi
Definizione del problema
DETTAGLI
DEL PROBLEMAPer generare una descrizione completa del problema, tenere presenti le seguenti domande:
- Quale operazione viene tentata e quale non funziona?
- Questa operazione funziona se avviata dall'esterno di NWUI (ad esempio: Da NetWorker Management Console (NMC)?
- Il problema è coerente o intermittente?
- Se è intermittente, esiste un trigger noto?
- In passato funzionava meglio e, in caso affermativo, ci sono modifiche note applicate prima e dopo che il problema è stato riscontrato?
- Quando si è verificato il problema per la prima volta (e cosa è cambiato da quando è emerso il problema)?
- Il problema si verifica solo nei momenti di carico intenso nell'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)?
- Cosa si è tentato finora di risolvere e quali conclusioni sono state tratte da questo?
DETTAGLI DELL'AMBIENTE
- Che cos'è 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 separare se il problema di autenticazione è correlato o meno all'interfaccia utente nw. 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
Problemi di installazione
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, utilizzare il pulsante destro del mouse e "inspect" per visualizzare le chiamate API REST effettuate dal browser, nonché le istruzioni di registro e le informazioni sulla connessione di rete.
- Cliccare con il pulsante destro del mouse su un punto qualsiasi della finestra del browser e selezionare "inspect" (Controlla)
- Si apre una nuova finestra con diverse schede. È probabile che le schede "Console" e "Network" siano le più utili.
- Utilizzando queste schede, è possibile visualizzare le chiamate API REST esatti effettuate al server NetWorker.
- Nella scheda Network è inoltre possibile visualizzare il metodo di richiesta e la risposta dell'API REST dal server NetWorker. In questo modo, possiamo tenere traccia esattamente di ciò che viene richiesto al server NetWorker e esattamente del modo in cui il server NetWorker risponde a questa richiesta.
Problemi di back-end dell'interfaccia utente
I log back-end dell'interfaccia utente importanti sono:
catalina.log: registrazione del server Tomcat e registrazione dell'implementazione delle applicazioni.
nwui.log : registrazione del server applicazioni NWUI.
restapi.log - Logging dell'API REST di NetWorker. NWUI comunica con il server NetWorker utilizzando l'API REST di NetWorker.
daemon.raw - Logging del server NetWorker.
La posizione di questi file di registro dipende dal sistema operativo utilizzato e dal fatto che l'installazione di NWUI sia locale sul server NetWorker o remota. Se NWUI si trova sul server NetWorker, condivide la stessa istanza tomcat con NetWorker.
Se si fornisce un file di registro .raw per il supporto, si consiglia di eseguire il rendering del file di registro sul sistema da cui ha origine. In questo modo i timestamp vengono visualizzati nell'ora locale del server:
NetWorker: Come utilizzare 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:
I registri sono qui:
Server da locale a 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 di back-end dell'interfaccia utente NWUI di Windows che deve essere in esecuzione è denominato nwuictld.exe:
È possibile gestirle da services.msc:
I registri sono qui:
Server da locale a NetWorker:
- C:\Programmi\EMC NetWorker\nwui\logs
- C:\Programmi\EMC NetWorker\nsr\authc-server\logs
- C:\Programmi\EMC NetWorker\nsr\restapi\restapi.log
- C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
Remoto:
- C:\Programmi\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
Eseguire lo strumento nsrget sul server NetWorker per raccogliere i registri pertinenti:
Networker: Come utilizzare lo strumento
di data collection NSRGet NetWorkerI registri più rilevanti dipendono dall'operazione tentata dall'interfaccia utente nw. Per ulteriori informazioni sui registri NetWorker, consultare:
Networker: File di registro e percorsi
Debug
Per eseguire il debug della comunicazione dell'API REST, modificare il livello di debug nel file logback.xml sul server NetWorker:
Windows: C:\Programmi\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes
Rimuovere il commento dalle righe relative alla registrazione delle chiamate API. In questo modo, il livello di registrazione viene impostato su "trace" per le richieste e le risposte dell'API REST.