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


                  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

其他資訊

NWUI 资源


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

受影響的產品

NetWorker

產品

NetWorker, NetWorker Series
文章屬性
文章編號: 000010592
文章類型: How To
上次修改時間: 08 5月 2025
版本:  4
向其他 Dell 使用者尋求您問題的答案
支援服務
檢查您的裝置是否在支援服務的涵蓋範圍內。