NetWorker Management Web UI (NWUI): Посібник з сортування та усунення несправностей

Summary: NetWorker Management Web UI (NWUI): Посібник з сортування та усунення несправностей

Ця стаття стосується Ця стаття не стосується Ця стаття не стосується якогось конкретного продукту. У цій статті зазначено не всі версії продукту.

Instructions

Як працює NWUI

Веб-інтерфейс користувача NetWorker (NWUI) використовує такі технології: HTML5, Apache Tomcat, Spring Framework, Angular Framework та інтерфейс програмування застосунків (REST). Додаток NWUI можна встановити на операційні системи Linux або Windows. Його можна встановити безпосередньо на сервер NetWorker або на хост, який не є сервером NetWorker.


                  Складові NWUI 


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

Усунення несправностей

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

ДЕТАЛІ ВИПУСКУ

Щоб отримати повний опис проблеми, розглянемо наступні питання:

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

Поширені проблеми:

ПРОБЛЕМИ АВТЕНТИФІКАЦІЇ:
Автентифікація використовує 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): Як встановити                   

 

ПРОБЛЕМИ З ІНТЕРФЕЙСОМ БЕКЕНДУ:

Важливі журнали бекенду інтерфейсу такі:
Шлях 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 NWUI взаємодіє з сервером NetWorker через REST API NetWorker. Дивіться розділ 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, наведена вище команда може повідомляти про відсутність деяких каталогів. Це очікувано. Ім'я хоста та дата не потрібно змінювати, наведена вище команда автоматично створює пакет із ім'ям хоста сервера та поточною датою (YYYY-MM-DD).

Windows

Бекенд-процес Windows NWUI, який має працювати, називається nwuictld.exe:

 Tasklist, що показує сервіс 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 Server

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

Див. також: NetWorker: Як увімкнути налагодження REST API

REST API

NWUI використовує REST API для взаємодії з NetWorker. Журнали NWUI та REST API показують функції API та відповіді NetWorker, але цю інформацію також можна перевірити безпосередньо в браузері. Цей метод корисний для виявлення розбіжностей між інтерфейсами та CLI NetWorker або коли інтерфейс не повертає очікуваних результатів. 

 

  1. Під час доступу до NWUI клацніть правою кнопкою миші у вікні браузера та виберіть Inspect.

Огляд веб-браузера

  1. У вікні браузера «Інспект» натисніть вкладку «Мережа »:

Браузерна інспекційна мережа

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

З цього можна ідентифікувати URL запиту, метод запиту та статус коду.

  1. Щоб побачити корисне навантаження відповідей, натисніть вкладку «Відповіді».

 

Цей приклад показує відповідь REST API для заповнення вкладок Recover та Savesets після перегляду резервних копій Azure і вибору набору збережень для відновлення.

Additional Information

Продукти, яких це стосується

NetWorker

Продукти

NetWorker, NetWorker Series
Властивості статті
Article Number: 000010592
Article Type: How To
Востаннє змінено: 07 трав. 2026
Version:  7
Отримайте відповіді на свої запитання від інших користувачів Dell
Служба підтримки
Перевірте, чи послуги служби підтримки поширюються на ваш пристрій.