Ab Version 11.0 ist ArcGIS Notebook Server mit Windows-Containern und Mirantis Container Runtime als Beta-Version unter Windows verfügbar.
Hinweis:
Im Beta-Stadium können bei diesen Funktionen bekannte Performance- oder Qualitätsprobleme auftreten. Diese werden nicht durch den technischen Support von Esri abgedeckt.
ArcGIS Notebook Server und Windows-Container
Ähnlich wie andere ArcGIS Notebook Server-Bereitstellungen wird ArcGIS Notebook Server mit Windows-Containern unter einem Serverbetriebssystem installiert und mit einem ArcGIS Enterprise-Portal konfiguriert und verbunden. Zusätzlich kann vor der ArcGIS Notebook Server-Software ein Web Adaptor bereitgestellt werden.
ArcGIS Notebook Server verwendet als Container bezeichnete virtualisierte Betriebssysteme, um die Umgebungen von Notebook-Autoren zu isolieren. Daher können Autoren mithilfe der Container einen Teil der Serverressourcen verwenden, ohne dass ihre Arbeit oder Ressourcenverwendung zu Konflikten mit anderen führt.
Diese Container werden von der Drittanbieter-Softwarekomponente Mirantis Container Runtime (früher Docker Engine Enterprise) zugewiesen und verwaltet. Vor der Installation von ArcGIS Notebook Server müssen Sie Mirantis Container Runtime, Version 20.10 oder höher, installieren. Nach der Installation muss ArcGIS Notebook Server für die Verwendung mit Mirantis Container Runtime konfiguriert werden.
ArcGIS Notebook Server weist pro Runtime jedem Notebook-Autor in der Site einen Container zu. Die Computerressourcen, die die Autoren beim Ausführen von Notebooks verwenden, haben keine Auswirkungen auf die Container anderer Autoren.
Wenn ein Portal-Mitglied mit den entsprechenden Berechtigungen sein erstes Notebook öffnet, wird ein Container in der ArcGIS Notebook Server-Site gestartet. Die Sitzung zwischen dem Notebook und dem Container wird während der Dauer des Notebooks beibehalten.
ArcGIS Notebook Server kann mehrere Computer in einer Site verbinden. Computer in einer Konfiguration mit mehreren Computern müssen gleich konfiguriert sein. Zudem kann ArcGIS Notebooks auf jedem Computer ausgeführt werden.
Notebook-Runtimes und Windows-Container-Images
Esri stellt ein einziges Windows-Container-Image für ArcGIS Notebook Server bereit. Dieses Container-Image enthält die Notebook-Runtimes "Standard" und "Advanced", über die Python-Ressourcen in ArcGIS Notebooks zur Verfügung gestellt werden. Weitere Informationen zu den in den einzelnen Runtimes verfügbaren Bibliotheken finden Sie unter Verfügbare Python-Bibliotheken.
Die beiden ArcGIS Notebook Server-Runtimes "Standard" und "Advanced" sind in Notebooks als Bestandteil des Container-Image verfügbar. Je nach Lizenz und Benutzerberechtigung ist entweder die Runtime "Standard" oder sowohl die Runtime "Standard" als auch die Runtime "Advanced" verfügbar.
Die Windows-Container in einer ArcGIS Notebook Server-Site unterstützen zwei Modi für die Runtime-Isolation: Prozessisolation und Hyper-V-Isolation. Weitere Informationen zu den Modi finden Sie in der Microsoft-Dokumentation zu Isolationsmodi. Wenn Sie die Site für die Verwendung der Hyper-V-Isolation konfigurieren, muss auf dem Computer die Hyper-V-Rolle installiert sein.
Hinweis:
Es gibt Beschränkungen bezüglich der Anzahl der Container, die bei Verwendung von Windows-Containern mit Hyper-V ausgeführt werden können. Weitere Informationen finden Sie in diesen Microsoft-FAQ.
Beim Starten eines Containers wird das von Esri bereitgestellte Windows-Container-Image auf den Container angewendet. Die Runtime ist von der für ArcGIS Notebook Server konfigurierten Lizenz und von der Berechtigung des Notebook-Autors abhängig.
Hinweis:
In Version 11.0 ist eine Einschränkung bekannt, die dazu führen kann, dass beim Importieren der torch-Bibliothek oder von Python-Bibliotheken mit torch als Abhängigkeit WinError 1455 auftritt.
Hinweis:
fiona, rasterstats und rasterio sind nicht in den Windows-Containern installiert.
Einrichten von erforderlicher Software
Vor der Installation von ArcGIS Notebook Server müssen Sie die folgende erforderliche Software installieren und konfigurieren.
Systemanforderungen
Für die Installation von ArcGIS Notebook Server mit Windows-Containern müssen die folgenden Systemanforderungen erfüllt sein:
- Windows Server 2022 ist das einzige Betriebssystem, das für ArcGIS Notebook Server mit Windows-Containern unterstützt wird.
- Für ArcGIS Notebook Server mit Windows-Containern ist Mirantis Container Runtime, Version 20.10 oder höher, erforderlich.
- Hyper-V ist abhängig von dem für Ihre ArcGIS Notebook Server-Site ausgewählten Runtime-Isolationsmodus optional.
- Für ArcGIS Notebook Server mit Windows-Containern ist ein verfügbarer Speicherplatz von mindestens 75 GB erforderlich.
- Lesen Sie die ArcGIS Notebook Server-Systemanforderungen.
Aktivieren von Hyper-V (optional)
Hyper-V ist nur erforderlich, wenn Sie Windows-Container im Hyper-V-Isolationsmodus ausführen möchten.
Informationen zum Aktivieren von Hyper-V finden Sie in der Microsoft-Dokumentation unter Installieren der Hyper-V-Rolle auf Windows Server.
Installieren von Mirantis Container Runtime
Führen Sie die folgenden Schritte aus, um Mirantis Container Runtime auf Ihrem Computer zu installieren.
- Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.
- Aktivieren Sie die Funktion Container auf Ihrem lokalen Server erst nach der Installation von Mirantis Container Runtime. Wenn diese Funktion bereits aktiviert ist, deaktivieren Sie sie auf dem Servercomputer. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Installieren oder Deinstallieren von Rollen, Rollendiensten oder Features.
- Führen Sie die Schritte unter Install Mirantis Container Runtime on Windows Server in der Dokumentation von Mirantis aus.
- Vergewissern Sie sich durch Ausführen des folgenden Befehls, dass Mirantis Container Runtime installiert ist und gestartet wurde:
docker run hello-world:nanoserver - Führen Sie nach der Fertigstellung die folgenden Schritte zur Konfiguration von Mirantis Container Runtime aus.
Konfigurieren von Mirantis Container Runtime
- Aktivieren Sie Port 2375, um die Verwendung der Docker-Remote-API zu aktivieren. Dieser Port wird lediglich intern von ArcGIS Notebook Server verwendet und sollte vor externen Zugriffen geschützt werden. Öffnen Sie zum Aktivieren des Ports eine Eingabeaufforderung als Administrator, und führen Sie den folgenden Befehl aus:
sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://" - Öffnen Sie als Administrator ein PowerShell-Fenster, und führen Sie den folgenden Befehl aus:
Restart-Service docker - Starten Sie Ihren Computer nach der Installation der Docker-Komponente neu.
Hinweis:
Bei jeder Installation und jedem Upgrade der Docker-Komponente müssen Sie den Computer neu starten.
Installieren von ArcGIS Notebook Server
Führen Sie die Schritte im Hilfethema Installieren von ArcGIS Notebook Server aus, um ArcGIS Notebook Server mithilfe des Installationsassistenten oder über die Befehlszeile zu installieren.
Konfigurieren von ArcGIS Notebook Server nach der Installation
Führen Sie nach Abschluss der Installation von ArcGIS Notebook Server das Postinstallationsdienstprogramm aus, um das Windows-Container-Image zu installieren. Registrieren Sie sich für das ArcGIS Enterprise Beta Feature Testing Program in der Esri Early Adopter Community (EAC), um das Windows-Container-Image herunterzuladen. Führen Sie die folgenden Schritte für jeden Computer aus, auf dem Sie ArcGIS Notebook Server installiert haben.
- Öffnen Sie das Eingabeaufforderungsfenster als Administrator.
- Wechseln Sie zum Ordner "Tools" von ArcGIS Notebook Server. Der Pfad lautet standardmäßig C:\Program Files\ArcGIS\NotebookServer\tools\PostInstallUtility.
- Überprüfen Sie, ob Mirantis Container Runtime auf dem Computer aktiv ist, indem Sie den folgenden Befehl ausführen:
PostInstallUtility.bat -d - Wenn Mirantis Container Runtime nicht installiert ist, installieren und konfigurieren Sie die Runtime mithilfe der oben bereitgestellten Anweisungen.
- Führen Sie den folgenden Befehl aus:
> PostInstallUtility.bat -l <path of .tar.gz Docker image>
Erstellen einer ArcGIS Notebook Server-Site
Nachdem Sie ArcGIS Notebook Server installiert und das Windows-Container-Image mit dem Postinstallationsdienstprogramm konfiguriert haben, erstellen Sie mithilfe der Anweisungen unter Erstellen einer ArcGIS Notebook Server-Site eine Server-Site.
Hinweis:
Wenn Sie ArcGIS Notebook Server auf mehreren Computern bereitstellen möchten, lesen Sie vor dem Erstellen einer Site den folgenden Abschnitt "Überlegungen zu den Notebook Server-Verzeichnissen und zum Konfigurationsspeicher".
Überlegungen zu den Notebook Server-Verzeichnissen und zum Konfigurationsspeicher
Wenn Sie ArcGIS Notebook Server auf mehreren Computern bereitstellen möchten, muss für das Inhaltsverzeichnis und den Konfigurationsspeicher ein freigegebenes Verzeichnis verwendet werden, das über einen UNC-Pfad (Universal Naming Convention) referenziert wird. Für das Workspace-Verzeichnis muss immer ein UNC-Pfad verwendet werden, der auf allen an der Site beteiligten Computern als zugeordnetes Netzlaufwerk mit übereinstimmendem Laufwerksbuchstaben konfiguriert ist und als Workspace-Laufwerk verwendet wird.
Anweisungen zum Konfigurieren eines zugeordneten Netzlaufwerks finden Sie weiter unten im Abschnitt Einrichten eines zugeordneten Netzlaufwerks für das Workspace-Verzeichnis.
Aktivieren eines Windows-Container-Features für Notebook Server
Führen Sie nach der erfolgreichen Erstellung der Site die folgenden Schritte aus, um der Verwendung von ArcGIS Notebook Server mit Windows-Containern zuzustimmen. Melden Sie sich nach der Erstellung der ArcGIS Notebook Server-Site bei der administrativen API an, um sicherzustellen, dass die Site für die Verwendung von Windows-Containern konfiguriert ist.
- Melden Sie sich als Administrator beim ArcGIS Notebook Server-Administratorverzeichnis an.
- Klicken Sie auf System > Eigenschaften.
- Klicken Sie auf Eigenschaften aktualisieren.
- Aktualisieren Sie die useWindowsContainers-Eigenschaft, indem Sie sie auf true festlegen.
- Klicken Sie auf Eigenschaften aktualisieren, um die Änderungen zu speichern.
- Wenn der Notebook-Server neu gestartet wurde und der Zugriff auf das Administratorverzeichnis möglich ist, klicken Sie auf Notebook > Runtimes > Restore Factory Runtimes.
https://notebook.domain.com:11443/arcgis/admin/notebooks/runtimes/restore
- Klicken Sie auf Restore Factory Runtimes, um die Notebook Server-Runtimes "Standard" und "Advanced" so zu aktualisieren, dass die Windows-Container-Images verwendet werden.
Installieren und Konfigurieren von ArcGIS Web Adaptor für ArcGIS Notebook Server
Nachdem Sie Ihre ArcGIS Notebook Server-Site erstellt haben, müssen Sie ArcGIS Web Adaptor installieren und beim ArcGIS Notebook Server registrieren. Weitere Informationen finden Sie unter Installieren und Konfigurieren von ArcGIS Web Adaptor für ArcGIS Notebook Server.
Installieren und Konfigurieren von ArcGIS Notebook Server-Beispieldaten
ArcGIS Notebook Server-Beispieldaten sind für in ArcGIS Notebook Server enthaltene von Esri kuratierte Beispiel-Notebooks erforderlich. Weitere Informationen finden Sie unter Installieren und Konfigurieren von ArcGIS Notebook Server-Beispieldaten.
Konfigurieren von Notebook Server mit ArcGIS Enterprise-Portal
Nachdem Sie ArcGIS Notebook Server installiert und mit Mirantis Container Runtime konfiguriert haben, eine Server-Site erstellt haben und diese bei einem Web Adaptor registriert haben, können Sie die Site mit einem ArcGIS Enterprise-Portal konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von ArcGIS Notebook Server für das Portal.
Verbinden zusätzlicher Computer mit der ArcGIS Notebook Server-Site
ArcGIS Notebook Server unterstützt Sites mit mehreren Computern. In einer Site mit mehreren Computern müssen alle Computer gleich konfiguriert sein, das heißt, sie müssen mit dem gleichen Betriebssystem, identischen Mirantis Container Runtime-Setups und zugeordneten Netzlaufwerken mit gleichem Laufwerksbuchstaben für das Workspace-Verzeichnis konfiguriert sein. Weitere Informationen finden Sie im Thema "Verbinden zusätzlicher Computer mit einer ArcGIS Notebook Server-Site" im Abschnitt Installieren und Konfigurieren einer Site mit mehreren Computern.
Einrichten eines zugeordneten Netzlaufwerks für das Workspace-Verzeichnis
Dieser optionale Prozess ist nur notwendig, wenn Sie eine Notebook Server-Site mit mehreren Computern einrichten möchten.
- Erstellen Sie eine UNC-Freigabe für das ArcGIS Notebook Server-Workspace-Verzeichnis auf einem separaten Computer, auf den über Notebook Server zugegriffen werden kann.
Hinweis:
Dieses Verzeichnis muss über Lese-/Schreibzugriff auf das ausführende ArcGIS Notebook Server Windows-Konto verfügen. Es wird empfohlen, eine UNC-Freigabe für das ArcGIS Notebook Server-Workspace-Verzeichnis auf einem anderen als dem an der ArcGIS Notebook Server-Site beteiligten Computer zu erstellen. Es besteht ein bekanntes Problem, bei dem SMB-Freigaben, die auf dem gleichen Computer wie Notebook Server erstellt werden, beim Neustarten des Computers getrennt werden. - Öffnen Sie auf dem Notebook Server-Computer als Administrator ein PowerShell-Fenster.
- Speichern Sie mit dem folgenden Befehl das Kennwort Ihres ArcGIS Notebook Server-Benutzerkontos als gesicherte Zeichenfolge zur späteren Verwendung:
$password = ConvertTo-SecureString '<password>' -AsPlainText -Force - Fügen Sie den PowerShell-Funktionen Unterstützung für Anmeldeinformationen hinzu:
$credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password) - Stellen Sie den Ordner mit festgelegtem Flag "Persistent" bereit:
New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>: - Wiederholen Sie die Schritte 2 bis 5 auf allen an der ArcGIS Notebook Server-Site beteiligten Computern, und weisen Sie auf allen Computern dem zugeordneten Netzlaufwerk den gleichen Laufwerksbuchstaben zu.
- Verwenden Sie das im vorherigen Schritt erstellte freigegebene Netzlaufwerk beim Erstellen der ArcGIS Notebook Server-Site zum Konfigurieren des Workspace-Verzeichnisses.
Erweitern einer Notebook-Runtime
Weitere Informationen finden Sie unter Erweitern einer Notebook-Runtime.
Nach der erfolgreichen Ausführung der Schritte in diesem Thema verfügen Sie über eine ArcGIS Notebook Server-Bereitstellung, die mit Windows-Containern eingerichtet ist.