NetWorker Management Web UI (NWUI)：分流和故障处理指南

Summary: NetWorker Management Web UI (NWUI)：分流和故障处理指南

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.
Check out other resources

Instructions

NWUI 的工作原理

NetWorker Web 用户界面 （NWUI） 使用以下技术：HTML5、Apache Tomcat、Spring Framework、Angular Framework 和表述性状态转移 （REST） 应用程序编程接口 （API）。NWUI 应用程序可以安装在 Linux 或 Windows作系统上。它可以直接安装在 NetWorker 服务器上，也可以安装在不是 NetWorker 服务器的主机上。


                  NWUI 的组件 


有四个重要组成部分：
这些组件可以位于同一主机上，也可以位于不同的主机上。
  • Web 前端：  这是用 HTML5 和 Angular Framework 编写的表示层，它通过 Web 浏览器向用户显示 NetWorker作。Web 浏览器连接到 UI 后端进程。
  • UI 后端：  后端应用程序是用 Spring Framework 编写的。  它使用 java 和 Apache Tomcat。前端和后端之间以及后端和 NetWorker 服务器之间的通信使用内部 REST API 调用完成。NWUI 进程使用 NetWorker 服务器上的现有 Apache Tomcat 实例，或者安装其自己的 Apache Tomcat 实例（如果从 NetWorker 服务器远程安装）。
  • NetWorker 服务器：NetWorker 服务器 REST 框架负责从 UI 后端接收 REST API 调用，并将它们连接到 NetWorker 服务器的核心组件。NetWorker 服务器 RabbitMQ 消息总线也用于与 nsrjobd 交互。
  • AUTHC：NetWorker 的 AUTHC 组件用于满足所有身份验证需求。请求进程联系 AuthC 以验证凭据;验证后，AuthC 会发出时间、基于、签名和加密的令牌。NetWorker 组件使用此令牌验证用户并授权或不授权请求的作。它通常位于 NetWorker 服务器上，但可以安装在单独的主机上。 
大部分通信使用 REST API，允许与统一资源标识符 （URI） 地址标识的资源进行交互。它使用 HTTP 谓词（HEAD、GET、PUT、POST、DELETE）以无状态方式与统一资源标识符 （URI） 交互。这些 REST API 调用是 NetWorker 和 NWUI作的内部调用。

a { text-decoration： none; color：#464feb;} TR TH， TR TD { BORDER：1px 实心 #e6e6e6;} tr th { background-color：#f5f5f5;}不要将它们与 NetWorker REST API 混淆，后者支持自定义作，并记录在《NetWorker REST API 开发人员指南》中。

故障处理

定义问题

问题详细信息
要生成完整的问题描述，请考虑以下问题：
  • 正在尝试哪个作但不起作用？
  • 从 NWUI 外部启动时此作是否有效（例如：从 NetWorker Management Console （NMC））？
  • 问题是持续的还是间歇性的？
  • 如果是间歇性的，是否有已知的触发因素？
  • 此问题之前是否效果更好，如果是，在问题出现之前和之后是否应用了任何已知更改？
  • 问题首次发生的时间（以及自问题出现以来发生了哪些变化）？
  • 该问题是否仅在备份环境中负载繁重时发生？
  • 问题的范围是什么（所有恢复作或某些恢复作，某些选项卡不起作用，而其他选项卡不受影响）？
  • 到目前为止，已经尝试解决了什么问题，从中得出了什么结论？

环境详细信息
  • NetWorker 服务器版本和作系统平台是什么？
  • NWUI 是安装在 NetWorker 服务器上还是安装在单独的主机上？
    • 如果 NWUI 安装在独立于 NetWorker 服务器的主机上，则 NWUI 版本是什么？
  • NWUI 服务器上安装了什么 Java 包;是安装了 NetWorker Runtime Environment （NRE） 还是 Oracle Java Runtime Environment （JRE）。
身份验证
身份验证使用 AUTHC 的方式与 NetWorker Management Console 和 nsrlogin 命令确认该锁定已释放。对于身份验证问题，请首先在 NetWorker 服务器上测试身份验证，以确定问题是与 NWUI 相关还是与服务器本身相关。如果使用 AD 或 LDAP 进行身份验证，请首先使用本地 NetWorker 帐户进行测试，以确认问题是否仅影响外部身份验证。

用于测试身份验证过程是否按预期方式在 NetWorker 服务器上工作的典型命令为：   
authc_mgmt -u [user name] -p [password] -e find-all-users.

或者：

本地 NetWorker 帐户：

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
外部 （AD/LDAP） 帐户： 
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
 
NetWorker 安全配置指南包含有关 NetWorker 身份验证的工作原理、如何测试它以及如何在需要时重置密码的完整详细信息。

如果需要进一步的身份验证诊断，请参阅：  NetWorker：如何启用 AUTHC 调试以进行故障排除

安装问题
有关如何安装 NWUI 以及在安装出现问题时要查阅哪些日志的详细信息，请参阅以下文章：
NetWorker Management Web UI （NWUI）：如何安装                   

 

UI 后端问题

重要的 UI 后端日志包括：
Linux 路径 Windows 路径（默认） 功能
/nsr/authc/logs/catalina.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\catalina.log Tomcat 服务器日志记录和应用程序部署日志记录。
/nsr/authc/logs/nwui.log C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\nwui.log NWUI 应用程序服务器日志记录。
/nsr/logs/restapi/restapi.log C:\Program Files\EMC NetWorker\nsr\restapi\restapi.log NetWorker REST API 日志记录。NWUI 使用 NetWorker REST API 与 NetWorker 服务器进行通信。请参阅本文的 REST API 部分，了解如何诊断正在使用的 REST API 函数以及相应的响应。
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw NetWorker 服务器日志记录。

如果 NWUI 服务器位于 NetWorker 服务器本身上，则它将与 NetWorker 共享相同的 tomcat 实例。
如果您要提供 .raw 日志文件，建议在日志文件源自的系统上呈现日志文件。这可确保时间戳以服务器的本地时间呈现：NetWorker：如何使用nsr_render_log

日志文件

Linux：

为 UI 后端运行的进程包括：  /opt/nwui/bin/nwuictld 和 jsvc.exec 您可以 检查它们是否使用 ps 命令执行此操作： 
ps -ef | grep nwui
                  显示 NWUI 后端的 ps 输出 
日志位于此处：

NetWorker 服务器的本地日志：
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
  • /nsr/nwui/monitoring/app/logs/
远程（NWUI 服务器位于独立于 NetWorker 服务器的主机上）：
  • /opt/nwui/logs
  • /nsr/nwui/logs   
以下命令可用于创建这些日志的 zip 文件 
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
提醒：根据 NWUI 是 NetWorker 服务器的本地还是远程，上述命令可能会将某些目录报告为缺失。这是预期行为。主机名和日期无需更改，上述命令会自动使用服务器的主机名和当前日期 （YYYY-MM-DD） 创建捆绑包。
窗户

必须运行的 Windows NWUI 后端进程称为 nwuictld.exe：


                  显示 NWUI 服务的任务列表 

您可以通过以下方式进行管理： services.msc：

                  显示 NWUI 的服务控制台 
 

日志位于此处：

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\
远程： 
  • 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 安装路径。如果 NetWorker 安装在另一个驱动器上或使用不同的路径，请相应地进行调整。
 
NetWorker 服务器

在 NetWorker 服务器上运行 nsrget 工具以收集相关日志：
NetWorker：如何使用 NSRGet NetWorker 数据收集工具

最相关的日志取决于尝试从 NWUI 执行的作。有关 NetWorker 日志的更多信息，请参阅：
NetWorker：日志文件和位置

调试

要调试 REST API 通信，请在 logback.xml NetWorker 服务器上的文件：

Windows（默认）： C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux： /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  Logback 文件 

取消注释处理 API 调用日志记录的行。这会导致 REST API 请求和响应的日志记录级别设置为“trace”。

                  调试设置 

请参阅：NetWorker：如何启用 REST API 调试

 

REST API

NWUI 使用 REST API 与 NetWorker 交互。NWUI 和 REST API 日志显示 API 函数和 NetWorker 响应，但也可直接在浏览器中检查此信息。此方法可用于查找 UI 和 NetWorker CLI 之间的差异，或查找 UI 未返回预期结果的情况。 

 

  1. 访问 NWUI 时，右键单击浏览器窗口，然后选择 Inspect。

检查

  1. 在浏览器的“Inspect”窗口中，单击 Network 选项卡：

浏览器检查网络

  1. 在 NWUI 中执行功能时，作将显示 在名称下。Status列包括 REST API 完成状态：API 请求和响应 
  2. 单击要进一步调查的作。例如，通过单击上面所示 的备份 功能， Headers 选项卡中会显示以下详细信息：

由此，请求 URL、请求方法和状态代码都是可识别的。

  1. 要查看响应有效负载，请单击 Responses 选项卡。

 

此示例显示了用于在浏览 Azure 备份并选择要还原的存储集后填充 “恢复和存储集 ”选项卡的 REST API 响应。

Additional Information

NWUI 资源

NetWorker Management Web UI (NWUI)：  如何使用             
NetWorker 管理 Web UI （NWUI）：  如何安装          
NetWorker 管理 Web UI （NWUI）：分流和故障处理指南

Affected Products

NetWorker

Products

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