Веб-інтерфейс управління 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) з передачею репрезентативного стану (REST). Додаток NWUI можна встановити на операційні системи Linux або Windows. Він може бути встановлений як безпосередньо на сервері NetWorker, так і на хост, який не є сервером NetWorker.


                  kA5f10000004LFmCAM_1_0


Є чотири важливі складові:
Ці компоненти можуть бути на одному хості або на окремих хостів.
  • Веб-інтерфейс:  Це шар презентації, написаний на HTML5 і Angular Framework, який представляє операції NetWorker користувачеві через веб-браузер. Веб-браузер підключений до внутрішніх процесів інтерфейсу користувача.
  • Модуль інтерфейсу користувача:  Бекенд-додаток написаний на Spring Framework.  Він використовує java і Apache Tomcat. Зв'язок між фронтендом і бекендом, а також між бекендом і сервером NetWorker здійснюється за допомогою внутрішніх викликів REST API. Процес NWUI використовує або існуючий екземпляр Apache Tomcat на сервері NetWorker, або встановлює власний екземпляр Apache Tomcat, якщо він встановлений віддалено з сервера NetWorker.
  • Сервер NetWorker: Фреймворк NetWorker Server REST відповідає за прийом викликів REST API з сервера інтерфейсу користувача та їх підключення до основних компонентів сервера NetWorker. Шина повідомлень NetWorker Server RabbitMQ також використовується для взаємодії з nsrjobd.
  • Авторизація: Компонент authc NetWorker використовується для всіх потреб аутентифікації. Процес запиту зв'язується з AuthC для перевірки облікових даних; після верифікації AuthC видає токен time, based, signed і зашифрований. Компоненти NetWorker використовують цей токен для перевірки користувача і авторизації або несанкціонування запитуваної операції. Зазвичай він знаходиться на сервері NetWorker, але може бути встановлений на окремому хості. 
Більша частина зв'язку відбувається за допомогою REST API, що дозволяє взаємодіяти з ресурсами, визначеними адресами Uniform Resource Identifier (URI). Він використовує дієслова HTTP (HEAD, GET, PUT, POST, DELETE) для взаємодії з уніфікованими ідентифікаторами ресурсів (URI) без стану. Ці виклики REST API є внутрішніми для операцій NetWorker і NWUI. Їх не слід плутати з інтерфейсом NetWorker REST API, який надає програмний доступ до NetWorker для програмування операцій, створених на замовлення, що описано в Посібнику розробника NetWorker REST API.
 

Виправлення неполадок

Визначення питання

ДЕТАЛІ ВИПУСКУ
Для того, щоб згенерувати повний опис проблеми, розгляньте наступні питання:
  • Яку операцію намагаються виконати, яка не працює?
  • Чи працює ця операція, якщо її ініційовано з-за меж NWUI (наприклад: З консолі управління NetWorker (NMC))?
  • Проблема є постійною чи періодичною?
  • Якщо переривчастий, чи є відомий тригер?
  • Чи це працювало краще раніше, і якщо так, то чи були якісь відомі зміни, застосовані до та після появи проблеми?
  • Коли вперше виникла проблема (і що змінилося з моменту її виникнення)?
  • Проблема виникає лише під час великого навантаження на середовище резервного копіювання?
  • Який масштаб проблеми (усі операції відновлення/деякі операції відновлення, деякі вкладки не працюють, а інші не зазнають впливу)?
  • Що вже намагалися виправити до цього часу і які висновки з цього зроблені?

ПОДРОБИЦІ ПРО НАВКОЛИШНЄ СЕРЕДОВИЩЕ
  • Що таке версія сервера NetWorker і платформа операційної системи?
  • Чи встановлено NWUI на сервері NetWorker чи окремому хості?
    • Яка версія NWUI, якщо вона встановлена на хості, окремому від сервера NetWorker?
  • Який пакет Java встановлено на сервері NWUI; встановлено NetWorker Runtime Environment (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
 
Керівництво по налаштуванню безпеки NetWorker містить повну інформацію про те, як працює аутентифікація NetWorker, як її тестувати і як скинути пароль, якщо це необхідно.

Якщо потрібна подальша діагностика автентифікації, дивіться:  NetWorker: Як увімкнути AUTHC DEBUG для усунення несправностей

Проблеми зі встановленням
Детальну інформацію про те, як встановити NWUI і до яких журналів звертатися, якщо виникнуть проблеми зі встановленням, можна знайти в наступній статті:
NetWorker Management Web UI (NWUI): Як встановити
 
Проблеми з боку браузера
Якщо встановлено кілька браузерів, перевірте спостережувану проблему в різних браузерах, щоб з'ясувати, чи проблема характерна для одного браузера.

У браузері натисніть правою кнопкою миші та «перевірте», щоб побачити виклики REST API, які здійснюються з браузера, а також виписки журналу та інформацію про мережеве підключення.
  • Клацніть правою кнопкою миші в будь-якому місці вікна браузера та виберіть «Перевірити»
  • Відкриється нове вікно з декількома вкладками.  Вкладки «Консоль» і «Мережа», ймовірно, будуть найкориснішими.
  • Використовуючи ці вкладки, ми можемо бачити точні виклики REST API, які здійснюються на сервер NetWorker. 
  • У вкладці мережі ми також можемо побачити метод запиту та відповідь REST API від сервера NetWorker. Таким чином, ми можемо простежити, що саме запитується сервером NetWorker і як саме сервер NetWorker відповідає на цей запит.
                  kA5f10000004LFmCAM_1_1
                  kA5f10000004LFmCAM_1_2

 

Проблеми з внутрішнім інтерфейсом користувача

Важливими журналами серверної частини інтерфейсу є такі:
    catalina.log - Журналювання серверів Tomcat і журналів розгортання додатків.
    nwui.log - Журналювання сервера додатків NWUI.
    restapi.log - Ведення журналу по API NetWorker REST.  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_[ЧАСОВА ПОЗНАЧКА].log
  • %LOCALAPPDATA%TempNetWorker_Management_Web_UI_Server_[ЧАСОВА ПОЗНАЧКА]_0_MCUI.log
Сервер NetWorker

Запустіть інструмент nsrget на сервері NetWorker, щоб зібрати відповідні журнали:
NetWorker: Як користуватися інструментом

збору даних NSRGet NetWorker
Найбільш релевантні журнали залежать від операції, яку намагаються виконати з NWUI. Для отримання додаткової інформації про журнали NetWorker дивіться:
NetWorker: Файли журналу та місцезнаходження

Налагодження

Щоб налагодити зв'язок REST API, змініть рівень налагодження у файлі 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. Це призводить до того, що рівень логування встановлюється на 'trace' для запитів і відповідей REST API.

                  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.