NWUI(NetWorker Management Web UI): 분류 및 문제 해결 가이드
Summary: NWUI(NetWorker Management Web UI): 분류 및 문제 해결 가이드
Instructions
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에 있지만 별도의 호스트에 설치할 수 있습니다.
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)가 설치되어 있는지 확인합니다.
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
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
추가 인증 진단이 필요한 경우 다음을 참조하십시오. NetWorker: 문제 해결을 위해 AUTHC DEBUG를 활성화하는 방법
설치 문제
설치하는 방법
중요한 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
NetWorker Server에 로컬:
/opt/nwui/logs/nsr/authc/logs//nsr/logs/restapi/restapi.log/nsr/logs/daemon.raw/nsr/nwui/monitoring/app/logs/
/opt/nwui/logs/nsr/nwui/logs
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 NWUI 백엔드 프로세스를 nwuictld.exe
services.msc:
로컬 - NetWorker Server
C:\Program Files\EMC NetWorker\nwui\logs\C:\Program Files\EMC NetWorker\nsr\authc-server\logsC:\Program Files\EMC NetWorker\nsr\restapi\restapi.logC:\Program Files\EMC NetWorker\nsr\logs\daemon.rawC:\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: NSRGet NetWorker 데이터 수집 툴
을 사용하는 방법가장 관련성이 높은 로그는 NWUI에서 시도하는 작업에 따라 달라집니다. NetWorker 로그에 대한 자세한 내용은 다음을
참조하십시오.Networker: 로그 파일 및 위치
디버깅
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
자세한 내용은 다음을 참조하십시오. NetWorker: REST API 디버깅을 활성화하는 방법
REST API
NWUI는 REST API를 사용하여 NetWorker와 상호 작용합니다. NWUI 및 REST API 로그에는 API 기능과 NetWorker 응답이 표시되지만 이 정보는 브라우저에서 직접 확인할 수도 있습니다. 이 방법은 UI와 NetWorker CLI 간의 불일치를 찾거나 UI에서 예상된 결과를 반환하지 않는 경우에 유용합니다.
- NWUI에 액세스하는 동안 브라우저 창을 마우스 오른쪽 버튼으로 클릭하고 검사를 선택합니다.

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

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


이를 통해 요청 URL, 요청 방법 및 상태 코드를 모두 식별할 수 있습니다.
- 응답 페이로드를 보려면 응답 탭을 클릭합니다.
이 예에서는 Azure 백업을 탐색하고 복원할 세이브 세트를 선택한 후 복구 및 세이브 세트 탭을 채우는 데 사용되는 REST API 응답을 보여 줍니다.
Additional Information
NWUI 리소스
NWUI(NetWorker Management Web UI): 이용
방법NWUI(NetWorker Management Web UI): 설치하는
방법NWUI(NetWorker Management Web UI): 분류 및 문제 해결 가이드