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 서버 또는 NetWorker 서버가 아닌 호스트에 직접 설치할 수 있습니다.
4가지 중요한 구성 요소가 있습니다.
이러한 구성 요소는 동일한 호스트 또는 별도의 호스트에 있을 수 있습니다.
- 웹 프런트엔드: 웹 브라우저를 통해 사용자에게 NetWorker 작업을 제공하는 HTML5 및 Angular Framework로 작성된 프레젠테이션 계층입니다. 웹 브라우저가 UI 백엔드 프로세스에 연결되어 있습니다.
- UI 백엔드: 백엔드 애플리케이션은 Spring Framework로 작성됩니다. Java 및 Apache Tomcat을 사용합니다. 프런트엔드와 백엔드 간의 통신과 백엔드와 NetWorker 서버 간의 통신은 내부 REST API 호출을 사용하여 수행됩니다. NWUI 프로세스는 NetWorker Server에서 기존 Apache Tomcat 인스턴스를 사용하거나 NetWorker 서버에서 원격으로 설치된 경우 자체 Apache Tomcat 인스턴스를 설치합니다.
- NetWorker 서버: NetWorker Server REST 프레임워크는 UI 백엔드에서 REST API 호출을 수신하고 NetWorker Server의 핵심 구성 요소에 연결하는 작업을 담당합니다. NetWorker Server RabbitMQ 메시지 버스는 nsrjobd와의 상호 작용에도 사용됩니다.
- 인증: NetWorker의 인증 구성 요소는 모든 인증 요구 사항에 사용됩니다. 요청 프로세스는 AuthC에 연락하여 자격 증명을 확인합니다. 인증 시 AuthC는 시간, 기반, 서명 및 암호화된 토큰을 발행합니다. NetWorker 구성 요소는 이 토큰을 사용하여 사용자를 확인하고 요청된 작업을 승인하거나 승인하지 않습니다. 일반적으로 NetWorker 서버에 있지만 별도의 호스트에 설치할 수 있습니다.
대부분의 통신은 REST API
를 사용하여 URI(Uniform Resource Identifier) 주소로 식별된 리소스와 상호 작용할 수 있도록 합니다. HTTP 동사(HEAD, GET, PUT, POST, DELETE)를 사용하여 상태 비저장 방식으로 URI(Uniform Resource Identifier)와 상호 작용합니다. 이러한 REST API 호출은 NetWorker 및 NWUI 작업 내부입니다. NetWorker REST API 개발자 가이드에 설명된 맞춤형 작업을 프로그래밍하기 위해 NetWorker에 프로그래밍 방식으로 액세스할 수 있는 NetWorker REST API 인터페이스와 혼동해서는 안 됩니다.
문제 해결
문제 정의
문제 세부 정보
전체 문제 설명을 생성하려면 다음 질문을 고려하십시오.
- 어떤 작업을 시도 중이며 어떤 작업이 작동하지 않습니까?
- 이 작업은 NWUI 외부에서 시작될 때 작동합니까(예: NetWorker Management Console(NMC)에서 사용합니까?
- 문제가 일관되거나 간헐적입니까?
- 간헐적으로 알려진 트리거가 있습니까?
- 문제가 나타나기 전과 후에 알려진 변경 사항이 적용되기 전에 더 효과가 있었습니까?
- 문제가 처음 발생한 시점(문제가 나타난 이후 변경된 사항)은 언제입니까?
- 이 문제는 백업 환경에서 로드가 많은 경우에만 발생합니까?
- 문제의 범위는 무엇입니까(모든 복구 작업/일부 복구 작업, 일부 탭이 작동하지 않는 반면 다른 탭은 영향을 받지 않음)?
- 지금까지 해결을 위해 시도한 사항과 그로부터 도출된 결론은 무엇입니까?
환경 세부 정보
- NetWorker 서버 버전 및 운영 체제 플랫폼은 무엇입니까?
- NWUI가 NetWorker 서버 또는 별도의 호스트에 설치되어 있습니까?
- NetWorker 서버와 별도로 호스트에 설치된 경우 NWUI 버전은 무엇입니까?
- NWUI 서버에 설치된 Java 패키지 는 설치된 NRE(NetWorker Runtime Environment) 또는 ORACLE JRE(Java Runtime Environment)입니다.
인증
인증은 NetWorker Management Console 및
nsrlogin 명령과 동일한 방식으로 AuthC를 사용합니다. 인증 문제의 경우 인증 문제가 NWUI와 관련이 있는지 여부를 구분하기 위해 NetWorker 서버 자체에서 인증을 테스트하는 것부터 시작합니다. 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
설치 문제
브라우저 측 문제
여러 브라우저가 설치된 경우 다른 브라우저에서 관찰된 문제를 테스트하여 문제가 하나의 브라우저에 해당하는지 확인합니다.
브라우저에서 마우스 오른쪽 버튼으로 클릭하고 '검사'를 수행하여 브라우저에서 이루어지는 REST API 호출과 로그 문 및 네트워크 연결 정보를 확인합니다.
- 브라우저 창의 아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 '검사'를 선택합니다.
- 여러 탭으로 새 창이 열립니다. 'Console' 및 'Network' 탭이 가장 유용할 수 있습니다.
- 이러한 탭을 사용하여 NetWorker 서버에 대해 수행되는 정확한 REST API 호출을 확인할 수 있습니다.
- 네트워크 탭에서 NetWorker 서버의 요청 방법 및 REST API 응답도 볼 수 있습니다. 이렇게 하면 NetWorker 서버에서 요청되는 내용과 NetWorker 서버가 이 요청에 응답하는 방법을 정확하게 추적할 수 있습니다.
UI 백엔드 문제
중요한 UI 백엔드 로그는 다음과 같습니다.
catalina.log - Tomcat 서버 로깅 및 애플리케이션 배포 로깅.
nwui.log - NWUI 애플리케이션 서버 로깅.
restapi.log - NetWorker REST API 로깅 NWUI는 NetWorker REST API를 사용하여 NetWorker 서버와 통신합니다.
daemon.raw - NetWorker 서버 로깅.
이러한 로그 파일의 위치는 사용 중인 운영 체제와 NWUI 설치가 NetWorker 서버의 로컬인지 원격인지에 따라 달라집니다. NWUI가 NetWorker 서버 자체에 있는 경우 NetWorker와 동일한 tomcat 인스턴스를 공유합니다.
지원할 .raw 로그 파일을 제공하는 경우 로그 파일이 생성된 시스템에서 로그 파일을 렌더링하는 것이 좋습니다. 이렇게 하면 타임스탬프가 서버의 로컬 시간에 렌더링됩니다.
NetWorker: nsr_render_log
사용하는 방법
로그 파일
Linux:
UI 백엔드에 대해 실행되는 프로세스는 다음과 같습니다. /opt/nwui/bin/nwuictld 및 jsvc.exec ps 명령을 사용하여 실행 중인지 확인할 수 있습니다.
로그는 다음과 같습니다.
로컬에서 NetWorker 서버로 연결됩니다.
- /opt/nwui/logs
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
원격:
- /opt/nwui/logs
- /nsr/nwui/logs
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\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
NetWorker Server
NetWorker 서버에서 nsrget 툴을 실행하여 관련 로그를 수집합니다.
Networker: NSRGet NetWorker 데이터 수집 도구를
사용하는 방법가장 관련성이 높은 로그는 NWUI에서 시도하는 작업에 따라 달라집니다. NetWorker 로그에 대한 자세한 내용은 다음
을 참조하십시오.Networker: 로그 파일 및 위치
디버깅
REST API 통신을 디버그하려면 NetWorker Server
:Windows의 logback.xml 파일에서 디버그 수준을 변경합니다. C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/클래스
API 콜 로깅을 처리하는 줄의 압축을 풉 이로 인해 REST API 요청 및 응답에 대한 로깅 수준이 'trace'로 설정됩니다.