Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products

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.

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 Server 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 REST API 界面提供对 NetWorker 编程自定义操作的编程访问,如 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 管理控制台和 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):如何安装
 
浏览器端问题
如果安装了多个浏览器,请在不同的浏览器中测试观察到的问题,以查看问题是否特定于一个浏览器。

在浏览器中,使用右键单击和“检查”,以查看浏览器发出的 REST API 调用以及日志语句和网络连接信息。
  • 右键单击浏览器窗口中的任意位置,然后选择“检查”
  • 此时将打开一个新窗口,其中包含多个选项卡。  “控制台”和“网络”选项卡可能最有用。
  • 使用这些选项卡,我们可以看到对 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/日志
  • /nsr/authc/logs/
  • /nsr/logs/restapi/restapi.log
  • /nsr/logs/daemon.raw
远程:
  • /opt/nwui/日志
  • /nsr/nwui/logs                  
窗户

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

                  kA5f10000004LFmCAM_1_5
您可以从 services.msc 管理此功能:
                  kA5f10000004LFmCAM_1_6
 
日志如下:

本地到 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\logs
  • %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP].log
  • %LOCALAPPDATA%\Temp\NetWorker_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 Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux:/nsr/authc/webapps/nwrestapi/WEB-INF/classes

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

Additional Information

Affected Products

NetWorker

Products

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