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

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

Este artigo aplica-se a Este artigo não se aplica a Este artigo não está vinculado a nenhum produto específico. Nem todas as versões do produto estão identificadas neste artigo.

Instruções

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.


                  Componentes da NWUI 


Há quatro componentes importantes:
Eles 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 o AuthC para verificar as credenciais; após a verificação, o AuthC emite um token assinado, criptografado e baseado em tempo. 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.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } Não as confunda com a API REST do NetWorker, que permite operações personalizadas e está documentada no REST API Developer Guide 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?
  • A NWUI está instalada no NetWorker Server ou em um host separado?
    • Qual é a versão da NWUI, se instalada em um host separado do NetWorker Server?
  • 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)?
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 AD ou LDAP para autenticação, primeiramente, 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 NetWorker Server é:  
authc_mgmt -u [user name] -p [password] -e find-all-users.

Ou:

Conta local do NetWorker:

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Conta externa (AD/LDAP):
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
O Guia de configuração de segurança do NetWorker contém detalhes completos de como funciona a autenticação do NetWorker, como testá-la e como redefinir uma senha, se necessário.

Se você precisar de um diagnóstico adicional de autenticação, consulte:  NetWorker: Como habilitar a depuração AUTHC para fins de solução de problemas

Problemas de instalação
Para obter detalhes sobre como instalar a NWUI e quais logs consultar caso haja um problema com a instalação, consulte o seguinte artigo:
Interface do usuário da Web de gerenciamento do NetWorker: Como instalar                   

 

Problemas de back-end da IU

Os logs importantes de back-end da IU são:
Caminho do Linux Caminho do Windows (padrão) Função
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Registro em log de implementação de aplicativos e registro em log do Tomcat Server.
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log Registro em log do servidor de aplicativos da NWUI.
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log Registro em log da API REST do NetWorker. A NWUI se comunica com o NetWorker Server usando a API REST do NetWorker. Consulte a seção API REST deste artigo para ver como diagnosticar quais funções da API REST estão em uso e a resposta correspondente.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Registro em log do NetWorker Server.

Se o servidor da NWUI estiver no próprio NetWorker Server, ele compartilhará a mesma instância do Tomcat com o NetWorker.
Se você estiver fornecendo um arquivo de log .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 para processar arquivos de log .raw

Arquivos de log

Linux:

Os processos que são executados para o back-end da IU são:  /opt/nwui/bin/nwuictld jsvc.exec Você pode verificar se eles estão em execução com o comando ps comando:
ps -ef | grep nwui
                  Resultado de ps mostrando o back-end da NWUI 
Estes são os logs:

Locais do NetWorker Server:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
Remotos (o servidor da NWUI está em um host separado do NetWorker Server):
  • /opt/nwui/logs
  • /nsr/nwui/logs   
É possível usar o seguinte comando para criar um zip desses 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
Nota: Dependendo de a NWUI ser local ou remota para o NetWorker Server, o comando acima pode relatar alguns diretórios como ausentes. Isso é esperado. Não é necessário alterar o nome do host e a data; o comando acima cria o pacote automaticamente com o nome do host e a data atual do servidor (AAAA-MM-DD).
Windows

O processo de back-end da NWUI no Windows que deve estar em execução se chama nwuictld.exe:


                  Lista de tarefas que mostra o serviço NWUI 

Você pode gerenciar isso em services.msc:

                  Console de serviços que mostra a NWUI 
 

Estes são os logs:

Locais do NetWorker Server
  • 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
Nota: Os caminhos exibidos são o caminho de instalação padrão do NetWorker. Se o NetWorker foi instalado em outra unidade ou usando um caminho diferente, faça os ajustes adequados.
 
NetWorker Server

Execute a ferramenta nsrget no NetWorker Server para coletar os logs relevantes:
Networker: Como usar a ferramenta de coleta de dados NSRGet do NetWorker

Os logs mais relevantes dependem da operação que se está tentando realizar na NWUI. Para obter mais informações sobre logs do NetWorker, consulte:
Networker: Arquivos de log e locais

Depuração

Para depurar a comunicação da API REST, altere o nível de depuração no arquivo logback.xml do NetWorker Server:

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


                  Arquivo logback 

Remova os marcadores de comentário das linhas que lidam com o registro em log das chamadas da API. Isso causa a definição do nível de registro em log como "trace" para as solicitações e respostas da API REST.

                  Configurações de depuração 

Consulte: NetWorker: Como habilitar a depuração da API REST

 

API REST

A NWUI usa a API REST para interagir com o NetWorker. Os logs da NWUI e da API REST mostram funções de API e respostas do NetWorker, mas também é possível verificar essas informações 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.

Inspect

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

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

  1. Ao executar funções na NWUI, as operações são exibidas em Name. A coluna Status inclui o status de conclusão da API REST: API Request and Response 
  2. 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.

  1. 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.

Mais informações

Produtos afetados

NetWorker

Produtos

NetWorker, NetWorker Series
Propriedades do artigo
Número do artigo: 000010592
Tipo de artigo: How To
Último modificado: 19 dez. 2025
Versão:  5
Encontre as respostas de outros usuários da Dell para suas perguntas.
Serviços de suporte
Verifique se o dispositivo está coberto pelos serviços de suporte.