Веб-интерфейс управления NetWorker: Руководство по сортировке и поиску и устранению неисправностей

Принцип работы NWUI

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

Есть четыре важных компонента. Эти компоненты могут находиться на одном хосте или на отдельных хостах.

• Внешний веб-интерфейс. Это уровень презентации, написанный в 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. Шина сообщений сервера NetWorker RabbitMQ также используется для взаимодействия с nsrjobd.
• AUTHC. Компонент AUTHC NetWorker используется для всех задач аутентификации. Запрашивающий процесс связывается с AUTHC для проверки учетных данных; После проверки AUTHC выпускает токен с привязкой ко времени, подписью и шифрованием. Компоненты NetWorker используют этот токен для проверки пользователя и разрешения или запрещения запрошенной операции. Обычно это происходит на сервере NetWorker, но его можно установить на отдельном хосте. 

В большинстве случаев связь осуществляется с использованием API REST, который позволяет взаимодействовать с ресурсами, определенными по адресам унифицированного идентификатора ресурса (URI). HTTP-операции (HEAD, GET, PUT, POST, DELETE) используются для взаимодействия с унифицированными идентификаторами ресурса (URI) без отслеживания состояния.

Эти вызовы API REST являются внутренними для операций NetWorker и NWUI. Не следует путать их с 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
  • Какой пакет Java установлен на сервере NWUI? Установлена операционная среда NetWorker (NRE) или операционная среда Oracle Java (JRE)?
    • NRE 8.x: Очистка кэша Java, включение консоли Java и отладки.
    • NRE 17.x: Очистка кэша Java, включение консоли Java и отладка
• Распространенные проблемы:
  • Проблемы аутентификации: Аутентификация использует AUTHC так же, как NetWorker Management Console использует команду nsrlogin . 
    Для устранения проблем аутентификации сначала проверьте аутентификацию на сервере 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 (NWUI). Как установить
  • Проблемы с пользовательским интерфейсом. Важные журналы внутреннего интерфейса пользователя:

Если сервер NWUI находится на самом сервере NetWorker, он использует тот же экземпляр tomcat с NetWorker.

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

Файлы журнала:

Linux:

Процессы, которые выполняются для внутреннего интерфейса пользователя: 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

Внутренний процесс NWUI Windows, который должен быть запущен, называется 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 из 20MB на 100MB
2. Измените параметр root level из INFO на DEBUG

3. Перезапустите службу NWUI.

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

Проверьте консоль веб-браузера.

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

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

2. В окне «Inspect» браузера перейдите на вкладку Network:

3. Операции отображаются в поле «Имя» при выполнении функций в NWUI. В столбце Status отображается состояние завершения API REST: Запрос и ответ API
4. Нажмите на операцию, которую необходимо изучить дополнительно. Например, при нажатии функции backups, показанной выше, на вкладке Headers отображаются следующие сведения:

По этим данным можно идентифицировать URL-адрес запроса, метод запроса и код состояния.

5. Чтобы просмотреть полезную нагрузку ответа, нажмите на вкладку Responses.

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

Ресурсы NWUI

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