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

Summary: IU da Web de Gerenciamento do NetWorker (NWUI): Guia de triagem e solução de problemas

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Como o NWUI funciona

O NetWorker Web User Interface (NWUI) usa as seguintes tecnologias: HTML5, Apache Tomcat, Spring Framework, Angular Framework e Interface de Programação de Aplicativos (API) de Transferência de Estado Representacional (REST). O aplicativo NWUI pode ser instalado em sistemas operacionais Linux ou Windows. Ele pode ser instalado diretamente no servidor NetWorker ou em um host que não seja o servidor NetWorker.


                  kA5f10000004LFmCAM_1_0


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 interface do usuário.
  • Back-end da interface do usuário:  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 servidor do NetWorker é feita usando chamadas internas da API REST. O processo do NWUI usa a instância existente do Apache Tomcat no servidor NetWorker ou instala sua própria instância do Apache Tomcat, se instalada remotamente a partir do servidor NetWorker.
  • Servidor NetWorker: A estrutura REST do servidor NetWorker é responsável por receber as chamadas da API REST do back-end da interface do usuário e conectá-las aos componentes principais do servidor NetWorker. O barramento de mensagens RabbitMQ do servidor NetWorker 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, a 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. Geralmente, isso ocorre no servidor do NetWorker, mas pode ser instalado em um host separado. 
A maior parte da comunicação está usando a API REST, que permite a interação com recursos identificados por endereços URI (Uniform Resource Identifier). Ele usa verbos HTTP (HEAD, GET, PUT, POST, DELETE) para interagir com o URI (Uniform Resource Identifiers) de forma sem monitoração de estado. Essas chamadas da API REST são internas às operações do NetWorker e do NWUI. Eles não devem ser confundidos com a interface da API REST do NetWorker, que fornece acesso programático ao NetWorker para programação de operações personalizadas, que é descrita no Guia do desenvolvedor da API REST do NetWorker.
 

Solução de problemas

Definindo o problema

DETALHES
DO PROBLEMAPara gerar uma descrição completa do problema, considere as seguintes perguntas:
  • Qual operação está sendo tentada que não está funcionando?
  • Essa operação funciona quando iniciada de fora do NWUI (por exemplo: No NetWorker Management Console (NMC)?
  • O problema é consistente ou intermitente?
  • Se intermitente, há um gatilho conhecido?
  • Isso funcionou melhor antes e, em caso afirmativo, há alguma alteração conhecida aplicada antes e depois do problema aparecer?
  • Quando o problema ocorreu pela primeira vez (e o que mudou desde que o problema surgiu)?
  • O problema acontece somente em momentos de carga pesada no ambiente de backup?
  • Qual é o escopo do problema (todas as operações de recuperação/algumas operações de recuperação, algumas guias não funcionam enquanto outras não são afetadas)?
  • O que se tentou até agora corrigir e que conclusões foram tiradas a partir disso?

DETALHES DO AMBIENTE
  • Qual é a versão do servidor do NetWorker e a plataforma do sistema operacional?
  • O NWUI está instalado no servidor NetWorker ou em um host separado?
    • Qual é a versão do NWUI se instalado em um host separado do servidor NetWorker?
  • Qual pacote Java está instalado no servidor NWUI; se o NetWorker Runtime Environment (NRE) estiver instalado ou o 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, comece testando a autenticação no próprio servidor NetWorker para separar se o problema de autenticação está relacionado à NWUI ou não. Se você estiver usando um método de autenticação externo, como AD ou LDAP, é aconselhável primeiro testar a autenticação com contas locais do NetWorker para ver se o problema afeta apenas o método de 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.

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 a autenticação do NetWorker funciona, como testá-la e como redefinir uma senha, se necessário.

Se for necessário 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 o NWUI e quais logs consultar caso haja um problema com a instalação, consulte o seguinte artigo:
NetWorker Management Web UI (NWUI): Como instalar
 
Problemas no navegador
Se vários navegadores estiverem instalados, teste o problema observado em diferentes navegadores para ver se o problema é específico de um navegador.

No navegador, clique com o botão direito e "inspecione" para ver as chamadas da API REST que estão sendo feitas no navegador, bem como instruções de log e informações de conexão de rede.
  • Clique com o botão direito do mouse em qualquer lugar na janela do navegador e selecione "inspecionar"
  • Uma nova janela é aberta com várias guias.  As guias 'Console' e 'Network' provavelmente serão as mais úteis.
  • Usando essas guias, podemos ver as chamadas exatas da API REST que estão sendo feitas ao servidor do NetWorker. 
  • Na guia Network, também podemos ver o método de solicitação e a resposta da API REST do servidor NetWorker. Dessa forma, podemos rastrear exatamente o que está sendo solicitado do servidor NetWorker e exatamente como o servidor NetWorker está respondendo a essa solicitação.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Problemas de back-end da interface do usuário

Os logs importantes de back-end da interface do usuário são:
    catalina.log - log do servidor Tomcat e registro de implementação de aplicativos.
    nwui.log — log do servidor de aplicativos NWUI.
    restapi.log — Log da API REST do NetWorker.  O NWUI se comunica com o servidor do NetWorker usando a API REST do NetWorker.
    daemon.raw — Log do servidor do NetWorker.

A localização desses arquivos de log depende do sistema operacional que está sendo usado, bem como se a instalação do NWUI é local para o servidor do NetWorker ou remoto.  Se o NWUI estiver no próprio servidor do NetWorker, ele compartilhará a mesma instância do tomcat com o NetWorker.
Se você estiver fornecendo um arquivo de log do .raw para o suporte, é aconselhável processar o arquivo de log no sistema do qual ele se origina. Isso garante que os registros de data e hora sejam processados na 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:  /opt/nwui/bin/nwuictld e jsvc.exec Você pode verificar se eles estão sendo executados com o comando ps:
ps -ef | grep nwui
                  kA5f10000004LFmCAM_1_3
Os logs estão aqui:

Local para o servidor do NetWorker:
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
Remoto:
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
Windows

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


                  kA5f10000004LFmCAM_1_5

Você pode gerenciar isso em services.msc:

                  kA5f10000004LFmCAM_1_6
 

Os logs estão aqui:

Local para o servidor do NetWorker:
  • C:Arquivos de programasEMC NetWorker wuilogs
  • C:Arquivos de programasEMC NetWorker srauthc-serverlogs
  • C:Arquivos de programasEMC NetWorker sr estapi estapi.log
  • C:Arquivos de programasEMC NetWorker srlogsdaemon.raw
Remoto: 
  • C:Arquivos de programasEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[CARIMBO DE DATA/HORA].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[CARIMBO DE DATA/HORA]_0_MCUI.log
NetWorker Server

Execute a ferramenta 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

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

Windows: C:Program FilesEMC NetWorker srauthc-server omcatwebapps wrestapiWEB-INFclasses
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  kA5f10000004LFmCAM_1_7

Remova o comentário das linhas que lidam com o registro de chamadas da API. Isso faz com que o nível de registro seja definido como "trace" para as solicitações e respostas da API REST.

                  kA5f10000004LFmCAM_1_8

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000010592
Article Type: How To
Last Modified: 08 May 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.