ArcGIS Notebook Server에는 머신이 최소 시스템 요구 사항을 충족하고 소프트웨어가 예상대로 작동하는지 확인하는 데 사용할 수 있는 진단 도구가 포함되어 있습니다. 도구를 실행할 때 문제가 발생한 경우 이 도구는 문제의 가능성 있는 원인과 해결 방법을 나열합니다.
소프트웨어 설치를 시작하면 해당 도구가 자동으로 실행되어 머신이 최소 시스템 요구 사항을 충족하는지 확인합니다. 설치 작업을 계속 진행하기 전에 도구에서 표시된 모든 문제를 처리합니다. 설치 후 문제가 발생하는 경우 도구를 실행하여 문제를 식별하고 진단합니다.
도구 실행
ArcGIS Notebook Server를 호스팅하는 머신의 명령줄에서 진단 도구를 실행합니다.
- ArcGIS Notebook Server 설치 디렉터리를 소유한 사용자로 터미널을 엽니다.
비고:
도구를 실행하려면 설치 소유자에게 ArcGIS Notebook Server를 호스팅하는 머신의 /tmp 디렉터리에 대한 읽기 및 쓰기 이상의 권한이 있어야 합니다.
- <ArcGIS Notebook Server installation directory>/arcgis/notebookserver/tools/에서 해당 디렉터리로 이동합니다.
- notebookserverdiag를 실행합니다.
진단 결과 해석
도구를 실행한 후 수행된 모든 서버 진단 검사에 대한 요약을 포함하는 보고서가 생성됩니다. 이 보고서에는 진단 확인 시 경고가 나타났는지 여부 또는 진단 확인에 통과했는지, 실패했는지, 아니면 진단 확인이 시스템에 적용되지 않는지도 나타납니다.
각 검사는 수행된 검사 상태 앞에 DIAG<number> 형식의 코드로 식별됩니다. 각 진단 확인에 대한 설명은 아래 표를 참고하세요. 해당 정보를 사용하여 ArcGIS Notebook Server를 호스팅하는 머신의 현재 상태를 분석할 수 있습니다.
| 번호 확인 | 확인 제목 | 설명 |
|---|---|---|
| DIAG000 | 루트로 설치되었는지 여부 확인 | ArcGIS Notebook Server를 루트로 실행하는 것은 보안 위험이 있으므로 지원되지 않습니다. ArcGIS Notebook Server가 루트로 설치된 것으로 감지된 경우 실패가 반환됩니다. |
| DIAG001 | 64비트 아키텍처 확인 | ArcGIS Notebook Server는 64비트 아키텍처에서만 지원됩니다. 머신이 32비트 아키텍처인 경우 해당 검사가 실패합니다. 지원되는 운영 체제는 시스템 요구 사항을 참고하세요. |
| DIAG002 | OS 버전 확인 | 운영 체제가 지원되는 Linux 배포 또는 버전이 아닌 경우 경고가 나타납니다. 지원되는 Linux 플랫폼 및 OS 버전은 시스템 요구 사항을 참고하세요. 운영 체제가 지원되는 Linux 배포가 아닌 경우 다른 검사는 수행되지 않습니다. |
| DIAG003 | 호스트 이름에서 잘못된 문자 확인 | ArcGIS Notebook Server 머신의 호스트 이름에 유효한 문자에는 RFC 952 사양에 설명된 대로 영숫자(a~z, 0~9), 마이너스(-) 및 점(.) 문자가 있습니다. 호스트 이름에 하나 이상의 잘못된 문자가 포함된 경우 검사가 실패합니다. |
| DIAG004 | 설치된 패키지 확인 | 사용된 Linux 배포에 따라 필수 운영 체제 패키지가 ArcGIS Notebook Server의 적절한 지원에 대해 설치되었는지 확인합니다. 검사가 실패하면 머신에 필요한 누락된 패키지가 포함된 경고가 반환됩니다. 자세한 내용은 시스템 요구 사항을 참고하세요. |
| DIAG005 | 시스템 제한 확인 | ArcGIS Notebook Server가 제대로 실행되려면 설치 사용자에 대한 최소 파일 핸들 제한이 65535로 설정되고 최소 프로세스 수 제한이 25059로 설정되어야 합니다. 해당 검사는 이러한 제한이 /etc/security/limits.conf 파일에 제대로 설정되어 있는지 확인합니다. 제한이 너무 낮게 설정되어 있으면 검사가 실패합니다. 확인하려면 다음을 실행합니다. ulimit -Hn -Hu ulimit -Sn -Su |
| DIAG009 | HTTPS 포트 확인 | ArcGIS Notebook Server는 기본 설정에 따라 포트 11443을 사용합니다. 해당 검사는 다른 사용자 또는 프로세스에서 HTTPS 포트 11443을 사용하고 있는지 확인합니다. 이 검사에서 경고가 반환되면 ArcGIS Notebook Server가 제대로 실행되지 않습니다. 해당 문제를 해결하려면 포트 11443을 열고 ArcGIS Notebook Server를 다시 시작합니다. |
| DIAG020 | 호스트 이름 IP 주소 불일치 확인 | 머신의 호스트 이름 항목이 /etc/hosts 파일에 있는데 머신의 IP 주소와 일치하지 않는 경우 해당 검사에서 경고가 반환됩니다. 이 경우 ArcGIS Notebook Server가 제대로 작동하지 않습니다. 해당 문제를 해결하려면 호스트 이름 항목을 수정하고 ArcGIS Notebook Server를 다시 시작하세요. |
| DIAG024 | /etc/hosts에 있는 호스트 이름 항목 확인 | /etc/hosts 파일에 있는 머신의 호스트 이름 항목은 <IP> <FQDN> <Machine_name> 형식으로 지정되어야 합니다. ArcGIS Notebook Server 사이트를 생성하기 전에 호스트 이름 항목을 업데이트합니다. |
| DIAG026 | ArcGIS Notebook Server 핵심 서비스 프로세스 확인 | ArcGIS Notebook Server가 시작된 후 모든 핵심 서비스가 시작되었는지 확인합니다. 하나 이상의 핵심 서비스가 시작되지 않은 경우 경고가 반환됩니다. 해당 문제를 해결하려면 startnotebookserver.sh 스크립트를 실행하여 ArcGIS Notebook Server를 시작합니다. 또는 이 스크립트가 이미 실행 중인 경우에는 ArcGIS Notebook Server를 다시 시작합니다. |
| DIAG028 | 유효한 Docker 설치 확인 | 머신에 설치된 Docker 버전의 ArcGIS Notebook Server 시스템 요구 사항 충족 여부를 확인합니다. 또한 Docker 명령을 실행할 Docker 그룹에 ArcGIS Notebook Server 설치 사용자 계정이 추가되어 있는지 확인합니다. 해당 검사에 실패하면 지원되는 버전의 Docker가 머신에 설치되었는지 그리고 ArcGIS Notebook Server 사이트 구성 전에 ArcGIS Notebook Server 설치 사용자 계정이 Docker 그룹에 추가되었는지 확인하세요. |
| DIAG029 (10.7.1에서 도입됨) | /var의 디스크 공간 확인 | 이 확인은 머신의 /var 디렉터리에 50GB 이상의 디스크 공간이 있는지 확인합니다. Docker는 컨테이너 이미지의 로컬 레지스트리로 /var 디렉터리를 사용합니다. 후속 릴리스의 업그레이드 프로세스 중에는 새 이미지가 /var디렉터리에도 복사됩니다. 디스크 여유 공간 요구 사항(50GB 이상)이 있어 이러한 작업이 원활하게 실행됩니다. Docker가 컨테이너 이미지를 저장하는 데 사용하는 기본 디렉터리를 변경하려면 설치 가이드에서 이 워크플로를 참조하세요. |