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

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

本文适用于 本文不适用于 本文并非针对某种特定的产品。 本文并非包含所有产品版本。

说明

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 响应。

其他信息

受影响的产品

NetWorker

产品

NetWorker, NetWorker Series
文章属性
文章编号: 000010592
文章类型: How To
上次修改时间: 19 12月 2025
版本:  5
从其他戴尔用户那里查找问题的答案
支持服务
检查您的设备是否在支持服务涵盖的范围内。