Typowe problemy i rozwiązania

Poniżej przedstawiono pytania i problemy, które mogą pojawiać się podczas pracy z aplikacją ArcGIS Notebook Server, a także odpowiedzi i sugerowane rozwiązania. Jeśli nie można tutaj odnaleźć odpowiedzi na poszukiwane pytanie, istnieje również możliwość wyszukiwania artykułów na stronie Centrum Wsparcia firmy Esri.

Instalacja

• Katalog administracyjny serwera ArcGIS Notebook Server w systemie Windows nie odpowiada po instalacji lub po ponownym uruchomieniu serwera notatników.
• Podczas wczytywania obrazów środowiska wykonawczego notatników pojawia się błąd brak miejsca na urządzeniu, chociaż dostępne jest miejsce na dysku, na którym zainstalowane jest oprogramowanie ArcGIS Notebook Server i Docker.
• Jak usunąć wcześniejsze obrazy kontenerów z komputera?

Dostęp do notatników

• Przy próbie otwarcia notatnika otrzymuję następujący błąd: Błąd połączenia. Nie można nawiązać połączenia z serwerem notatników. Notatnik będzie kontynuował próby ponownego nawiązania połączenia. Sprawdź połączenie sieciowe lub konfigurację serwera notatników.
• Przy próbie otwarcia notatnika otrzymuję następujący błąd: Nie można wczytać.
• Przy próbie otwarcia notatnika otrzymuję następujący błąd: Błąd podczas otwierania notatnika. Nie można nawiązać połączenia ze środowiskiem Docker na serwerze notatników. Upewnij się, że spełnione są wymagania wstępne serwera notatników pozwalające na uruchomienie platformy Docker.
• Przy próbie otwarcia notatnika otrzymuję błąd informujący, że kontener nie działa.

Notatniki

• Na serwerze ArcGIS Notebook Server z kontenerami Windows, gdy uruchamiam dwa lub większą liczbę notatników w edytorze notatników, które importują bibliotekę Torch lub biblioteki Python, dla których Torch jest biblioteką zależną, instrukcje importu nie działają dla żadnych notatników oprócz pierwszego i wyświetlany jest błąd [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.
• Na serwerze ArcGIS Notebook Server z kontenerami Windows, gdy uruchamiam notatnik importujący bibliotekę mljar-supervised, instrukcja importu trwa długo lub kończy się błędem Kernel died.
• Gdy używam komórki notatnika z kodem w języku Python, który wykorzystuje element portalu ArcGIS Enterprise, żądanie kończy się przekroczeniem limitu czasu. Zdarza się to za każdym razem, gdy uruchamiam komórkę zawierającą zdalny adres URL.

• Kiedy uruchamiam domyślną pierwszą komórkę notatnika (zawierającą ciąg znakowy gis = GIS("home")), pojawia się błąd adresu URL informujący o tymczasowym niepowodzeniu tłumaczenia nazw.
• Kiedy uruchamiam domyślną pierwszą komórkę notatnika (wraz z ciągiem znakowym gis = GIS("home")), otrzymuję błąd: 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'))

Instalacja

Katalog administracyjny serwera ArcGIS Notebook Server w systemie Windows nie odpowiada po instalacji lub po ponownym uruchomieniu serwera notatników.

Problem ten może wystąpić, jeśli usługa Windows serwera ArcGIS Notebook Server i usługa Docker nie zostaną uruchomione w prawidłowej kolejności po instalacji lub ponownym uruchomieniu komputera.

Aby rozwiązać ten problem, należy ustawić automatyczne uruchamianie usługi Windows serwera ArcGIS Notebook Server z opóźnieniem. Pozwoli to na pełną inicjalizację usługi Windows środowiska Docker przed uruchomieniem usługi Windows serwera ArcGIS Notebook Server.

Aby skonfigurować usługę Windows serwera ArcGIS Notebook Server do automatycznego uruchamiania z opóźnieniem, wykonaj następujące czynności:

1. Otwórz aplikację Usługi na komputerze serwera ArcGIS Notebook Server z systemem Windows.
2. Kliknij usługę ArcGIS Notebook Server prawym przyciskiem myszy i wybierz opcję Właściwości.
3. Kliknij opcję Ogólne.
4. W polu Startup type wybierz Automatyczny (opóźniony start).
5. Kliknij przycisk Zastosuj.
6. Uruchom ponownie komputer, aby zastosować zmiany.
7. Jeśli istnieje więcej niż jeden komputer, który jest częścią witryny ArcGIS Notebook Server, powtórz te czynności na każdym komputerze.

Podczas wczytywania obrazów środowiska wykonawczego notatników pojawia się błąd brak miejsca na urządzeniu, chociaż dostępne jest miejsce na dysku, na którym zainstalowane jest oprogramowanie ArcGIS Notebook Server i Docker.

Sprawdź ustawienia aplikacji Docker Desktop pod kątem zaawansowanego przydzielania zasobów i sprawdź, czy na potrzeby zapisu obrazów dysków przydzielono wystarczającą ilość miejsca na obrazy dysków. Zwiększ ilość miejsca przydzielonego na dysku i ponownie wczytaj obrazy środowiska wykonawczego notatników.

Jak usunąć wcześniejsze obrazy kontenerów z komputera?

W systemie Windows Server ze środowiskiem wykonawczym Mirantis Container Runtime obrazy kontenerów znajdują się w folderze C:\ProgramData\docker\windowsfilter. Aby usunąć wszystkie wcześniejsze obrazy kontenerów z komputera i zwolnić miejsce na dysku, wykonaj poniższe polecenie w powłoce PowerShell z uprawnieniami administratora.

docker system prune -af

Jeśli nie wszystkie warstwy rastrowe zostaną usunięte z katalogu C:\ProgramData\docker\windowsfilter, uruchom komputer ponownie i wykonaj poniższe polecenia w powłoce PowerShell z uprawnieniami administratora.

Notatka:

Wykonaj te operacje przed wczytaniem obrazu kontenera serwera ArcGIS Notebook Server z systemem Windows, ponieważ ten proces usunie wszystkie obrazy kontenerów na komputerze.

• $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
  }

Dostęp do notatników

Przy próbie otwarcia notatnika otrzymuję następujący błąd: Błąd połączenia. Nie można nawiązać połączenia z serwerem notatników. Notatnik będzie kontynuował próby ponownego nawiązania połączenia. Sprawdź połączenie sieciowe lub konfigurację serwera notatników.

Gdy aplikacja ArcGIS Web Adaptor działa na serwerze internetowym IIS, ten błąd występuje, gdy na komputerze jest wyłączony protokół WebSocket. Począwszy od wersji 10.8, aplikacja ArcGIS Web Adaptor automatycznie włącza protokół WebSocket na serwerach internetowych IIS. Tego protokołu nie można wyłączyć.

Przy próbie otwarcia notatnika otrzymuję następujący błąd: Nie można wczytać.

Przeglądarka internetowa nie ufa certyfikatowi SSL skonfigurowanemu przy użyciu adaptera internetowego witryny serwera ArcGIS Notebook Server. Upewnij się, że masz skonfigurowany certyfikat podpisany przez urząd certyfikacji, a w witrynie został włączony protokół HTTPS.

Jeśli w środowisku programistycznym lub pomostowym używany jest certyfikat z podpisem własnym, otwórz adres URL aplikacji ArcGIS Notebook Server Administrator Directory i dodaj w przeglądarce internetowej wyjątek, aby ufać certyfikatowi z podpisem własnym.

Przy próbie otwarcia notatnika otrzymuję następujący błąd: Błąd podczas otwierania notatnika. Nie można nawiązać połączenia ze środowiskiem Docker na serwerze notatników. Upewnij się, że spełnione są wymagania wstępne serwera notatników pozwalające na uruchomienie platformy Docker.

Nie skonfigurowano co najmniej jednego wstępnie wymaganego ustawienia pozwalającego komponentowi Docker Engine na działanie z serwerem ArcGIS Notebook Server. Więcej informacji zawierają następujące tematy w podręczniku instalacji:

• Instalowanie środowiska Docker dla aplikacji ArcGIS Notebook Server
• Konfigurowanie aplikacji ArcGIS Notebook Server po instalacji

Po sprawdzeniu, że wszystkie wymagane ustawienia zostały skonfigurowane, uruchom w wierszu polecenia następujące polecenie, aby potwierdzić, że platforma Docker działa na komputerze serwera ArcGIS Notebook Server:

docker version
docker run hello-world

Przy próbie otwarcia notatnika otrzymuję błąd informujący, że kontener nie działa.

Jeśli pojawia się ten komunikat o błędzie, oznacza to, że kontener jest dostępny, ale nie jest w stanie „uruchomiony” ani „użyteczny”. Aby stał się on dostępny, przerwij działanie kontenera za pomocą aplikacji Administrator Directory. Upewnij się, że przerywasz działanie kontenera wymienionego w komunikacie o błędzie. Po przerwaniu działania kontenera poproś właściciela notatnika o ponowne otwarcie notatnika, co spowoduje ponowne uruchomienie kontenera.

Notatniki

Na serwerze ArcGIS Notebook Server z kontenerami Windows, gdy uruchamiam dwa lub większą liczbę notatników w edytorze notatników, które importują bibliotekę Torch lub biblioteki Python, dla których Torch jest biblioteką zależną, instrukcje importu nie działają dla żadnych notatników oprócz pierwszego i wyświetlany jest błąd [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.

To zachowanie wynika z domyślnego maksymalnego rozmiaru pliku stronicowania skonfigurowanego dla pamięci wirtualnej komputerów Notebook Server. Wykonaj następujące czynności, aby zwiększyć domyślny rozmiar pliku stronicowania oraz maksymalny przydział procesora i pamięci dla notatnika.

Notatka:

Przed wprowadzeniem tych zmian skonsultuj się z administratorem systemu w sprawie odpowiedniego rozmiaru pliku stronicowania.

1. Na każdym komputerze z serwerem ArcGIS Notebook Server kliknij opcję Start > Ustawienia > System > Informacje > Zaawansowane ustawienia systemu.
2. Na karcie Zaawansowane okna dialogowego Właściwości systemu kliknij przycisk Ustawienia w sekcji Wydajność.
3. W oknie dialogowym Opcje wydajności kliknij kartę Zaawansowane.
4. Kliknij przycisk Zmień w sekcji Pamięć wirtualna.
5. W oknie dialogowym Pamięć wirtualna wyłącz zaznaczenie opcji Automatycznie zarządzaj rozmiarem pliku stronicowania dla wszystkich dysków.
6. Wybierz przełącznik Rozmiar niestandardowy.
7. Wprowadź wartości w polach Initial size (MB) i Maximum size (MB).
8. Kliknij przycisk OK i uruchom ponownie komputer.

Po ponownym uruchomieniu komputera wykonaj poniższe czynności w aplikacji ArcGIS Notebook Server Manager:

1. Kliknij opcję Ustawienia > Środowiska wykonawcze.
2. Wybierz środowisko wykonawcze, którego używasz do uruchamiania notatników importujących torch i kliknij Edytuj.
3. Zaktualizuj wartość parametru Maksymalna liczba procesorów na 4 rdzenie i wartość parametru Maksymalna wielkość pamięci na 12 GB.
4. Kliknij przycisk Zapisz, aby zatwierdzić aktualizację.
5. Zamknij Menedżer usług ArcGIS Notebook Server.

Na serwerze ArcGIS Notebook Server z kontenerami Windows, gdy uruchamiam notatnik importujący bibliotekę mljar-supervised, instrukcja importu trwa długo lub kończy się błędem Kernel died.

Takie zachowanie jest wynikiem tego, że biblioteka mljar-supervised ma wiele zależności. Wykonaj następujące czynności, aby zwiększyć maksymalny przydział procesora dla notatnika w aplikacji ArcGIS Notebook Server Manager:

1. Kliknij opcję Ustawienia > Środowiska wykonawcze.
2. Wybierz środowisko wykonawcze, którego używasz do uruchamiania notatników importujących mljar-supervised i kliknij Edytuj.
3. Zaktualizuj wartość parametru Maksymalna liczba procesorów na 4 rdzenie.
4. Kliknij przycisk Zapisz, aby zatwierdzić aktualizację.
5. Zamknij Menedżer usług ArcGIS Notebook Server.

Gdy używam komórki notatnika z kodem w języku Python, który wykorzystuje element portalu ArcGIS Enterprise, żądanie kończy się przekroczeniem limitu czasu. Zdarza się to za każdym razem, gdy uruchamiam komórkę zawierającą zdalny adres URL.

Sieć używana przez kontenery Docker działające w witrynie koliduje z siecią ArcGIS Enterprise, co uniemożliwia kodowi w języku Python nawiązywanie połączeń z siecią. Zapoznaj się z dokumentacją dotyczącą konfigurowania sieci dla platformy Docker. Po skonfigurowaniu sieci dla platformy Docker ponownie uruchom notatniki.

Kiedy uruchamiam domyślną pierwszą komórkę notatnika (zawierającą ciąg znakowy gis = GIS("home")), pojawia się błąd adresu URL informujący o tymczasowym niepowodzeniu tłumaczenia nazw.

Ten błąd może wystąpić, gdy aplikacja ArcGIS Notebook Server i jej komponent Docker są zainstalowane na tym samym komputerze co inne komponenty oprogramowania ArcGIS Enterprise. Występuje dlatego, że domyślna właściwość privatePortalUrl zapisana w aplikacji ArcGIS Notebook Server jest skróconą wersją w pełni kwalifikowanej nazwy domeny. Jest to przyczyną niepowodzenia podczas próby skontaktowania się z portalem.

Rozwiązaniem jest odpowiednia zmiana właściwości privatePortalUrl w taki sposób, aby zawierała w pełni kwalifikowaną nazwę domeny witryny serwera ArcGIS Notebook Server:

1. Zaloguj się do aplikacji ArcGIS Portal Directory jako członek pełniący rolę domyślnego administratora portalu. Adres URL ma następujący format: https://portal.domain.com:7443/arcgis/portaladmin.
2. Kliknij System > Właściwości > Aktualizuj właściwości.
3. W oknie dialogowym Aktualizuj właściwości systemu wstaw ciąg znakowy JSON zawierający w pełni kwalifikowaną nazwę domeny portalu w następującym formacie:
   { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

Kiedy uruchamiam domyślną pierwszą komórkę notatnika (wraz z ciągiem znakowym gis = GIS("home")), otrzymuję błąd: 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'))

Podczas wdrażania kontenerów Docker serwery nazw są kopiowane z pliku resolv.conf komputera hosta. Może to powodować błędy w konfiguracjach, które używają publicznych serwerów DNS dla komputerów, ponieważ kontenery Docker muszą być w stanie dokonywać translacji wewnętrznych nazw DNS.

Rozwiązaniem jest skonfigurowanie dockerExtraHosts we właściwościach systemu ArcGIS Notebook Server.

1. Otwórz adres URL aplikacji ArcGIS Notebook Server Administrator Directory.
2. Kliknij System > Właściwości > Aktualizuj właściwości.
3. W oknie dialogowym Aktualizuj właściwości systemu wstaw ciąg znakowy JSON nazw hostów i adresów IP w następującym formacie:
   { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }