Веб-інтерфейс управління NetWorker: Посібник з сортування та усунення несправностей

Як працює NWUI

Веб-інтерфейс користувача NetWorker (NWUI) використовує такі технології: HTML5, Apache Tomcat, Spring Framework, Angular Framework та інтерфейс програмування застосунків (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 Server: Фреймворк NetWorker Server REST відповідає за отримання викликів REST API з бекенду інтерфейсу та їх підключення до основних компонентів сервера NetWorker. Для взаємодії з nsrjobd також використовується шина повідомлень NetWorker Server RabbitMQ.
• 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)?
  • Чи є проблема постійною чи періодичною?
  • Якщо це періодично, чи відомий тригер?
  • Чи працювало це краще раніше, і якщо так, чи були якісь відомі зміни до і після появи проблеми?
  • Коли вперше виникла проблема (і що змінилося з моменту її появи)?
  • Чи виникає проблема лише під час великого навантаження на резервне середовище?
  • Який масштаб проблеми (всі операції відновлення або деякі операції відновлення, деякі вкладки не працюють, а інші не зачеплені)?
  • Що досі намагалися виправити і які висновки з цього зроблено?

• Деталі навколишнього середовища: 
  • Яка версія сервера NetWorker та платформа операційної системи? NetWorker: Методи ідентифікації версії програмного забезпечення NetWorker
  • NWUI встановлений на сервері NetWorker чи на окремому хості?
    • Якщо встановити на хост, окремий від сервера NetWorker, яка версія сервера NWUI?
  • Чи використовує сервер NWUI локальний сервер NetWorker для автентифікації (AUTHC), чи це окремий сервер AUTHC: NetWorker: Як визначити, який сервер є сервером автентифікації, який використовують NMC та NWUI
  • Який Java-пакет встановлений на сервері NWUI; чи встановлено NetWorker Runtime Environment (NRE) або Oracle Java Runtime Environment (JRE).
    • NRE 8.x: Як очистити кеш Java, увімкнути Java Console та налагодження.
    • NRE 17.x: Як очистити кеш Java, увімкнути Java Console та налагодити
• Поширені проблеми:
  • Проблеми з автентифікацією: Автентифікація використовує AUTHC так само, як і консоль управління NetWorker та 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 Management Web UI (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

Бекенд-процес Windows NWUI, який має працювати, називається 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 Server

Запусти 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

Веб-браузер Inspect Console.

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

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

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

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

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

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

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

Ресурси NWUI

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