Веб-интерфейс управления 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.


                  Компоненты NWUI 


Существует четыре важных компонента:
Эти компоненты могут находиться на одном хосте или на отдельных хостах.
  • Веб-интерфейс:  Это уровень представления, написанный на 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.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1 пиксель сплошной #e6e6e6; } tr th { background-color: #f5f5f5; } Не путайте их с NetWorker REST API, который позволяет выполнять пользовательские операции и описан в Руководстве разработчика 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): Как установить                   

 

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

Важными внутренними журналами пользовательского интерфейса:
Путь для 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 с помощью NetWorker REST API. См. раздел REST API в этой статье, чтобы узнать, как диагностировать используемые функции REST API, а также соответствующий ответ.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw Ведение журнала сервера NetWorker.

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

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

Linux:

Ниже перечислены процессы, выполняемые во внутреннем интерфейсе пользователя.  /opt/nwui/bin/nwuictld и jsvc.exec Вы можете проверить, работают ли они, с помощью команды ps :
ps -ef | grep nwui
                  Вывод ps, показывающий серверную часть 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
ПРИМЕЧАНИЕ. В зависимости от того, является ли NWUI локальным или удаленным для сервера NetWorker, вышеуказанная команда может сообщить об отсутствии некоторых каталогов. Это ожидаемое поведение. Имя хоста и дату изменять не нужно, вышеуказанная команда автоматически создает пакет с именем хоста сервера и текущей датой (ГГГГ-ММ-ДД).
Windows

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


                  Список задач, показывающий службу NWUI 

Этим можно управлять с помощью services.msc.

                  консоль служб, показывающая NWUI 
 

Журналы находятся здесь:

Локальный на сервер 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 по умолчанию. Если NetWorker был установлен на другом диске или с использованием другого пути, внесите соответствующие изменения.
 
Сервер NetWorker

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

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

Отладка

Для отладки связи по интерфейсу REST API измените уровень отладки в 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


                  Файл logback 

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

                  Параметры отладки 

Видеть: NetWorker. Включение отладки по API-интерфейсу REST

 

API REST

NWUI использует API REST для взаимодействия с NetWorker. Журналы NWUI и REST API показывают функции API и ответы NetWorker, но эту информацию также можно проверить непосредственно в браузере. Этот метод полезен для поиска несоответствий между пользовательскими интерфейсами и интерфейсом командной строки NetWorker, а также в случаях, когда пользовательский интерфейс не возвращает ожидаемых результатов. 

 

  1. При доступе к NWUI щелкните правой кнопкой мыши в окне браузера и выберите Проверить.

Проверить

  1. В окне браузера «Inspect» нажмите на вкладку « Network »:

Проверка сети в браузере

  1. При выполнении функций в NWUI операции отображаются в поле Имя. В столбце «Состояние» отображается состояние завершения API-интерфейса REST: Запрос и ответ API 
  2. Выберите операцию, которую необходимо изучить подробнее. Например, при нажатии на функцию резервного копирования , показанную выше, на вкладке «Заголовки » отображаются следующие сведения:

Таким образом, можно определить URL-адрес запроса, метод запроса и код состояния.

  1. Чтобы просмотреть полезные данные ответа, перейдите на вкладку Ответы .

 

В этом примере показан ответ API REST, используемый для заполнения вкладки Восстановление и наборы сохранений после просмотра резервных копий Azure и выбора набора сохранений для восстановления.

Additional Information

Affected Products

NetWorker

Products

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