일반적인 문제와 해결 방법

ArcGIS Notebook Server를 사용할 때 발생할 수 있는 질문이나 문제 및 제안되는 해결 방법이 아래에 나와 있습니다. 찾으려는 문제가 없는 경우 Esri Support Center 웹사이트에서 문서를 검색할 수도 있습니다.

설치

• 설치 후 또는 Notebook Server 머신 재시작 후 Windows용 ArcGIS Notebook Server 관리 디렉터리가 응답하지 않습니다.
• Notebook 런타임 이미지를 불러올 때 ArcGIS Notebook Server 및 Docker가 설치된 드라이브에 공간이 남아 있는데도 기기에 남은 공간이 없음 오류가 발생합니다.
• 머신에서 이전 컨테이너 이미지를 제거하려면 어떻게 해야 합니까?

Notebooks에 접근

• Notebook을 열 때 연결 실패 오류가 발생합니다. Notebook 서버에 대한 연결을 설정할 수 없습니다. Notebook이 계속해서 다시 연결을 시도합니다. 네트워크 연결이나 Notebook 서버 구성을 확인하세요.
• Notebook을 열 때 불러올 수 없음 오류가 발생합니다.
• Notebook을 열 때 Notebook 열기 오류가 발생합니다. Notebook 서버의 Docker 환경에 연결할 수 없습니다. Docker를 실행하기 위한 Notebook 서버 필수 구성 요소가 충족되었는지 확인하세요.
• Notebook을 열 때 컨테이너가 실행하지 않음 오류가 발생합니다.

Notebook

• Windows 컨테이너를 사용하는 ArcGIS Notebook Server의 경우, Torch 라이브러리 또는 Torch를 종속성으로 가진 Python 라이브러리를 가져오는 Notebook 편집기에서 2개 이상의 Notebook을 실행할 때 [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies에서 실행한 첫 번째 Notebook을 제외한 모든 Notebook에서 가져오기 구문이 실패합니다.
• Windows 컨테이너를 사용하는 ArcGIS Notebook Server의 경우 mljar-supervised 라이브러리를 가져오는 Notebook을 실행하면 가져오기 구문이 오래 걸리거나 Kernel died 오류가 발생합니다.
• ArcGIS Enterprise 포털 항목을 사용하는 Python 코드로 Notebook 셀을 실행하면 요청이 시간 초과됩니다. 이 문제는 원격 URL이 포함된 셀을 실행할 때마다 발생합니다.

• 기본 첫 번째 Notebook 셀(gis = GIS("home") 문자열 포함)을 실행하면 이름 확인의 일시적 오류라는 URL 오류가 발생합니다.
• 기본 첫 번째 Notebook 셀(gis = GIS("home") 문자열 포함)을 실행하면 다음과 같은 오류가 발생합니다. ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

설치

설치 후 또는 Notebook Server 머신 재시작 후 Windows용 ArcGIS Notebook Server 관리 디렉터리가 응답하지 않습니다.

이 문제는 설치 또는 머신 재시작 후 ArcGIS Notebook Server Windows 서비스 및 Docker 서비스가 올바른 순서로 시작되지 않는 경우에 발생할 수 있습니다.

이 문제를 해결하려면 지연 후 ArcGIS Notebook Server Windows 서비스가 자동으로 시작되도록 설정합니다. 이를 수행하면 ArcGIS Notebook Server Windows 서비스가 시작되기 전에 Docker Windows 서비스가 완전히 초기화될 수 있습니다.

지연 후 ArcGIS Notebook Server Windows 서비스가 자동으로 시작되도록 구성하려면 다음 단계를 완료합니다.

1. ArcGIS Notebook Server Windows 머신에서 서비스 응용프로그램을 엽니다.
2. ArcGIS Notebook Server 서비스를 마우스 오른쪽 버튼으로 클릭하고 등록정보를 선택합니다.
3. 일반을 클릭합니다.
4. Startup type에서 자동(지연된 시작)을 선택합니다.
5. 적용을 클릭합니다.
6. 변경 사항을 적용하기 위해 머신을 다시 시작합니다.
7. ArcGIS Notebook Server 사이트의 일부인 머신이 두 대 이상인 경우 각 머신에서 해당 단계를 반복합니다.

Notebook 런타임 이미지를 불러올 때 ArcGIS Notebook Server 및 Docker가 설치된 드라이브에 공간이 남아 있는데도 기기에 남은 공간이 없음 오류가 발생합니다.

고급 리소스 할당을 위한 Docker 데스크톱 설정을 확인하고 디스크 이미지 위치에 할당된 충분한 디스크 이미지 크기가 있는지 확인합니다. 할당된 디스크 공간을 늘리고 Notebook 런타임 이미지 불러오기를 다시 시도합니다.

머신에서 이전 컨테이너 이미지를 제거하려면 어떻게 해야 합니까?

Mirantis Container Runtime이 있는 Windows Server에서, 컨테이너 이미지는 C:\ProgramData\docker\windowsfilter 폴더에 있습니다. 머신에서 이전 컨테이너 이미지를 모두 제거하고 디스크 공간을 확보하려면 PowerShell에서 Administrator 권한으로 다음 명령을 실행하세요.

docker system prune -af

C:\ProgramData\docker\windowsfilter에서 모든 이미지 레이어가 제거되지 않은 경우, 머신을 다시 시작하고 PowerShell에서 Administrator 권한으로 다음 명령을 실행하세요.

비고:

이 프로세스는 머신의 모든 컨테이너 이미지를 제거하므로 ArcGIS Notebook Server Windows 컨테이너 이미지를 불러오기 전에 해당 작업을 수행하세요.

• $FolderPath = "C:\ProgramData\docker\windowsfilter"

• Get-ChildItem -Path $FolderPath -Directory | % {Rename-Item $_.FullName "$($_.FullName)-removing" -ErrorAction:SilentlyContinue}

• while ((Get-ChildItem -Path $FolderPath -Force | Measure-Object).Count -gt 0)
  {
  Restart-Service docker
  }

Notebooks에 접근

Notebook을 열 때 연결 실패 오류가 발생합니다. Notebook 서버에 대한 연결을 설정할 수 없습니다. Notebook이 계속해서 다시 연결을 시도합니다. 네트워크 연결이나 Notebook 서버 구성을 확인하세요.

ArcGIS Web Adaptor가 IIS 웹서버에서 실행되는 경우 해당 머신에서 WebSocket 프로토콜이 비활성화되면 이 오류가 발생합니다. 10.8부터 ArcGIS Web Adaptor는 IIS 웹서버에서 WebSocket 프로토콜을 자동으로 활성화하므로 사용자가 프로토콜을 비활성화해서는 안 됩니다.

Notebook을 열 때 불러올 수 없음 오류가 발생합니다.

ArcGIS Notebook Server 사이트 Web Adaptor로 구성된 SSL은 사용 중인 웹브라우저에서 신뢰하지 않습니다. CA 서명 인증서가 구성되어 있고 사이트에서 HTTPS가 활성화되어 있는지 확인하세요.

개발 또는 스테이징 환경에서 자체 서명 인증서를 사용하는 경우 ArcGIS Notebook Server 관리자 디렉터리의 URL을 열고 자체 서명 인증서를 신뢰하도록 웹브라우저에 예외를 추가합니다.

Notebook을 열 때 Notebook 열기 오류가 발생합니다. Notebook 서버의 Docker 환경에 연결할 수 없습니다. Docker를 실행하기 위한 Notebook 서버 필수 구성 요소가 충족되었는지 확인하세요.

Docker Engine 컴포넌트가 ArcGIS Notebook Server와 함께 작동할 수 있도록 하는 필수 설정 중 하나 이상이 구성되어 있지 않습니다. 자세한 내용은 설치 가이드에서 다음 항목을 참조하세요.

• ArcGIS Notebook Server용 Docker 설치
• 설치 후 ArcGIS Notebook Server 구성

필요한 모든 설정이 구성되었는지 확인하는 경우 명령 프롬프트에서 다음을 실행하여 ArcGIS Notebook Server 머신에서 Docker가 실행 중인지 확인합니다.

docker version
docker run hello-world

Notebook을 열 때 컨테이너가 실행하지 않음 오류가 발생합니다.

이 오류 메시지가 나타나면 컨테이너가 제공되지만 실행되지 않거나 사용할 수 없는 상태임을 나타냅니다. 접근할 수 있도록 하려면 관리자 디렉터리를 사용하여 컨테이너를 종료해야 합니다. 오류 메시지에 지정된 컨테이너를 종료하고 있는지 확인하세요. 종료된 후에 Notebook 소유자에게 Notebook을 다시 열도록 요청하면 컨테이너가 다시 실행됩니다.

Notebook

Windows 컨테이너를 사용하는 ArcGIS Notebook Server의 경우, Torch 라이브러리 또는 Torch를 종속성으로 가진 Python 라이브러리를 가져오는 Notebook 편집기에서 2개 이상의 Notebook을 실행할 때 [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies에서 실행한 첫 번째 Notebook을 제외한 모든 Notebook에서 가져오기 구문이 실패합니다.

이 동작은 Notebook Server 머신의 가상 메모리에 구성된 기본 최대 페이징 파일 크기로 인한 것입니다. 기본 페이징 파일 크기와 Notebook에 할당된 최대 CPU 및 메모리를 늘리려면 다음 단계를 따릅니다.

비고:

이러한 변경을 적용하기 전에 시스템 관리자에게 적절한 페이징 파일 크기에 대해 문의하세요.

1. 각 ArcGIS Notebook Server 머신에서 시작 > 설정 > 시스템 > 정보 > 고급 시스템 설정을 클릭합니다.
2. 시스템 등록정보 대화 상자의 고급 탭에서 성능 섹션에 있는 설정을 클릭합니다.
3. 성능 옵션 대화 상자에서 고급 탭을 클릭합니다.
4. 가상 메모리 섹션에서 변경을 클릭합니다.
5. 가상 메모리 대화 상자에서 모든 드라이브에 대해 페이징 파일 크기를 자동으로 관리의 선택을 취소합니다.
6. 사용자 설정 크기를 선택합니다.
7. Initial size (MB) 및 Maximum size (MB)에 값을 입력합니다.
8. 확인을 클릭하고 머신을 다시 시작합니다.

머신이 다시 시작되면 ArcGIS Notebook Server Manager에서 다음 단계를 따릅니다.

1. 설정 > 런타임을 클릭합니다.
2. Torch를 가져오는 Notebook 실행에 사용하는 런타임을 선택하고 편집을 클릭합니다.
3. 최대 CPU를 4코어로, 최대 메모리를 12GB로 업데이트합니다.
4. 저장을 클릭하여 업데이트를 확인합니다.
5. ArcGIS Notebook Server 관리자를 닫습니다.

Windows 컨테이너를 사용하는 ArcGIS Notebook Server의 경우 mljar-supervised 라이브러리를 가져오는 Notebook을 실행하면 가져오기 구문이 오래 걸리거나 Kernel died 오류가 발생합니다.

이 동작은 mljar-supervised 라이브러리에 종속성이 많아서 발생하는 결과입니다. ArcGIS Notebook Server Manager에서 Notebook에 할당된 최대 CPU를 늘리려면 다음 단계를 따릅니다.

1. 설정 > 런타임을 클릭합니다.
2. mljar-supervised을(를) 가져오는 Notebook 실행에 사용하는 런타임을 선택하고 편집을 클릭합니다.
3. 최대 CPU를 4코어로 업데이트합니다.
4. 저장을 클릭하여 업데이트를 확인합니다.
5. ArcGIS Notebook Server 관리자를 닫습니다.

ArcGIS Enterprise 포털 항목을 사용하는 Python 코드로 Notebook 셀을 실행하면 요청이 시간 초과됩니다. 이 문제는 원격 URL이 포함된 셀을 실행할 때마다 발생합니다.

사이트에서 실행 중인 Docker 컨테이너에서 사용하는 네트워크가 ArcGIS Enterprise 네트워크와 충돌하여 Python 코드가 네트워크에 연결되지 않도록 차단되는 것입니다. 네트워킹 구성에 대한 Docker 문서를 참조하세요. Docker에 대해 네트워크를 구성했으면 Notebook을 다시 실행합니다.

기본 첫 번째 Notebook 셀(gis = GIS("home") 문자열 포함)을 실행하면 이름 확인의 일시적 오류라는 URL 오류가 발생합니다.

이 오류는 ArcGIS Notebook Server 및 해당 Docker 컴포넌트가 동일한 머신에 다른 ArcGIS Enterprise 컴포넌트로 설치된 경우에 발생합니다. ArcGIS Notebook Server에 저장된 기본 privatePortalUrl 등록정보가 정규화된 도메인 이름의 축약된 버전이기 때문에 발생합니다. 이로 인해 포털에 접속을 시도하면 오류가 발생합니다.

해결 방법은 ArcGIS Notebook Server 사이트의 정규화된 도메인 이름이 되도록 privatePortalUrl 등록정보를 수정하는 것입니다.

1. ArcGIS Portal Directory에 내 포털 기관의 기본 관리자 역할 구성원으로 로그인합니다. URL 형식은 https://portal.domain.com:7443/arcgis/portaladmin입니다.
2. 시스템 > 등록정보 > 등록정보 업데이트를 클릭합니다.
3. 시스템 등록정보 업데이트 대화 상자에서 다음 형식으로 포털의 정규화된 도메인 이름이 포함된 JSON 문자열을 삽입합니다.
   { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

기본 첫 번째 Notebook 셀(gis = GIS("home") 문자열 포함)을 실행하면 다음과 같은 오류가 발생합니다. ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

Docker 컨테이너를 배포할 때 호스트 머신의 resolv.conf 파일에서 이름 서버가 복사됩니다. 그러면 Docker 컨테이너가 내부 DNS 이름을 확인할 수 있어야 하므로 머신에 대해 공개 DNS 서버를 사용하는 설정에서 오류가 발생할 수 있습니다.

해결 방법은 ArcGIS Notebook Server 시스템 등록정보에서 dockerExtraHosts를 구성하는 것입니다.

1. ArcGIS Notebook Server 관리자 디렉터리의 URL을 엽니다.
2. 시스템 > 등록정보 > 등록정보 업데이트를 클릭합니다.
3. 시스템 등록정보 업데이트 대화 상자에서 다음 형식으로 호스트 이름 및 IP 주소의 JSON 문자열을 삽입합니다.
   { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }