NetWorker Management Web UI：分流和故障处理指南

NWUI 的工作方式

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

有四个重要组成部分。这些组件可以位于同一主机上，也可以位于不同的主机上。

• 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 调用是内部调用。请勿将它们与 NetWorker REST API 混淆，后者支持自定义操作，并在《NetWorker REST API 开发人员指南》中进行了介绍。

故障处理

定义问题

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

• 环境详细信息： 
  • NetWorker 服务器版本和操作系统平台是什么？NetWorker：识别 NetWorker 软件版本的方法
  • NWUI 是安装在 NetWorker 服务器上还是单独的主机上？
    • 如果安装在独立于 NetWorker 服务器的主机上，NWUI 服务器版本是什么？
  • NWUI 服务器是使用本地 NetWorker 服务器进行身份验证 （AUTHC），还是使用了单独的 AUTHC 服务器：NetWorker：如何确定哪个服务器是 NMC 和 NWUI 使用的身份验证服务器
  • NWUI 服务器上安装了哪种 Java 软件包？是 NetWorker Runtime Environment (NRE) 还是 Oracle Java Runtime Environment (JRE)？
    • NRE 8.x：如何清除 Java 高速缓存、启用 Java 控制台和调试。
    • NRE 17.x：如何清除 Java 高速缓存、启用 Java 控制台和调试
• 常见问题：
  • 身份验证问题：身份验证使用 AUTHC 的方式与 NetWorker Management Console 及 nsrlogin 命令验证每个 SP 是处于正常模式还是修复模式。
    对于身份验证问题，首先在 NetWorker 服务器上测试身份验证，以确定问题与 NWUI 还是服务器本身相关。如果使用 AD 或 LDAP 进行身份验证，请首先使用本地 NetWorker 帐户进行测试，以确认问题是否仅影响外部身份验证。
    用于测试身份验证过程是否按预期方式在 NetWorker 服务器上工作的典型命令为： 

authc_mgmt -u [user name] -p [password] -e find-all-users.

nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout

nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout

• • 安装问题：有关如何安装 NWUI 以及在安装出现问题时要查阅哪些日志的详细信息，请参阅以下文章：NetWorker Management Web UI (NWUI)：如何安装
  • UI 后端问题：重要的 UI 后端日志包括：

如果 NWUI 服务器位于 NetWorker 服务器本身上，则它将与 NetWorker 共享相同的 tomcat 实例。

如果您要提供 .raw 日志文件，建议在生成该日志文件的源系统上对其进行转换操作。这可确保以服务器的本地时间呈现时间戳：NetWorker：如何使用 nsr_render_log

日志文件：

Linux：

为 UI 后端运行的进程包括：code>/opt/nwui/bin/nwuictld 和 jsvc.exec。您可以使用 ps 命令检查它们是否正在运行：

ps -ef | grep nwui

• 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

Windows

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

您可以通过 services.msc管理此进程：

日志如下：

• 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 服务器

运行 NSRGET NetWorker 服务器上的工具，用于收集相关日志：NetWorker：如何使用 NSRGet NetWorker 数据收集工具 

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

调试

NWUI 日志记录级别在以下文件中定义：

• Windows（默认值）： C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwui\WEB-INF\classes\logback.xml
• Linux： /nsr/authc/webapps/nwui/WEB-INF/classes/logback.xml

1. 增加 maxFileSize from 20MB 重定向到 100MB
2. 将 root level from INFO 重定向到 DEBUG

3. 重新启动 NWUI 服务：

• Linux： systemctl restart nwui
• Windows (PowerShell)： net stop nwui ; net start nwui

Web 浏览器检查控制台。

NWUI 使用 API 函数和 NetWorker 响应，但也可以直接在浏览器中检查此信息。此方法可用于发现 UI 与 NetWorker CLI 之间的差异，也适用于 UI 未返回预期结果的情况。 

1. 在访问 NWUI 时，右键单击浏览器窗口，然后选择检查。

2. 在浏览器的“检查”窗口中，单击网络选项卡：

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

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

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

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

NWUI 资源

• NetWorker Management Web UI (NWUI)：如何使用             
• NetWorker Management Web UI (NWUI)：如何安装          
• NetWorker Management Web UI (NWUI)：分流和故障处理指南