Skip To Content

Allgemeine Probleme und Lösungen

Nachfolgend werden Fragen oder Probleme, die bei der Arbeit mit ArcGIS Notebook Server auftreten können, aufgelistet und Lösungen vorgeschlagen. Wenn Sie das gesuchte Problem nicht finden, können Sie auch auf der Esri Support Center-Website nach Artikeln suchen.

Installation

Zugreifen auf Notebooks

Notebooks

Installation

Das ArcGIS Notebook Server-Administratorverzeichnis unter Windows reagiert nach der Installation oder einem Neustart des Notebook-Server-Computers nicht.

Dieses Problem kann auftreten, wenn die unterWindows ausgeführten ArcGIS Notebook Server- und Docker-Services nach der Installation oder dem Neustart des Computers nicht in der richtigen Reihenfolge gestartet werden.

Um dieses Problem zu beheben, müssen Sie den ArcGIS Notebook Server-Windows-Service so einstellen, dass er automatisch mit einer Verzögerung startet. Dadurch kann der Docker-Windows-Service vollständig initialisiert werden, bevor der Windows-Service für ArcGIS Notebook Server gestartet wird.

Führen Sie die folgenden Schritte aus, um den ArcGIS Notebook Server-Windows-Service so zu konfigurieren, dass er automatisch mit einer Verzögerung startet:

  1. Öffnen Sie die Anwendung "Dienste" auf Ihrem ArcGIS Notebook Server-Windows-Computer.
  2. Klicken Sie mit der rechten Maustaste auf den ArcGIS Notebook Server-Service, und wählen Sie Eigenschaften aus.
  3. Klicken Sie auf Allgemein.
  4. Wählen Sie in Startup type die Option Automatisch (Verzögerter Start) aus.
  5. Klicken Sie auf Übernehmen.
  6. Starten Sie Ihren Computer neu, um die Änderungen zu übernehmen.
  7. Wenn Ihre ArcGIS Notebook Server-Site mehr als einen Computer umfasst, wiederholen Sie diese Schritte auf allen Computern.

Beim Laden von Notebook-Runtime-Images wird die Fehlermeldung Kein Platz mehr auf Gerät angezeigt, obwohl auf dem Laufwerk mit ArcGIS Notebook Server und Docker noch Speicherplatz frei ist.

Überprüfen Sie in den Docker-Desktop-Einstellungen die erweiterte Ressourcenzuweisung, und stellen Sie sicher, dass dem Speicherort für das Datenträger-Image eine ausreichende Datenträger-Image-Größe zugewiesen wurde. Vergrößern Sie den zugewiesenen Speicherplatz, und wiederholen Sie das Laden der Notebook-Runtime-Images.

Wie entferne ich die vorherigen Container-Images vom Computer?

Unter Windows Server mit Mirantis Container Runtime befinden sich die Container-Images im Ordner C:\ProgramData\docker\windowsfilter. Um alle vorherigen Container-Images auf dem Computer zu entfernen und Speicherplatz freizugeben, führen Sie in PowerShell mit Administrator-Berechtigungen den folgenden Befehl aus:

docker system prune -af

Falls nicht alle Image-Layer aus C:\ProgramData\docker\windowsfilter entfernt werden, starten Sie den Computer neu, und führen Sie in PowerShell mit Administrator-Berechtigungen die folgenden Befehle aus.

Hinweis:

Führen Sie diese Vorgänge aus, bevor Sie das Windows-Container-Image für ArcGIS Notebook Server laden, da durch diesen Prozess alle Container-Images auf dem Computer entfernt werden.

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

Zugreifen auf Notebooks

Beim Versuch, ein Notebook zu öffnen, wird folgender Fehler ausgegeben: Verbindung fehlgeschlagen. Eine Verbindung zum Notebook-Server konnte nicht hergestellt werden. Das Notebook versucht weiterhin, eine Verbindung herzustellen. Prüfen Sie Ihre Netzwerkverbindung oder Notebook-Serverkonfiguration.

Wenn ArcGIS Web Adaptor auf einem IIS-Webserver ausgeführt wird, tritt dieser Fehler bei deaktiviertem WebSocket-Protokoll auf diesem Computer auf. Ab Version 10.8 aktiviert ArcGIS Web Adaptor automatisch das WebSocket-Protokoll auf IIS-Webservern. Deaktivieren Sie das Protokoll nicht.

Beim Versuch, ein Notebook zu öffnen, wird folgender Fehler ausgegeben: Kann nicht geladen werden.

Das für den Web Adaptor der ArcGIS Notebook Server-Site konfigurierte SSL-Zertifikat wird von Ihrem Webbrowser nicht als vertrauenswürdig eingestuft. Stellen Sie sicher, dass Sie ein von einer Zertifizierungsstelle signiertes Zertifikat konfiguriert haben und HTTPS für Ihre Site aktiviert ist.

Wenn Sie ein selbstsigniertes Zertifikat in einer Entwicklungs- oder Staging-Umgebung verwenden, öffnen Sie die URL des Administratorverzeichnisses für ArcGIS Notebook Server, und fügen Sie in Ihrem Webbrowser eine Ausnahme hinzu, um das selbstsignierte Zertifikat als vertrauenswürdig einzustufen.

Beim Versuch, ein Notebook zu öffnen, wird folgender Fehler ausgegeben: Fehler beim Öffnen von Notebook. Die Verbindung zur Docker-Umgebung auf dem Notebook-Server kann nicht hergestellt werden. Stellen Sie sicher, dass die Notebook-Server-Voraussetzungen zum Ausführen von Docker erfüllt sind.

Eine oder mehrere erforderliche Einstellungen, die erlauben, dass die Docker Engine-Komponente mit ArcGIS Notebook Server funktioniert, wurden nicht konfiguriert. Weitere Informationen finden Sie in den folgenden Themen in der Installationsanweisung:

Wenn Sie überprüfen, ob alle notwendigen Einstellungen konfiguriert wurden, führen Sie folgenden Befehl in einer Eingabeaufforderung aus, um zu sicherzustellen, dass Docker auf Ihrem ArcGIS Notebook Server-Computer ausgeführt wird:

docker version
docker run hello-world

Beim Versuch, ein Notebook zu öffnen, wird ein Fehler ausgegeben, dass der Container nicht ausgeführt wird.

Wenn diese Fehlermeldung angezeigt wird, ist der Container verfügbar, aber befindet sich in einem Zustand, in dem er nicht ausgeführt oder verwendet werden kann. Um den Zugriff darauf zu ermöglichen, müssen Sie mithilfe des Administratorverzeichnisses den Container beenden. Vergewissern Sie sich, dass Sie den Container beenden, der in der Fehlermeldung angegeben ist. Lassen Sie anschließend den Notebook-Besitzer das beendete Notebook erneut öffnen. Dadurch wird der Container neu gestartet.

Notebooks

Wenn ArcGIS Notebook Server mit Windows-Containern verwendet wird und im Notebook-Editor mehrere Notebooks ausgeführt werden, die die Torch-Bibliothek oder Python-Bibliotheken importieren, die Torch als Abhängigkeit aufweisen, tritt bei den Importanweisungen in allen Notebooks außer dem ersten ausgeführten Notebook der Fehler [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 auf.

Die Ursache hierfür ist die standardmäßige maximale Größe der Auslagerungsdatei, die für den virtuellen Speicher auf den Notebook Server-Computern konfiguriert ist. Führen Sie die folgenden Schritte aus, um die Standardgröße der Auslagerungsdatei sowie die maximale CPU und den maximalen Speicher zu erhöhen, die einem Notebook zugewiesen werden.

Hinweis:

Erkundigen Sie sich beim Systemadministrator nach der korrekten Größe der Auslagerungsdatei, bevor Sie diese Änderungen vornehmen.

  1. Klicken Sie auf jedem ArcGIS Notebook Server-Computer auf Start > Einstellungen > System > Info > Erweiterte Systemeinstellungen.
  2. Klicken Sie im Dialogfeld Systemeigenschaften auf der Registerkarte Erweitert im Abschnitt Leistung auf Einstellungen.
  3. Klicken Sie im Dialogfeld Leistungsoptionen auf die Registerkarte Erweitert.
  4. Klicken Sie im Abschnitt Virtueller Arbeitsspeicher auf Ändern.
  5. Deaktivieren Sie im Dialogfeld Virtueller Arbeitsspeicher die Option Auslagerungsdateigröße für alle Laufwerke automatisch verwalten.
  6. Wählen Sie Benutzerdefinierte Größe aus.
  7. Geben Sie Werte für Initial size (MB) und Maximum size (MB) ein.
  8. Klicken Sie auf OK, und starten Sie den Computer neu.

Führen Sie nach dem Neustart des Computers die folgenden Schritte in ArcGIS Notebook Server Manager aus:

  1. Klicken Sie auf Einstellungen > Runtimes.
  2. Wählen Sie die Runtime aus, die zum Ausführen von Notebooks, die Torch importieren, verwendet werden soll, und klicken Sie auf Bearbeiten.
  3. Aktualisieren Sie Max. CPU auf 4 Kerne und Max. Speicher auf 12 GB.
  4. Klicken Sie auf Speichern, um die Aktualisierung zu bestätigen.
  5. Schließen Sie ArcGIS Notebook Server Manager.

Wenn ArcGIS Notebook Server mit Windows-Containern verwendet wird, nimmt die Import-Anweisung beim Ausführen eines Notebooks, das die mljar-supervised-Bibliothek importiert, viel Zeit in Anspruch, oder es tritt der Fehler Kernel died auf.

Dies wird dadurch verursacht, dass die mljar-supervised-Bibliothek viele Abhängigkeiten aufweist. Führen Sie in ArcGIS Notebook Server Manager die folgenden Schritte aus, um die maximale CPU zu erhöhen, die einem Notebook zugewiesen wird:

  1. Klicken Sie auf Einstellungen > Runtimes.
  2. Wählen Sie die Runtime aus, die zum Ausführen von Notebooks verwendet werden soll, die mljar-supervised importieren, und klicken Sie auf Bearbeiten.
  3. Aktualisieren Sie Max. CPU auf 4 Kerne.
  4. Klicken Sie auf Speichern, um die Aktualisierung zu bestätigen.
  5. Schließen Sie ArcGIS Notebook Server Manager.

Beim Ausführen einer Notebook-Zelle mit Python-Code, der ein ArcGIS Enterprise-Portal-Element verwendet, überschreitet die Anforderung das Zeitlimit. Das passiert bei jedem Ausführen einer Zelle, die eine Remote-URL enthält.

Das Netzwerk, das von den auf Ihrer Site ausgeführten Docker-Containern verwendet wird, steht im Konflikt mit Ihrem ArcGIS Enterprise-Netzwerk. Dies hindert den Python-Code am Verbinden mit dem Netzwerk. Weitere Informationen finden Sie in der Docker-Dokumentation zum Konfigurieren von Netzwerken. Wenn Sie das Netzwerk für Docker konfiguriert haben, führen Sie Ihre Notebooks erneut aus.

Beim Ausführen der standardmäßigen ersten Notebook-Zelle (inklusive der Zeichenfolge gis = GIS("home")) wird ein URL-Fehler angezeigt: Temporärer Fehler bei der Namensauflösung.

Dieser Fehler kann auftreten, wenn ArcGIS Notebook Server und dessen Docker-Komponenten auf dem gleichen Computer wie andere ArcGIS Enterprise-Komponenten installiert sind. Er tritt auf, weil die in ArcGIS Notebook Server standardmäßig gespeicherte Eigenschaft privatePortalUrl eine verkürzte Version des vollständig qualifizierten Domänennamens ist. Dies verursacht einen Fehler beim Kontaktieren des Portals.

Die Lösung besteht darin, die Eigenschaft privatePortalUrl in den vollständig qualifizierten Domänennamen der ArcGIS Notebook Server-Site zu ändern:

  1. Melden Sie sich als Mitglied der Standardadministratorrolle in Ihrem Portal beim ArcGIS Portal-Verzeichnis an. Das URL-Format lautet https://portal.domain.com:7443/arcgis/portaladmin.
  2. Klicken Sie auf System > Properties > Update Properties.
  3. Fügen Sie im Dialogfeld Update System Properties eine JSON-Zeichenfolge mit dem vollständig qualifizierten Domänennamen des Portals im folgenden Format ein:
    { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

Beim Ausführen der standardmäßigen ersten Notebook-Zelle (inklusive der Zeichenfolge gis = GIS("home")) wird mir der folgende Fehler angezeigt: 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')).

Bei der Bereitstellung von Docker-Containern werden die Namenserver aus der resolv.conf-Datei des Host-Computers kopiert. Dies kann zu Fehlern bei Setups führen, die öffentliche DNS-Server für Computer verwenden, da die Docker-Container in der Lage sein müssen, interne DNS-Namen aufzulösen.

Die Lösung besteht darin, dockerExtraHosts in den Eigenschaften desArcGIS Notebook Server-Systems zu konfigurieren:

  1. Öffnen Sie die URL des ArcGIS Notebook Server-Administratorverzeichnisses.
  2. Klicken Sie auf System > Properties > Update Properties.
  3. Fügen Sie im Dialogfeld Update System Properties eine JSON-Zeichenfolge mit den Hostnamen und IP-Adressen im folgenden Format ein:
    { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }