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.
a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } Da non confondere con l'API REST NetWorker, che consente operazioni personalizzate ed è documentata nella guida per gli sviluppatori dell'API REST NetWorker.
Risoluzione dei problemi
Definizione del problema
Al fine di 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?
DETTAGLI DELL'AMBIENTE
- Qual è la versione del server NetWorker e quale sistema operativo utilizza?
- 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) oppure Oracle Java Runtime Environment (JRE)?
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
NetWorker Management Web UI (NWUI): Modalità 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 dell'implementazione 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 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
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
Il processo di back-end di NWUI per Windows che deve essere eseguito è 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
Eseguire lo strumento nsrget sul server NetWorker per raccogliere i registri 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