Interface do usuário da Web de gerenciamento do NetWorker: Guia de triagem e solução de problemas (em inglês)

Como funciona a NWUI

A NetWorker Web User Interface (NWUI) usa as seguintes tecnologias: HTML5, Apache Tomcat, Spring Framework, Angular Framework e a interface de programação de aplicativos (API) Representational State Transfer (REST). É possível instalar o aplicativo NWUI em sistemas operacionais Linux ou Windows. Instale-o diretamente no NetWorker Server ou em um host que não seja o NetWorker Server.

Há quatro componentes importantes. Esses componentes podem estar no mesmo host ou em hosts separados.

• Front-end da Web: Essa é a camada de apresentação escrita em HTML5 e Angular Framework que apresenta as operações do NetWorker ao usuário por meio de um navegador da Web. O navegador da Web está conectado aos processos de back-end da IU.
• Back-end da IU: O aplicativo de back-end é escrito no Spring Framework. Ele usa Java e Apache Tomcat. A comunicação entre o front-end e o back-end e entre o back-end e o NetWorker Server é feita usando chamadas internas da API REST. O processo da NWUI usa a instância existente do Apache Tomcat no NetWorker Server ou instala sua própria instância do Apache Tomcat, se instalada remotamente a partir do NetWorker Server.
• NetWorker Server: A estrutura REST do NetWorker Server é responsável por receber as chamadas da API REST do back-end da IU e conectá-las aos componentes principais do NetWorker Server. O barramento de mensagens RabbitMQ do NetWorker Server também é usado para interação com nsrjobd.
• AUTHC: O componente AUTHC do NetWorker é usado para todas as necessidades de autenticação. O processo de solicitação entra em contato com a AUTHC para verificar as credenciais; após a verificação, o AUTHC emite um token de tempo, baseado, assinado e criptografado. Os componentes do NetWorker usam esse token para verificar o usuário e autorizar ou não uma operação solicitada. Ele geralmente se encontra no NetWorker Server, mas é possível instalá-lo em um host separado. 

A maior parte da comunicação está usando a API REST, o que permite a interação com recursos identificados por endereços de Uniform Resource Identifier (URI). Ela usa verbos HTTP (HEAD, GET, PUT, POST, DELETE) para interagir com os Uniform Resource Identifiers (URIs) sem monitoração de estado.

Essas chamadas da API REST são internas às operações do NetWorker e da NWUI. Não os confunda com a API REST do NetWorker, que permite operações personalizadas e está documentada no Guia do desenvolvedor da API REST do NetWorker.

Solução de problemas

Definindo o problema

• Detalhes do problema: Para gerar uma descrição completa do problema, considere as seguintes perguntas:
  • Qual operação você está tentando fazer, mas não está funcionando?
  • Essa operação funciona quando iniciada de fora da NWUI (por exemplo: No NetWorker Management Console (NMC))?
  • O problema é consistente ou intermitente?
  • Se intermitente, há um gatilho conhecido?
  • Isso funcionava melhor antes e, em caso afirmativo, houve a aplicação de alguma alteração conhecida antes e depois de o problema aparecer?
  • Quando o problema ocorreu pela primeira vez (e o que mudou desde que o problema apareceu)?
  • O problema acontece somente em momentos de uso intenso do ambiente de backup?
  • Qual é o escopo do problema (todas as operações de recuperação ou algumas operações de recuperação, algumas guias não funcionam enquanto outras não são afetadas)?
  • Quais são as medidas de correção aplicadas até agora e quais foram as conclusões tiradas a partir disso?

• Detalhes do ambiente: 
  • Qual é a versão do NetWorker Server e a plataforma do sistema operacional? NetWorker: Métodos para identificar a versão do software NetWorker
  • A NWUI está instalada no NetWorker Server ou em um host separado?
    • Se instalado em um host separado do servidor NetWorker, qual é a versão do servidor NWUI?
  • O servidor NWUI está usando o servidor local do NetWorker para autenticação (AUTHC) ou é um servidor AUTHC separado usado: NetWorker: Como identificar qual servidor é o servidor de autenticação usado pelo NMC e NWUI
  • Qual pacote Java está instalado no servidor da NWUI? Há a instalação do NetWorker Runtime Environment (NRE) ou do Oracle Java Runtime Environment (JRE)?
    • NRE 8.x: Como limpar o cache do Java, ativar o Java Console e a depuração.
    • NRE 17.x: Como limpar o cache do Java, ativar o Java Console e depurar
• Problemas comuns:
  • Problemas de autenticação: A autenticação usa o AUTHC da mesma forma que o NetWorker Management Console e o comando nsrlogin . 
    Para problemas de autenticação, primeiramente, teste a autenticação no NetWorker Server para determinar se o problema está relacionado à NWUI ou ao próprio servidor. Se estiver usando o AD ou o LDAP para autenticação, primeiro teste com contas locais do NetWorker para confirmar se o problema afeta apenas a autenticação externa.
    Um comando típico usado para testar se o processo de autenticação está funcionando conforme o esperado no servidor NetWorker é: 

authc_mgmt -u [user name] -p [password] -e find-all-users.

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout

nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout

• • Problemas de instalação: Para obter detalhes sobre como instalar o NWUI e quais logs consultar caso haja um problema com a instalação, consulte o seguinte artigo: IU da Web de Gerenciamento do NetWorker (NWUI): Como instalar
  • Problemas de back-end da interface do usuário: Os logs importantes de back-end da IU são:

Se o servidor NWUI estiver no próprio servidor NetWorker, ele compartilhará a mesma instância do tomcat com o NetWorker.

Se você estiver fornecendo um .raw ao suporte, é aconselhável renderizar o arquivo de log no sistema do qual ele se origina. Isso garante a renderização dos registros de data e hora de acordo com a hora local do servidor: NetWorker: Como usar nsr_render_log

Arquivos de log:

Linux:

Os processos que são executados para o back-end da interface do usuário são: code>/opt/nwui/bin/nwuictld e jsvc.exec. Você pode verificar se eles estão em execução com o comando ps comando:

ps -ef | grep nwui

• Local para o servidor do NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
• Remoto (o servidor NWUI está em um host separado do servidor NetWorker):
  • /opt/nwui/logs
  • /nsr/nwui/logs 

O comando a seguir pode ser usado para criar uma .zip desses registros.

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

Windows

O processo de back-end NWUI do Windows que deve estar em execução é chamado de nwuictld.exe:

Você pode gerenciar isso em services.msc:

Os logs estão aqui:

• Local para o servidor do 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

NetWorker Server

Execute o NSRGET no servidor NetWorker para coletar os logs relevantes: NetWorker: Como usar a ferramenta NSRGet NetWorker Data Collection 

Os registros mais relevantes dependem da tentativa de operação no NWUI. Para obter mais informações sobre logs do NetWorker, consulte:NetWorker: Arquivos de log e locais

Depuração

Os níveis de registro do NWUI são definidos no seguinte arquivo:

• Windows (padrão): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwui\WEB-INF\classes\logback.xml
• Linux: /nsr/authc/webapps/nwui/WEB-INF/classes/logback.xml

1. Aumente o maxFileSize from 20MB para 100MB
2. Altere o root level from INFO para DEBUG

3. Reinicie o serviço NWUI:

• Linux: systemctl restart nwui
• Windows (PowerShell): net stop nwui ; net start nwui

Console de inspeção do navegador da Web.

A NWUI usa funções de API e respostas do NetWorker, mas essas informações também podem ser verificadas diretamente no navegador. Esse método é útil para localizar discrepâncias entre as IUs e a CLI do NetWorker ou quando a IU não retorna os resultados esperados. 

1. Ao acessar a NWUI, clique com o botão direito na janela do navegador e selecione Inspect.

2. Na janela "Inspect" do navegador, clique na guia Network:

Network" no navegador" src="https://dellservices.file.force.com/servlet/rtaImage?eid=ka0Do000000utTr&feoid=00N2R000006y2KU&refid=0EMDo000005kTmN">

3. As operações aparecem em Name ao executar funções no NWUI. A coluna Status inclui o status de conclusão da API REST: API Request and Response
4. Clique na operação que você deseja investigar mais. Por exemplo, ao clicar na função backups exibida acima, os seguintes detalhes são exibidos na guia Headers:

A partir daí, é possível identificar elementos como URL da solicitação, método da solicitação e código de status.

5. Para ver a carga útil da resposta, clique na guia Response.

Este exemplo mostra a resposta da API REST usada para preencher a guia Recover and Savesets depois de navegar pelos backups do Azure e selecionar um saveset para restauração.

Recursos da NWUI

• IU da Web de Gerenciamento do NetWorker (NWUI): Como usar             
• IU da Web de Gerenciamento do NetWorker (NWUI): Como instalar          
• IU da Web de Gerenciamento do NetWorker (NWUI): Guia de triagem e solução de problemas (em inglês)