NetWorker Management Web UI (NWUI):分流和故障处理指南
摘要: NetWorker Management Web UI (NWUI):分流和故障处理指南
说明
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 服务器上,但也可以安装在单独的主机上。
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)?
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
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
如果需要进行进一步的身份验证诊断,请参阅: NetWorker:如何启用 AUTHC DEBUG 以进行故障处理
安装问题
NetWorker Management Web UI (NWUI):如何安装
重要的 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
NetWorker 服务器本地:
/opt/nwui/logs/nsr/authc/logs//nsr/logs/restapi/restapi.log/nsr/logs/daemon.raw/nsr/nwui/monitoring/app/logs/
/opt/nwui/logs/nsr/nwui/logs
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 NWUI 后端进程称为 nwuictld.exe:
services.msc管理此进程:
NetWorker 服务器本地
C:\Program Files\EMC NetWorker\nwui\logs\C:\Program Files\EMC NetWorker\nsr\authc-server\logsC:\Program Files\EMC NetWorker\nsr\restapi\restapi.logC:\Program Files\EMC NetWorker\nsr\logs\daemon.rawC:\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:如何使用 NSRGet NetWorker 数据收集工具
最相关的日志取决于通过 NWUI 尝试执行的操作。有关 NetWorker 日志的更多信息,请参阅:
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
请参阅:NetWorker:如何启用 REST API 调试
REST API
NWUI 使用 REST API 与 NetWorker 进行交互。NWUI 和 REST API 日志中显示了 API 函数及 NetWorker 响应,但这些信息也可以直接在浏览器中查看。此方法可用于发现 UI 与 NetWorker CLI 之间的差异,也适用于 UI 未返回预期结果的情况。
- 在访问 NWUI 时,右键单击浏览器窗口,然后选择检查。

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

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


在此处,请求网址、请求方法和状态代码都是可识别的。
- 要查看响应有效负载,请单击响应选项卡。
此示例展示了在浏览 Azure 备份并选择要还原的存储集后,用于填充 Recover and Savesets 选项卡的 REST API 响应。
其他信息
NWUI 资源
NetWorker Management Web UI (NWUI): 如何使用
NetWorker Management Web UI (NWUI): 如何安装
NetWorker Management Web UI (NWUI):分流和故障处理指南