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.
Check out other resources

Instructions

NWUI 작동 방식

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


                  NWUI의 구성 요소 


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

a { text-decoration: none; color: #464feb; } tr th, tr td { border: 1px solid #e6e6e6; } tr th { background-color: #f5f5f5; } 맞춤형 작업을 지원하는 NetWorker REST API와 혼동하지 마십시오. NetWorker REST API 개발자 가이드에 설명되어 있습니다.

문제 해결

문제 정의

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

환경 세부 정보
  • NetWorker 서버 버전 및 운영 체제 플랫폼은 무엇입니까?
  • NWUI가 NetWorker 서버 또는 별도의 호스트에 설치되어 있습니까?
    • NetWorker 서버와 별도의 호스트에 설치된 경우 NWUI 버전은 무엇입니까?
  • NWUI 서버에 설치된 Java 패키지, NRE(NetWorker Runtime Environment)가 설치되어 있는지 또는 Oracle JRE(Java Runtime Environment)가 설치되어 있는지 여부
인증
인증은 NetWorker Management Console 및 nsrlogin 명령어와 동일한 방식으로 AUTHC를 사용합니다. 인증 문제의 경우 먼저 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를 설치하는 방법과 설치 문제가 있는 경우 참조할 로그에 대한 자세한 내용은 다음 문서를 참조하십시오.
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 Server와 통신합니다. 사용 중인 REST API 기능과 해당 응답을 진단하는 방법을 보려면 이 문서의 REST API 섹션을 참조하십시오.
/nsr/logs/daemon.raw C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw NetWorker 서버 로깅

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

로그 파일

Linux:

UI 백엔드에 대해 실행되는 프로세스는 다음과 같습니다.  /opt/nwui/bin/nwuictld 및 jsvc.exec 해당 프로세스가 실행 중인지 ps 명령어로 확인할 수 있습니다. 
ps -ef | grep nwui
                  NWUI 백엔드를 보여주는 PS 출력 
로그는 다음과 같습니다.

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

실행 중인 Windows NWUI 백엔드 프로세스를 nwuictld.exe라고 합니다.


                  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 서버

NetWorker Server에서 nsrget 툴을 실행하여 관련 로그를 수집합니다.
NetWorker: NSRGet NetWorker 데이터 수집 툴 사용 방법

가장 관련성이 높은 로그는 NWUI에서 시도하는 작업에 따라 달라집니다. NetWorker 로그에 대한 자세한 내용은 다음을 참조하십시오.
NetWorker: 로그 파일 및 위치

디버깅

REST API 통신을 디버깅하려면 NetWorker 서버의 logback.xml 파일에서 디버그 수준을 변경합니다.

Windows(기본값): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes


                  로그백 파일 

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

                  디버그 설정 

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

 

REST API

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

 

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

검사

  1. 브라우저의 "Inspect" 창에서 Network 탭을 클릭합니다.

브라우저 네트워크 검사

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

여기에서 요청 URL, 요청 방법 및 상태 코드를 모두 식별할 수 있습니다.

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

 

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

Additional Information

NWUI 리소스

NWUI(NetWorker Management Web UI):  NWUI(NetWorker Management Web UI)             
사용 방법:  NWUI(NetWorker Management Web UI)          
설치 방법: 분류 및 문제 해결 가이드

Affected Products

NetWorker

Products

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