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 服务器的主机上。


                  kA5f10000004LFmCAM_1_0


有四个重要组成部分：
这些组件可以位于同一主机上，也可以位于不同的主机上。
  • 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作的内部调用。不要将它们与 NetWorker REST API 接口混淆，后者提供对 NetWorker 的编程访问，以便对自定义作进行编程，如《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 管理控制台和 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）：如何安装
 
浏览器端问题
如果安装了多个浏览器，请在不同的浏览器中测试观察到的问题，以查看问题是否特定于一个浏览器。

在浏览器中，右键单击并“检查”以查看从浏览器进行的 REST API 调用以及日志语句和网络连接信息。
  • 右键单击浏览器窗口中的任意位置，然后选择“检查”
  • 此时将打开一个新窗口，其中包含多个选项卡。  “Console”和“Network”选项卡可能非常有用。
  • 使用这些选项卡，我们可以看到对 NetWorker 服务器进行的确切 REST API 调用。 
  • 在“Network”选项卡中，我们还可以看到来自 NetWorker 服务器的请求方法和 REST API 响应。通过这种方式，我们可以准确地跟踪对 NetWorker 服务器的请求，以及 NetWorker 服务器对此请求的确切响应方式。
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

UI 后端问题

重要的 UI 后端日志包括：
    catalina.log - Tomcat 服务器日志记录和应用程序部署日志记录。
    nwui.log - NWUI 应用程序服务器日志记录。
    restapi.log — NetWorker REST API 日志记录。  NWUI 使用 NetWorker REST API 与 NetWorker 服务器进行通信。
    daemon.raw — NetWorker 服务器日志记录。

这些日志文件的位置取决于正在使用的作系统，以及 NWUI 的安装是在 NetWorker 服务器本地还是远程。  如果 NWUI 位于 NetWorker 服务器本身上，则它将与 NetWorker 共享相同的 tomcat 实例。
如果您要向支持人员提供.raw日志文件，建议在日志文件源自的系统上呈现日志文件。这可确保时间戳以服务器的本地时间呈现：NetWorker：如何使用nsr_render_log

日志文件

Linux：

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

NetWorker 服务器的本地日志：
  • /opt/nwui/logs
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
远程：
  • /opt/nwui/logs
  • /nsr/nwui/logs                  
窗户

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


                  kA5f10000004LFmCAM_1_5

您可以从 services.msc 进行管理：You can manage this from services.msc：

                  kA5f10000004LFmCAM_1_6
 

日志位于此处：

NetWorker 服务器的本地日志：
  • C：Program FilesEMC NetWorker wuilogs
  • C：Program FilesEMC NetWorker srauthc-serverlogs
  • C：Program FilesEMC NetWorker sr estapi estapi.log
  • C：Program FilesEMC NetWorker srlogsdaemon.raw
远程： 
  • C：Program FilesEMC NetWorker wuilogs
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
NetWorker 服务器

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

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

调试

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

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


                  kA5f10000004LFmCAM_1_7

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

                  kA5f10000004LFmCAM_1_8

Additional Information

NWUI 资源


521712 : NetWorker Management Web UI (NWUI)：  如何使用             
522859 : NetWorker Management Web UI (NWUI)：  如何安装          
522949 :   
522959:  NetWorker Management Web UI (NWUI)：分流和故障处理指南

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.