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

Summary: NetWorker Management Web UI (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.
Check out other resources

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.

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px суцільний #e6e6e6; } tr th { фоновий колір: #f5f5f5; } Не плутайте їх із 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): Як встановити                   

 

Проблеми з бекендом інтерфейсу

Важливі журнали бекенду інтерфейсу такі:
Шлях 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 Логування REST API NetWorker. 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 sever):
  • /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

Ресурси NWUI

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

Affected Products

NetWorker

Products

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