ArcGIS Notebook Server를 사용할 때 발생할 수 있는 질문이나 문제 및 제안되는 해결 방법이 아래에 나와 있습니다. 찾으려는 문제가 없는 경우 Esri Support Center 웹사이트에서 문서를 검색할 수도 있습니다.
설치
Notebooks 접근
- Notebook을 열 때 연결 실패 오류가 발생합니다. Notebook 서버에 대한 연결을 설정할 수 없습니다. Notebook이 계속해서 다시 연결을 시도합니다. 네트워크 연결이나 Notebook 서버 구성을 확인하세요.
- Notebook을 열 때 불러올 수 없음 오류가 발생합니다.
- Notebook을 열 때 Notebook 열기 오류가 발생합니다. Notebook 서버의 Docker 환경에 연결할 수 없습니다. Docker를 실행하기 위한 Notebook 서버 필수 구성 요소가 충족되었는지 확인하세요.
- Notebook을 열 때 컨테이너가 "실행하지 않음" 오류가 발생합니다.
Notebook
설치
Notebooks 접근
Notebook을 열 때 연결 실패 오류가 발생합니다. Notebook 서버에 대한 연결을 설정할 수 없습니다. Notebook이 계속해서 다시 연결을 시도합니다. 네트워크 연결이나 Notebook 서버 구성을 확인하세요.
ArcGIS Web Adaptor가 IIS 웹서버에서 실행되는 경우 해당 머신에서 WebSocket 프로토콜이 비활성화되면 이 오류가 발생합니다. Microsoft 문서의 해당 단계에 따라 프로토콜을 활성화합니다.
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가 실행 중인지 확인합니다.
docker version
docker run hello-world이 오류 메시지가 나타나면 컨테이너가 제공되지만 실행되지 않거나 사용할 수 없는 상태임을 나타냅니다. 접근할 수 있도록 하려면 관리자 디렉터리를 사용하여 컨테이너를 종료해야 합니다. 오류 메시지에 지정된 컨테이너를 종료하고 있는지 확인하세요. 종료된 후에 Notebook 소유자에게 Notebook을 다시 열도록 요청하면 컨테이너가 다시 실행됩니다.
Notebook
ArcGIS Enterprise 포털 항목을 사용하는 Python 코드로 Notebook 셀을 실행하면 요청 시간이 초과됩니다. 이 문제는 원격 URL이 포함된 셀을 실행할 때마다 발생합니다.
사이트에서 실행 중인 Docker 컨테이너에서 사용 중인 네트워크가 ArcGIS Enterprise 네트워크와 충돌하여 Python 코드가 네트워크에 연결되지 않도록 차단됩니다. 네트워킹 구성에 대한 Docker 설명서를 참조하세요. Docker에 대한 네트워크를 구성했으면 Notebook을 다시 실행합니다.
이 오류는 ArcGIS Notebook Server 및 해당 Docker 컴포넌트가 동일한 머신에 다른 ArcGIS Enterprise 컴포넌트로 설치된 경우에 발생합니다. ArcGIS Notebook Server에 저장된 기본 privatePortalUrl 등록정보가 정규화된 도메인 이름의 축약된 버전이기 때문에 발생합니다. 이로 인해 포털에 접속을 시도하면 오류가 발생합니다.
해결 방법은 ArcGIS Notebook Server 사이트의 정규화된 도메인 이름이 되도록 privatePortalUrl 등록정보를 수정하는 것입니다.
- ArcGIS Portal Directory에 로그인 ArcGIS Portal Directory에 로그인합니다. URL 형식은 https://portal.domain.com:7443/arcgis/portaladmin입니다.
- 시스템 > 등록정보 > 등록정보 업데이트를 클릭합니다.
- 시스템 등록정보 업데이트 대화 상자에서 다음 형식으로 포털의 정규화된 도메인 이름이 포함 된 JSON 문자열을 삽입합니다.
{ "privatePortalUrl": "https://portal.domain.com:7443/arcgis"
레거시:
이 문제와 해결 방법은 10.7에만 적용되며 근본적인 문제는 10.7.1에서 해결되었습니다.
해당 문제를 해결하려면 다음 단계와 같이 privatePortalURL 값을 사용하여 CDN 경로를 지정합니다.
- 포털의 privatePortalURL을 모를 경우 ArcGIS Portal Directory에 포털 기관의 기본 관리자 역할 구성원으로 로그인합니다. URL의 형식은 https://portal.domain.com:7443/arcgis/portaladmin입니다. 시스템 > 등록정보를 클릭합니다. privatePortalURL 값을 찾아 기록합니다.
- Notebook 작성자에게 각 Notebook에서 다음 셀을 실행하도록 안내합니다.
from arcgis.widgets import MapView MapView.set_js_cdn("https://<privatePortalURL>:7443/arcgis/jsapi/jsapi4")
해당 CDN 경로가 설정되고 나면 작성자의 Notebooks에서 맵을 그릴 때 privatePortalURL을 사용하여 ArcGIS API for JavaScript에 접근합니다.