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

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

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

说明

NWUI 的工作方式

NetWorker Web 用户界面 (NWUI) 采用了以下技术:HTML5、Apache Tomcat、Spring 框架、Angular 框架以及表现层状态转换 (REST) 应用程序编程接口 (API)。NWUI 应用程序可以安装在 Linux 或 Windows 操作系统上。它可以直接安装在 NetWorker 服务器上,也可以安装在非 NetWorker 服务器的主机上


                  NWUI 的组件 


有四个重要组件:
这些组件可以位于同一主机上,也可以位于单独的主机上。
  • Web 前端:  这是采用 HTML5 和 Angular 框架编写的表示层,通过 Web 浏览器向用户呈现 NetWorker 操作。Web 浏览器连接到 UI 后端进程。
  • UI 后端  该后端应用程序采用 Spring 框架编写。  它使用 Java 和 Apache Tomcat。前端与后端之间以及后端与 NetWorker 服务器之间的通信使用内部 REST API 调用完成。NWUI 进程会使用 NetWorker 服务器上的现有 Apache Tomcat 实例;如果是从 NetWorker 服务器远程安装的,则会安装它自己的 Apache Tomcat 实例。
  • 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) 进行交互。对于 NetWorker 和 NWUI 操作来说,这些 REST API 调用是内部调用。

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } 请勿将它们与 NetWorker REST API 混淆,后者支持自定义操作,并且在 NetWorker REST API 开发人员指南中有详细记录。

故障处理

定义问题

问题详细信息
为了生成完整的问题描述,请考虑以下问题:
  • 具体是哪项操作无法正常执行?
  • 从 NWUI 之外的位置(例如:NetWorker Management Console (NMC) 发起该操作时,它是否能正常执行?
  • 该问题是持续出现的,还是间歇性的?
  • 如果是间歇性的,是否有已知的触发条件?
  • 该操作以前是否能够正常执行?如果是,在问题出现前后是否进行了任何已知的更改?
  • 该问题是什么时候首次出现的(以及自该问题出现以来有什么变更)?
  • 该问题是否仅在备份环境负载较高时发生?
  • 该问题的影响范围是什么(涉及所有恢复操作还是部分恢复操作?部分选项卡无法使用,而其他选项卡不受影响)?
  • 目前已尝试了哪些修复措施?从中得出了什么结论?

环境详细信息
  • NetWorker 服务器版本和操作系统平台是什么?
  • NWUI 是安装在 NetWorker 服务器上还是单独的主机上?
    • 如果安装在独立于 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 DEBUG 以进行故障处理

安装问题
有关如何安装 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 服务器本地还是在 NetWorker 服务器之外,上述命令可能会报告某些目录缺失。这是预期行为。主机名和日期不需要更改,上述命令会自动使用服务器的主机名和当前日期 (YYYY-MM-DD) 创建捆绑包。
Windows

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


                  显示 nwui 服务的 tasklist 命令 

您可以通过 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 通信进行调试,请在 NetWorker 服务器上的 logback.xml 文件中更改调试级别:

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 时,右键单击浏览器窗口,然后选择检查

检查

  1. 在浏览器的“检查”窗口中,单击网络选项卡:

浏览器检查网络

  1. 在 NWUI 中执行功能时,操作将显示在名称下。“状态”列包含 REST API 完成状态:API 请求和响应 
  2. 单击要进一步调查的操作。例如,在单击上图中所示的 backups 后,标头选项卡中将显示以下详细信息:

在此处,请求网址、请求方法和状态代码都是可识别的。

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

 

此示例展示了在浏览 Azure 备份并选择要还原的存储集后,用于填充 Recover and Savesets 选项卡的 REST API 响应。

其他信息

受影响的产品

NetWorker

产品

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