NWUI(NetWorker Management Web UI): 분류 및 문제 해결 가이드

Summary: NWUI(NetWorker Management Web UI): 분류 및 문제 해결 가이드

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의 작동 방식

NWUI(NetWorker Web User Interface)는 다음 기술을 사용합니다. HTML5, Apache Tomcat, Spring Framework, Angular Framework 및 REST(Representational State Transfer) API(Application Programming Interface). NWUI 애플리케이션은 Linux 또는 Windows 운영 체제에 설치할 수 있습니다. NetWorker Server에 직접 설치하거나 NetWorker Server가 아닌 호스트에 설치할 수 있습니다.


                  NWUI의 구성 요소 


다음과 같은 네 가지 중요한 구성 요소가
있습니다.이러한 구성 요소는 동일한 호스트에 있거나 별개의 호스트에 있을 수 있습니다.
  • 웹 프런트엔드:  HTML5 및 Angular Framework로 작성된 프레젠테이션 계층으로, 웹 브라우저를 통해 사용자에게 NetWorker 작업을 제공합니다. 웹 브라우저는 UI 백엔드 프로세스에 연결됩니다.
  • UI 백엔드:  백엔드 애플리케이션은 Spring Framework로 작성되었습니다.  Java와 Apache Tomcat을 사용합니다. 프런트엔드와 백엔드 간, 백엔드와 NetWorker Server 간의 통신은 내부 REST API 호출을 사용하여 수행됩니다. NWUI 프로세스에서는 NetWorker Server의 기존 Apache Tomcat 인스턴스를 사용하거나, NetWorker Server에서 원격으로 설치된 경우 자체 Apache Tomcat 인스턴스를 설치합니다.
  • NetWorker 서버: NetWorker Server REST 프레임워크는 UI 백엔드에서 REST API 호출을 수신하여 NetWorker Server의 핵심 구성 요소에 연결하는 역할을 합니다. NetWorker Server RabbitMQ 메시지 버스는 nsrjobd와의 상호 작용에도 사용됩니다.
  • 인증: NetWorker의 AUTHC 구성 요소는 모든 인증 요구 사항에 사용됩니다. 요청 프로세스는 AuthC에 연결하여 자격 증명을 확인합니다. 검증 시 AuthC는 시간 기반, 서명 및 암호화된 토큰을 발급합니다. NetWorker 구성 요소에서는 이 토큰을 사용하여 사용자를 확인하고 요청된 작업을 승인하거나 승인하지 않습니다. 일반적으로 NetWorker Server에 있지만 별도의 호스트에 설치할 수 있습니다. 
대부분의 통신은 URI(Uniform Resource Identifier) 주소로 식별되는 리소스와 상호 작용할 수 있는 REST API를 사용합니다. HTTP 동사(HEAD, GET, PUT, POST, DELETE)를 사용하여 상태 비저장 방식으로 URI(Uniform Resource Identifier)와 상호 작용합니다. 이러한 REST API 호출은 NetWorker 및 NWUI 작업 내부에서 이루어집니다.

a { 텍스트 장식: 없음; 색상: #464feb; } tr th, tr td { 테두리: 1px 솔리드 #e6e6e6; } tr th { 배경색: #f5f5f5; } NetWorker REST API와 혼동하지 마십시오. NetWorker REST API는 사용자 지정 작업을 지원하고 NetWorker REST API 개발자 가이드에 설명되어 있습니다.

문제 해결

문제 정의

문제 세부 정보
완전한 문제 설명을 생성하려면 다음 질문을 고려하십시오.
  • 시도 중인 작업 중 작동하지 않는 작업은 무엇입니까?
  • 이 작업은 NWUI 외부에서 시작될 때 작동합니까(예: NMC(NetWorker Management Console)에서?
  • 문제가 지속적입니까, 아니면 간헐적입니까?
  • 간헐적으로 발생하는 경우 알려진 트리거가 있습니까?
  • 이 방법이 이전에 더 잘 작동했습니까? 그렇다면 문제가 나타나기 전후에 알려진 변경 사항이 적용되었습니까?
  • 문제가 처음 발생한 시기(및 문제가 나타난 이후 변경된 내용)?
  • 백업 환경에 로드가 많을 때만 문제가 발생합니까?
  • 문제의 범위는 무엇입니까(모든 복구 작업 또는 일부 복구 작업, 일부 탭은 작동하지 않지만 다른 탭은 영향을 받지 않음)?
  • 지금까지 무엇을 고치기 위해 시도되었으며 이를 통해 어떤 결론을 도출 받았습니까?

환경 세부 정보
  • NetWorker Server 버전 및 운영 체제 플랫폼은 무엇입니까?
  • NWUI가 NetWorker Server에 설치되어 있습니까? 아니면 별도의 호스트에 설치되어 있습니까?
    • NetWorker Server와 별도의 호스트에 설치된 경우 NWUI 버전은 무엇입니까?
  • NWUI 서버에 설치된 Java 패키지 NRE(NetWorker Runtime Environment)가 설치되어 있는지 또는 Oracle JRE(Java Runtime Environment)가 설치되어 있는지 확인합니다.
인증
인증은 NetWorker Management Console 및 nsrlogin 명령을 실행합니다. 인증 문제의 경우 먼저 NetWorker Server에서 인증을 테스트하여 NWUI 또는 서버 자체와 관련된 문제인지 확인합니다. 인증에 AD 또는 LDAP를 사용하는 경우 먼저 로컬 NetWorker 계정으로 테스트하여 문제가 외부 인증에만 영향을 미치는지 확인합니다.

NetWorker Server에서 인증 프로세스가 예상대로 작동하는지 테스트하는 데 사용되는 일반적인 명령은 다음과 같습니다.  
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 설치 방법 및 설치에 문제가 있을 경우 참조할 로그에 대한 자세한 내용은 NWUI(NetWorker Management Web UI) 문서를 참조하십시오.
설치하는 방법
                  

 

UI 백엔드 문제

중요한 UI 백엔드 로그는 다음과 같습니다.
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 NetWorker REST API 로깅. NWUI는 NetWorker REST API를 사용하여 NetWorker 서버와 통신합니다. 해당 응답과 함께 사용 중인 REST API 함수를 진단하는 방법을 보려면 이 문서의 REST API 섹션을 참조하세요.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw NetWorker Server 로깅

NWUI 서버가 NetWorker 서버 자체에 있는 경우 NetWorker와 동일한 tomcat 인스턴스를 공유합니다.
제공 중인 경우 .raw 로그 파일을 지원하려면 로그 파일이 생성된 시스템에서 로그 파일을 렌더링하는 것이 좋습니다. 이렇게 하면 타임스탬프가 서버의 현지 시간으로 렌더링됩니다. NetWorker: nsr_render_log

사용 방법로그 파일

Linux:

UI 백엔드에서 실행되는 프로세스는 다음과 같습니다.  /opt/nwui/bin/nwuictld 및 jsvc.exec 실행 중인지 확인할 수 있습니다. ps 명령을 사용하여 수행됩니다.
ps -ef | grep nwui
                  NWUI 백엔드를 보여주는 ps 출력 
로그는 여기에 있습니다.

NetWorker Server에 로컬:
  • /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 Server에 로컬인지 또는 원격인지에 따라 위의 명령을 실행하면 일부 디렉토리가 누락된 것으로 보고될 수 있습니다. 이는 정상입니다. 호스트 이름과 날짜를 변경할 필요가 없습니다. 위의 명령을 실행하면 서버의 호스트 이름과 현재 날짜(YYYY-MM-DD)가 포함된 번들이 자동으로 생성됩니다.
Windows

실행해야 하는 Windows NWUI 백엔드 프로세스를 nwuictld.exe


                  NWUI 서비스를 보여주는 작업 목록 

다음에서 관리할 수 있습니다. services.msc:

                  NWUI를 보여주는 서비스 콘솔 
 

로그는 여기에 있습니다.

로컬 - NetWorker Server
  • 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 서버

NetWorker Server에서 nsrget 툴을 실행하여 관련 로그를 수집합니다.
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 file) 

API 호출 로깅을 처리하는 줄의 주석 처리를 제거합니다. 이로 인해 REST API 요청 및 응답에 대한 로깅 수준이 '추적'으로 설정됩니다.

                  디버그 설정 

자세한 내용은 다음을 참조하십시오. NetWorker: REST API 디버깅을 활성화하는 방법

 

REST API

NWUI는 REST API를 사용하여 NetWorker와 상호 작용합니다. NWUI 및 REST API 로그에는 API 기능과 NetWorker 응답이 표시되지만 이 정보는 브라우저에서 직접 확인할 수도 있습니다. 이 방법은 UI와 NetWorker CLI 간의 불일치를 찾거나 UI에서 예상된 결과를 반환하지 않는 경우에 유용합니다. 

 

  1. NWUI에 액세스하는 동안 브라우저 창을 마우스 오른쪽 버튼으로 클릭하고 검사를 선택합니다.

검사

  1. 브라우저의 "Inspect(검사)" 창에서 Network(네트워크 ) 탭을 클릭합니다.

브라우저 네트워크 검사

  1. NWUI에서 기능을 수행할 때 이름 아래에 작업이 표시됩니다. Status 열에는 REST API 완료 상태가 포함됩니다. API 요청 및 응답 
  2. 자세히 조사할 작업을 클릭합니다. 예를 들어 위에 표시된 백업 기능을 클릭하면 Headers 탭에 다음 세부 정보가 표시됩니다.

이를 통해 요청 URL, 요청 방법 및 상태 코드를 모두 식별할 수 있습니다.

  1. 응답 페이로드를 보려면 응답 탭을 클릭합니다.

 

이 예에서는 Azure 백업을 탐색하고 복원할 세이브 세트를 선택한 후 복구 및 세이브 세트 탭을 채우는 데 사용되는 REST API 응답을 보여 줍니다.

Additional Information

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.