Принцип работы NWUI
Веб-интерфейс пользователя NetWorker (NWUI) использует следующие технологии: HTML5, Apache Tomcat, Spring Framework, Angular Framework и API-интерфейс REST. Приложение NWUI можно установить в операционных системах Linux или Windows. Его можно установить непосредственно на сервере NetWorker или на хосте, который не является сервером NetWorker.
Существует четыре важных компонента:
Эти компоненты могут быть на одном и том же хосте или на отдельных хостах.
- Внешний веб-интерфейс: Это уровень представления, записанный в HTML5 и Angular Framework, который представляет операции NetWorker пользователю с помощью веб-браузера. Веб-браузер подключен к процессам пользовательского интерфейса.
- Внутренний интерфейс пользователя: Внутреннее приложение записано в Spring Framework. В нем используются Java и Apache Tomcat. Обмен данными между клиентом и внутренним сервером, а также между сервером NetWorker выполняется с помощью внутренних вызовов REST API. Процесс NWUI использует существующий экземпляр Apache Tomcat на сервере NetWorker или устанавливает собственный экземпляр Apache Tomcat, если он установлен удаленно с сервера NetWorker.
- Сервер NetWorker: Платформа REST сервера NetWorker отвечает за прием вызовов API-интерфейса REST из серверной части пользовательского интерфейса и их подключение к основным компонентам сервера NetWorker. Шина сообщений NetWorker Server RabbitMQ также используется для взаимодействия с nsrjobd.
- AuthC: Компонент аутентификации NetWorker используется для всех требований к аутентификации. Процесс запроса связывается с AuthC для проверки учетных данных. после проверки AuthC присваивает токен времени, основанный, подписанный и зашифрованный. Компоненты NetWorker используют этот токен для проверки пользователя и авторизации или не запрашиваемой операции. Обычно это происходит на сервере NetWorker, но может быть установлено на отдельном хосте.
В большинстве коммуникаций используется REST API, который позволяет взаимодействуть с ресурсами,
идентифицированными по адресам URI. Он использует протоколы HTTP (HEAD, GET, PUT, POST, DELETE) для взаимодействия с URI-идентификаторами (URI) без сохранения состояния. Эти вызовы REST API являются внутренними для операций NetWorker и NWUI. Их не следует путать с интерфейсом NetWorker REST API, который обеспечивает программный доступ к NetWorker для программных настраиваемых операций, описанных в Руководстве разработчика NetWorker REST API.
Поиск и устранение неисправностей
Определение проблемы
СВЕДЕНИЯ О ПРОБЛЕМЕ
Чтобы создать полное описание проблемы, рассмотрите следующие вопросы:
- Какая операция пытается выполниться, которая не работает?
- Эта операция выполняется при запуске из внешнего интерфейса NWUI (например: Из консоли netWorker Management Console (NMC)?
- Является ли проблема согласованной или периодичная?
- Если прерывается, существует ли заведомо известный триггер?
- Эта работа работала лучше, и если да, были ли применены известные изменения до и после того, как возникла проблема?
- Когда впервые возникла проблема (и что изменилось с момента появления проблемы)?
- Возникает ли проблема только в периоды высокой нагрузки на среду резервного копирования?
- Какова область действия проблемы (все операции восстановления/некоторые операции восстановления, некоторые вкладки не работают, а другие не затронуты)?
- Что было показано на данный день и какие выводы были извлечены из этого?
СВЕДЕНИЯ ОБ ОКРУЖАЮЩЕЙ СРЕДЕ
- Какова версия сервера NetWorker и платформа операционной системы?
- Установлен ли NWUI на сервере NetWorker или на отдельном хосте?
- Какая версия NWUI установлена на хосте отдельно от сервера NetWorker?
- Какой пакет Java установлен на сервере NWUI? установлена среда выполнения NetWorker (NRE) или Oracle Java Runtime Environment (JRE).
Аутентификация
Аутентификация использует AuthC так же, как консоль управления NetWorker и команда
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
Проблемы с установкой
Проблемы со стороны браузера
Если установлено несколько браузеров, проверьте обнаруженную проблему в разных браузерах, чтобы проверить, связана ли проблема с одним браузером.
В браузере нажмите правой кнопкой мыши и выполните проверку, чтобы просмотреть вызовы REST API, которые выполняются из браузера, а также записи журнала и информацию о сетевом подключении.
- Нажмите правой кнопкой мыши в любом месте окна браузера и выберите «проверить».
- Откроется новое окно с несколькими вкладок. Скорее всего, наиболее полезными будут вкладки «Console» и «Network».
- На этих вкладки можно увидеть точные вызовы REST API, которые выполняются на сервере NetWorker.
- На вкладке «Сеть» также можно просмотреть способ запроса и ответ REST API от сервера NetWorker. Таким образом, мы можем точно отслеживать, что запрашивается сервером NetWorker и как именно сервер NetWorker отвечает на этот запрос.
Проблемы с серверной частью интерфейса
Важные внутренние журналы пользовательского интерфейса:
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:
Журналы находятся здесь:
Local на сервере NetWorker:
- /opt/nwui/logs
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
Удаленный запуск
- /opt/nwui/logs
- /nsr/nwui/logs
Windows
Внутренний процесс Windows NWUI, который должен быть запущен, называется nwuictld.exe:
Этим можно управлять с помощью services.msc:
Журналы находятся здесь:
Local на сервере 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\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[МЕТКА ВРЕМЕНИ].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[МЕТКА ВРЕМЕНИ]_0_MCUI.log
Сервер 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
Удалите строки, которые имеют дело с ведением журнала вызовов API. Это приводит к тому, что для уровня ведения журнала устанавливается значение «trace» для запросов REST API и ответов.