NetWorker Management Web UI (NWUI):分流和故障处理指南
摘要: NetWorker Management Web UI (NWUI):分流和故障处理指南
说明
NWUI 的工作原理
有四个重要组成部分:
这些组件可以位于同一主机上,也可以位于不同的主机上。
- 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 服务器上,但可以安装在单独的主机上。
a { text-decoration: none; color:#464feb;} TR TH, TR TD { BORDER:1px 实心 #e6e6e6;} tr th { background-color:#f5f5f5;}不要将它们与 NetWorker REST API 混淆,后者支持自定义作,并记录在《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)。
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 调试以进行故障排除
安装问题
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 NetWorker 服务器上的文件:
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 时,右键单击浏览器窗口,然后选择 Inspect。

- 在浏览器的“Inspect”窗口中,单击 Network 选项卡:

- 在 NWUI 中执行功能时,作将显示 在名称下。Status列包括 REST API 完成状态:API 请求和响应
- 单击要进一步调查的作。例如,通过单击上面所示 的备份 功能, Headers 选项卡中会显示以下详细信息:


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