NetWorker Management Web UI (NWUI): guida alla valutazione e alla risoluzione dei problemi
Riepilogo: NetWorker Management Web UI (NWUI): guida alla valutazione e alla risoluzione dei problemi
Istruzioni
Come funziona NWUI
Sono presenti 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 NetWorker all'utente tramite un web browser. Il web browser è connesso ai processi di back-end dell'interfaccia utente.
- Back-end dell'interfaccia utente: l'applicazione di 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 utilizzando chiamate API REST interne. Il processo NWUI utilizza l'istanza Apache Tomcat esistente sul server NetWorker oppure installa la propria istanza Apache Tomcat in caso di installazione remota 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 principali del server NetWorker. Il bus dei 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 genera un token orario, firmato e crittografato. I componenti di NetWorker utilizzano questo token per verificare l'utente e autorizzare o meno un'operazione richiesta. In genere si tratta del server NetWorker, ma può essere installato su un host separato.
Risoluzione dei problemi
Definizione del problema
DETTAGLI DEL PROBLEMA
Per generare una descrizione completa del problema, considerare le seguenti domande:
- Quale operazione si sta tentando di eseguire e non funziona?
- Questa operazione riesce quando viene avviata all'esterno di NWUI (ad esempio da NetWorker Management Console (NMC))?
- Il problema è costante o intermittente?
- Se è intermittente, esiste un fattore determinante?
- In precedenza funzionava meglio e, in tal caso, sono state applicate modifiche note prima o dopo la comparsa del problema?
- Quando è emerso il problema per la prima volta (e cosa è cambiato dall'insorgere del problema)?
- Il problema si verifica solo in momenti di carico elevato dell'ambiente di backup?
- Qual è l'ambito del problema (tutte le operazioni di ripristino o solo alcune, alcune schede non funzionano mentre altre non sono interessate)?
- Quali azioni sono già state intraprese per risolvere il problema e quali conclusioni ne sono state tratte?
- Quali sono la versione del server NetWorker e la piattaforma del sistema operativo?Networker: metodi per identificare la versione del software NetWorker
- NWUI è installato sul server NetWorker o su un host separato?
- se installato su un host separato dal server NetWorker, qual è la versione del server NWUI?
- Il server NWUI utilizza il server NetWorker locale per l'autenticazione (AUTHC) o viene utilizzato un server AUTHC separato: NetWorker: Come identificare il server di autenticazione utilizzato da NMC e NWUI
- Quale pacchetto Java è installato sul server NWUI; è installato NetWorker Runtime Environment (NRE) oppure Oracle Java Runtime Environment (JRE)?
Problemi comuni:
nsrlogin . Per problemi di autenticazione, testare innanzitutto l'autenticazione sul server NetWorker per determinare se il problema riguarda NWUI o il server stesso. Se si utilizza AD o LDAP per l'autenticazione, eseguire innanzitutto un test con account NetWorker locali per verificare se il problema riguarda solo l'autenticazione esterna.
Un comando tipico utilizzato per testare se il processo di autenticazione funziona correttamente sul server NetWorker è il seguente:
authc_mgmt -u [user name] -p [password] -e find-all-users.
Oppure:
Account NetWorker locale:
nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
Se è necessaria una diagnosi di autenticazione ulteriore, vedere: NetWorker: Come abilitare AUTHC DEBUG per la risoluzione dei problemi
PROBLEMI DI INSTALLAZIONE:
I registri di back-end dell'interfaccia utente importanti sono:
| Percorso Linux | Percorso Windows (predefinito) | Funzione |
/nsr/authc/logs/catalina.log |
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log |
Registrazione del server Tomcat e registrazione dell'implementazione delle applicazioni |
/nsr/authc/logs/nwui.log |
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log |
Registrazione server applicazioni NWUI |
/nsr/logs/restapi/restapi.log |
C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log |
NWUI comunica con il server NetWorker tramite l'API REST NetWorker. Per ulteriori informazioni su come diagnosticare quali funzioni dell'API REST vengono utilizzate e le relative risposte, vedere la sezione API REST in questo articolo. |
/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 di 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. Questo garantisce che i timestamp vengano visualizzati nell'ora locale del server: NetWorker: Come utilizzare nsr_render_log (in inglese)
File di registro:
Linux:
I processi eseguiti per il back-end dell'interfaccia utente sono: /opt/nwui/bin/nwuictld e jsvc.exec. È possibile controllare se sono in esecuzione con il comando ps :
ps -ef | grep nwui
Da server locale a server NetWorker:
/opt/nwui/logs/nsr/authc/logs//nsr/logs/restapi/restapi.log/nsr/logs/daemon.raw/nsr/nwui/monitoring/app/logs/
/opt/nwui/logs/nsr/nwui/logs
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
Finestre
Il processo back-end NWUI di Windows che deve essere in esecuzione è denominato nwuictld.exe:
services.msc:
Da server locale a server NetWorker:
C:\Program Files\EMC NetWorker\nwui\logs\C:\Program Files\EMC NetWorker\nsr\authc-server\logsC:\Program Files\EMC NetWorker\nsr\restapi\restapi.logC:\Program Files\EMC NetWorker\nsr\logs\daemon.rawC:\Program Files\EMC NetWorker\nwui\monitoring\app\logs\
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
Server NetWorker
Eseguire lo strumento NSRGET sul server NetWorker per raccogliere i log pertinenti:
Networker: come utilizzare lo strumento di data collection di NetWorker NSRGet
I registri più rilevanti dipendono dall'operazione che si sta tentando di eseguire da NWUI. Per ulteriori informazioni sui registri di NetWorker, vedere:
NetWorker: file e posizioni dei registri
Debug
logback.xml sul server NetWorker:
Windows (predefinito):
C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux:
/nsr/authc/webapps/nwrestapi/WEB-INF/classes
Vedere: NetWorker: Come abilitare il debug dell'API REST
API REST
NWUI utilizza l'API REST per interfacciarsi con NetWorker. I registri di NWUI e dell'API REST mostrano le funzioni API e le risposte NetWorker, ma queste informazioni possono essere controllate direttamente nel browser. Questo metodo è utile per individuare discrepanze tra l'interfaccia utente e la CLI NetWorker o quando l'interfaccia utente non restituisce i risultati previsti.
- Per accedere a NWUI, cliccare con il pulsante destro del mouse nella finestra del browser e selezionare Inspect.

- Nella finestra "Inspect" del browser cliccare sulla scheda Network:

- 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 dell'API
- Cliccare sull'operazione che si desidera esaminare ulteriormente. Ad esempio, cliccando sulla funzione backups mostrata sopra, nella scheda Headers vengono visualizzati i seguenti dettagli:


Da qui l'URL di richiesta, il metodo di richiesta e il codice di stato sono tutti identificabili.
- Per visualizzare il payload della risposta, cliccare sulla scheda Responses.
Questo esempio mostra la risposta dell'API REST utilizzata per compilare la scheda Recover and Savesets dopo aver visualizzato i backup di Azure e selezionato un saveset per il ripristino.
Informazioni aggiuntive
Risorse NWUI
NetWorker Management Web UI (NWUI): Modalità d'uso
NetWorker Management Web UI (NWUI): Modalità di installazione
NetWorker Management Web UI (NWUI): guida alla valutazione e alla risoluzione dei problemi