Веб-интерфейс управления NetWorker (NWUI). Руководство по рассмотрению проблем и устранению неполадок

Summary: Веб-интерфейс управления NetWorker (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 (NWUI) используются следующие технологии: HTML5, Apache Tomcat, Spring Framework, Angular Framework и интерфейс прикладного программирования (API) Representational State Transfer (REST). Приложение NWUI можно установить в операционных системах Linux или Windows. Его можно установить либо непосредственно на сервере NetWorker, либо на хосте, который не является сервером NetWorker.


                  kA5f10000004LFmCAM_1_0


Существует четыре важных компонента:
Эти компоненты могут находиться на одном хосте или на отдельных хостах.
  • Веб-интерфейс:  Это уровень представления, написанный на HTML5 и Angular Framework, который представляет операции NetWorker пользователю через веб-браузер. Веб-браузер подключен к внутренним процессам пользовательского интерфейса.
  • Пользовательский интерфейс:  Серверное приложение написано на Spring Framework.  Он использует java и Apache Tomcat. Обмен данными между внешним и внутренним интерфейсами, а также между внутренней частью и сервером NetWorker осуществляется с помощью внутренних вызовов API-интерфейса REST. Процесс NWUI использует существующий экземпляр Apache Tomcat на сервере NetWorker или устанавливает собственный экземпляр Apache Tomcat, если он установлен удаленно с сервера NetWorker.
  • Сервер NetWorker. Инфраструктура REST сервера NetWorker отвечает за получение вызовов API REST из внутреннего интерфейса пользователя и подключение их к основным компонентам сервера NetWorker. Шина сообщений RabbitMQ сервера NetWorker также используется для взаимодействия с nsrjobd.
  • AuthC: Компонент authc NetWorker используется для всех задач аутентификации. Запрашивающий процесс связывается с AuthC для проверки учетных данных; После проверки AuthC выпускает токен с привязкой ко времени, подписью и шифрованием. Компоненты NetWorker используют этот маркер для проверки пользователя и авторизации или отказа от выполнения запрошенной операции. Обычно это происходит на сервере NetWorker, но может быть установлен на другом хосте. 
Большая часть обмена данными осуществляется с помощью REST API, который позволяет взаимодействовать с ресурсами, определяемыми адресами универсального кода ресурса (URI). Он использует команды HTTP (HEAD, GET, PUT, POST, DELETE) для взаимодействия с универсальным кодом ресурса (URI) без сохранения состояния. Эти вызовы API REST являются внутренними для операций NetWorker и NWUI. Их не следует путать с интерфейсом NetWorker REST API, который предоставляет программный доступ к NetWorker для программирования пользовательских операций, описанных в руководстве разработчика NetWorker REST API.
 

Поиск и устранение неполадок

Определение проблемы

СВЕДЕНИЯ О ПРОБЛЕМЕ
Чтобы составить полное описание проблемы, рассмотрите следующие вопросы:
  • Какая предпринимается попытка выполнить операцию, но она не работает?
  • Работает ли эта операция, если она инициирована из-за пределов NWUI (например: В консоли управления NetWorker Management Console (NMC)?
  • Проблема возникает постоянно или носит периодический характер?
  • Если время прерывается, известен ли какой-либо триггер?
  • Работал ли этот процесс лучше раньше, и если да, то есть ли какие-либо известные изменения, примененные до и после появления проблемы?
  • Когда впервые возникла проблема (и что изменилось с момента ее появления)?
  • Возникает ли эта проблема только при высокой нагрузке на среду резервного копирования?
  • В чем заключается проблема (все операции восстановления или некоторые операции восстановления, некоторые вкладки не работают, другие не затрагиваются)?
  • Что удалось исправить до сих пор и какие выводы из этого были сделаны?

СВЕДЕНИЯ ОБ ИНФРАСТРУКТУРЕ
  • Какова версия сервера NetWorker и платформа операционной системы?
  • NWUI установлен на сервере NetWorker или на отдельном хосте?
    • Какова версия NWUI, если она установлена на хосте, отдельном от сервера NetWorker?
  • Какой Java-пакет установлен на NWUI-сервере; установлена NetWorker Runtime Environment (NRE) или Oracle Java Runtime Environment (JRE).
Аутентификация
Аутентификация использует AuthC так же, как NetWorker Management Console и команда 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 (NWUI): Как установить
 
Проблемы на стороне браузера
Если установлено несколько браузеров, проверьте наблюдаемую проблему в разных браузерах, чтобы определить, связана ли проблема с одним браузером.

В браузере нажмите правой кнопкой мыши и выберите «Inspect», чтобы просмотреть вызовы REST API, выполняемые из браузера, а также инструкции журнала и информацию о сетевом подключении.
  • Щелкните правой кнопкой мыши в любом месте окна браузера и выберите «Проверить».
  • Откроется новое окно с несколькими вкладками.  Вкладки «Консоль» и «Сеть», вероятно, будут самыми полезными.
  • С помощью этих вкладок можно увидеть точные вызовы API REST, которые выполняются на сервере NetWorker. 
  • На вкладке network также можно увидеть метод запроса и ответ REST API от сервера NetWorker. Таким образом, можно точно отследить, что запрашивается у сервера NetWorker и как именно сервер NetWorker отвечает на этот запрос.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Проблемы с пользовательским интерфейсом

Важными внутренними журналами пользовательского интерфейса:
    catalina.log — ведение журналов сервера Tomcat и ведение журналов развертывания приложений.
    nwui.log — ведение журнала сервера приложений NWUI.
    restapi.log — ведение журнала NetWorker REST API.  NWUI обменивается данными с сервером NetWorker с помощью NetWorker REST API.
    daemon.raw — ведение журнала сервера NetWorker.

Расположение этих файлов журнала зависит от используемой операционной системы, а также от того, является ли установка NWUI локальной на сервере NetWorker или удаленной.  Если NWUI находится на самом сервере NetWorker, то он использует тот же экземпляр tomcat с NetWorker.
Если вы предоставляете .raw файл журнала в службу поддержки, рекомендуется выполнить отображение этого файла журнала в системе, из которой он был получен. Это гарантирует, что временные метки отображаются по местному времени сервера: NetWorker. Способ применения nsr_render_log

Файлы журналов

Linux:

Ниже перечислены процессы, выполняемые во внутреннем интерфейсе пользователя.  /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                  
Виндоус

Внутренний процесс NWUI Windows, который должен быть запущен, называется nwuictld.exe:


                  kA5f10000004LFmCAM_1_5

Управлять этим можно на сайте 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

Запустите инструмент nsrget на сервере NetWorker, чтобы собрать соответствующие журналы:
NetWorker. Использование средства

сбора данных NSRGet NetWorker
Наиболее релевантные журналы зависят от операции, выполняемой из NWUI. Дополнительные сведения о журналах NetWorker см. в разделе:
NetWorker. Файлы журнала и местоположения

Отладка

Для отладки связи по API-интерфейсу REST измените уровень отладки в файле logback.xml на сервере NetWorker:Windows:

C:Program FilesEMC NetWorker srauthc-server omcatwebapps wrestapiWEB-INFclasses
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  kA5f10000004LFmCAM_1_7

Раскомментируйте строки, относящиеся к журналу вызовов API. В результате для запросов и ответов API REST устанавливается уровень ведения журнала «трассировка».

                  kA5f10000004LFmCAM_1_8

Additional Information

Affected Products

NetWorker

Products

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