일반적인 문제와 해결 방법

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

설치

• My Esri에서 받은 Docker 컨테이너 이미지를 불러올 때 기기에 남은 공간이 없음 메시지가 나타나며 작업에 실패합니다.

Notebooks에 접근

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

Notebook

• 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'))이라는 오류가 발생합니다.

설치

My Esri에서 받은 Docker 컨테이너 이미지를 불러올 때 기기에 남은 공간이 없음 메시지가 나타나며 작업에 실패합니다.

Docker는 /var 드라이브를 사용하여 컨테이너 이미지를 불러옵니다. ArcGIS Notebook Server를 설치할 때 /var 드라이브에 최소 50GB의 공간이 있는지 확인하거나 적절한 공간이 있는 다른 위치로 Docker의 로컬 레지스트리를 이동합니다.

Notebooks에 접근

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

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" } ] }