Skip to main content

Installieren einer Container-Engine für ArcGIS Notebook Server

In den folgenden Schritten wird beschrieben, wie Sie die für ArcGIS Notebook Server erforderliche Software zur Container-Zuordnung herunterladen, installieren und konfigurieren. Eine Einführung in Container-Engines und deren Verwendung in ArcGIS Notebook Server finden Sie unter Container-Engines und ArcGIS Notebook Server.

Herunterladen und Installieren einer Container-Engine

Für Linux-Systeme sind zwei Container-Engines verfügbar: Docker Engine und Mirantis Container Runtime.

Wenn Sie Ubuntu oder Red Hat Enterprise Linux Server verwenden, können Sie beide Editionen von Docker verwenden.

Container-Engine

Betriebssystem

Docker Engine Community Edition 29.2.0 oder höher

Hinweis:

Wenn Sie die Docker Engine-Version 29 oder höher verwenden und für die Anwendung ein Upgrade von der vorherigen Version durchgeführt wurde, bearbeiten Sie /etc/docker/daemon.json, um den Bildspeicher im Container zu aktivieren. Weitere Informationen finden Sie in Schritt 4 unter Konfigurieren der Docker-Einstellungen und -Umgebungen.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 Update 10

Red Hat Enterprise Linux Server 9 Update 7

Rocky Linux 8 Update 10

Rocky Linux 9 Update 7

AlmaLinux 8 Update 10

AlmaLinux 9 Update 7

Mirantis Container Runtime-Version 25.0.15 oder höher

Hinweis:

Aktuelle Informationen finden Sie unter Kompatibilitätsmatrix für Mirantis Container Runtime 25.0

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 Update 10

Red Hat Enterprise Linux Server 9 Update 7

Oracle Linux 9 Update 7

Rocky Linux 8 Update 10

Rocky Linux 9 Update 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server unter Windows mit Mirantis Container Runtime unterstützt die folgenden Betriebssysteme:

Betriebssystem

Container-Engine

Zusätzliche Anforderungen

Windows Server 2022 Standard und Datacenter

Mirantis Container Runtime-Version 25.0.15 oder höher

Optional können Sie Hyper-V installieren.

Hinweis:

Es gibt Beschränkungen bezüglich der maximalen Anzahl an Containern, die mit der Hyper-V-Isolation unter Windows Server Standard ausgeführt werden kann.

Weitere Informationen finden Sie im Windows-FAQ.

Docker Engine aus Binärdateien

ArcGIS Notebook Server unter Windows mit Docker Engine aus Binärdateien unterstützt die folgenden Betriebssysteme und Docker Engine-Versionen:

Betriebssystem

Container-Engine

Zusätzliche Anforderungen

Windows Server 2025 Standard und Datacenter

Windows Server 2022 Standard und Datacenter

Docker Engine Community Version 29.2.0 oder höher

Optional können Sie Hyper-V installieren.

Hinweis:

Es gibt Beschränkungen bezüglich der maximalen Anzahl an Containern, die mit der Hyper-V-Isolation unter Windows Server Standard ausgeführt werden kann.

Weitere Informationen finden Sie im Windows-FAQ.
Hinweis:

Da es sich bei Docker um die Software eines Drittanbieters handelt, wird in diesem Thema keine detaillierte Beschreibung der Schritte zur Installation von Docker bereitgestellt. Aktuelle Informationen finden Sie auf der Website von Docker.

Installieren von Mirantis Container Runtime unter Red Hat Enterprise Linux Server, Ubuntu, SUSE Linux Enterprise Server und Oracle Linux

Für die Installation von Mirantis Container Runtime benötigen Sie eine Testversion oder eine Subskription der Software.

  1. Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.

    Informationen zur Deinstallation finden Sie in der Dokumentation zur jeweiligen Version von Docker.

  2. Führen Sie die Schritte für Ihre Linux-Distribution gemäß der Mirantis Container Runtime-Installationsanleitung aus.

    Hinweis:

    Mirantis stellt derzeit keine eigene Installationsanleitung für Rocky Linux bereit, jedoch kann für die Installation unter Linux die Red Hat Enterprise Rocky Linux-Installationsanleitung verwendet werden.

    Hinweis:

    In dem Dokument werden die beiden Installationsmethoden beschrieben (über ein Docker-Repository oder ein RPM-Paket).

  3. Da Docker nach der Installation und Konfiguration nicht automatisch gestartet wird, starten Sie den Docker-Daemon mit dem folgenden Befehl:

$ sudo systemctl start docker

  1. Vergewissern Sie sich, dass Docker ordnungsgemäß installiert ist und Sie auf die Container-Images zugreifen können. Führen Sie dazu den folgenden Befehl aus:

$ sudo docker run hello-world

Fahren Sie mit dem Abschnitt Konfigurieren der Docker-Einstellungen und -Umgebungen fort.

Installieren von Docker Engine unter Red Hat Enterprise Linux Server, Oracle Linux, Rocky Linux oder AlmaLinux

Die Docker Engine-Edition kann kostenlos heruntergeladen werden, vorausgesetzt, Sie verfügen über ein Docker-Konto.

  1. Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.

    Informationen zur Deinstallation finden Sie in der Dokumentation zur jeweiligen Version von Docker.

  2. Führen Sie die Schritte unter Install Engine on RHEL aus.

    In dem Dokument werden die beiden Installationsmethoden beschrieben (über ein RPM-Repository oder ein RPM-Paket).

    Der Docker-Daemon wird nach der Installation automatisch gestartet.

  3. Vergewissern Sie sich, dass Docker ordnungsgemäß installiert ist und Sie auf die Container-Images zugreifen können. Führen Sie dazu den folgenden Befehl aus:

$ sudo docker run hello-world

Fahren Sie mit dem Abschnitt Konfigurieren der Docker-Einstellungen und -Umgebungen fort.

Installieren von Docker Engine unter Ubuntu

Die Docker Engine-Edition kann kostenlos heruntergeladen werden, vorausgesetzt, Sie verfügen über ein Docker-Konto.

  1. Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.

    Informationen zur Deinstallation finden Sie in der Dokumentation zur jeweiligen Version von Docker.

  2. Führen Sie die Schritte unter Install Engine on Ubuntu aus.

    In dem Dokument werden die beiden Installationsmethoden beschrieben (über ein Docker-Repository oder ein DEB-Paket).

    Der Docker-Daemon wird nach der Installation automatisch gestartet.

  3. Vergewissern Sie sich, dass Docker ordnungsgemäß installiert ist und Sie auf die Container-Images zugreifen können. Führen Sie dazu den folgenden Befehl aus:

$ sudo docker run hello-world

Fahren Sie mit dem Abschnitt Konfigurieren der Docker-Einstellungen und -Umgebungen fort.

Konfiguration von Docker-Einstellungen und -Umgebungen

Nach der Installation der entsprechenden Docker-Edition auf Ihrem Rechner konfigurieren Sie Docker für die Verwendung mit ArcGIS Notebook Server.

  1. Fügen Sie Ihr Betriebssystembenutzerkonto (bzw. das Konto, über das Sie ArcGIS Notebook Server installiert haben) zur Gruppe docker hinzu. Diese wurde während der Installation automatisch erstellt.

$ sudo usermod -aG docker <ArcGIS Notebook Server install account>

  1. Melden Sie sich von Ihrem Betriebssystembenutzerkonto ab und wieder an, damit die Änderungen wirksam werden.

  2. Überprüfen Sie, ob Sie über das Konto Docker-Befehle ausführen können.

$ docker run hello-world

  1. Wenn Sie die Docker Engine-Version 29 oder höher verwenden und für die Anwendung ein Upgrade von der vorherigen Version durchgeführt wurde, bearbeiten Sie /etc/docker/daemon.json, um den Bildspeicher im Container zu aktivieren.

    {
  "features": {
    "containerd-snapshotter": true
  }
}
    Hinweis:

    Wenn daemon.json nicht vorhanden ist, erstellen Sie den Ordner.

  2. Stellen Sie sicher, dass für das Verzeichnis /var mindestens 75 GB freier Speicherplatz verfügbar ist.

    Docker verwendet das Verzeichnis /var in der lokalen Registrierung für Container-Images. Während des Upgrade-Vorgangs für nachfolgende Versionen werden neue Images ebenfalls in das Verzeichnis /var kopiert. Wenn nicht genügend Speicherplatz vorhanden ist, erhöhen Sie entweder die Zuweisung für das Verzeichnis /var, oder befolgen Sie die folgenden untergeordneten Schritte, um den Speicherort des Docker-Stammverzeichnisses zu ändern.

    1. Bearbeiten Sie die Datei /etc/docker/daemon.json, um "data-root" auf ein lokales Verzeichnis auf Ihrem Computer mit ausreichend Speicherplatz festzulegen.

      Hinweis:

      Falls diese Datei nicht vorhanden ist, erstellen Sie sie.

      Beispielpfad:

      {"data-root" : "/data/docker"}

      Im Folgenden sehen Sie ein Beispiel für /etc/docker/daemon.json mit den Eigenschaften "containerd-snapshotter" und "data-root":

      {
   "features": {
      "containerd-snapshotter": true
   },
   "data-root" : "/data/docker"
}

    2. Entfernen Sie /var/lib/docker, und erstellen Sie eine Symbolverknüpfung, die auf den im vorherigen Schritt angegebenen Pfad verweist.

       $ sudo mkdir /data/docker
   $ sudo rm -rf /var/lib/docker
   $ sudo ln -s /data/docker /var/lib/docker
    1. Dieser Schritt ist nur bei Verwendung der Docker-Container-Engine-Version 29 erforderlich. Entfernen Sie /var/lib/containerd, und erstellen Sie eine Symbolverknüpfung, die auf den im vorherigen Schritt angegebenen Pfad verweist.
       $ sudo mkdir /data/containerd
   $ sudo rm -rf /var/lib/containerd
   $ sudo ln -s /data/containerd /var/lib/containerd

  3. Starten Sie den Docker-Service neu, um die Änderungen zu übernehmen.

    $ sudo systemctl stop docker.service
$ sudo systemctl stop docker.socket
$ sudo systemctl stop containerd
$ sudo systemctl start containerd
$ sudo systemctl start docker.service
$ sudo systemctl start docker.socket

Sie können jetzt ArcGIS Notebook Server auf Ihrem Computer installieren.

Container-Engine-Anforderungen

ArcGIS Notebook Server unter Windows unterstützt Mirantis Container Runtime und Docker Engine aus Binärdateien als Container-Engines. Eine Einführung in Container-Engines und deren Integration in ArcGIS Notebook Server finden Sie unter Container-Engines und ArcGIS Notebook Server.

Für Linux-Systeme sind zwei Container-Engines verfügbar: Docker Engine und Mirantis Container Runtime.

Wenn Sie Ubuntu oder Red Hat Enterprise Linux Server verwenden, können Sie beide Editionen von Docker verwenden.

Container-Engine

Betriebssystem

Docker Engine Community Edition 29.2.0 oder höher

Hinweis:

Wenn Sie die Docker Engine-Version 29 oder höher verwenden und für die Anwendung ein Upgrade von der vorherigen Version durchgeführt wurde, bearbeiten Sie /etc/docker/daemon.json, um den Bildspeicher im Container zu aktivieren. Weitere Informationen finden Sie in Schritt 4 unter Konfigurieren der Docker-Einstellungen und -Umgebungen.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 Update 10

Red Hat Enterprise Linux Server 9 Update 7

Rocky Linux 8 Update 10

Rocky Linux 9 Update 7

AlmaLinux 8 Update 10

AlmaLinux 9 Update 7

Mirantis Container Runtime-Version 25.0.15 oder höher

Hinweis:

Aktuelle Informationen finden Sie unter Kompatibilitätsmatrix für Mirantis Container Runtime 25.0

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 Update 10

Red Hat Enterprise Linux Server 9 Update 7

Oracle Linux 9 Update 7

Rocky Linux 8 Update 10

Rocky Linux 9 Update 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server unter Windows mit Mirantis Container Runtime unterstützt die folgenden Betriebssysteme:

Betriebssystem

Container-Engine

Zusätzliche Anforderungen

Windows Server 2022 Standard und Datacenter

Mirantis Container Runtime-Version 25.0.15 oder höher

Optional können Sie Hyper-V installieren.

Hinweis:

Es gibt Beschränkungen bezüglich der maximalen Anzahl an Containern, die mit der Hyper-V-Isolation unter Windows Server Standard ausgeführt werden kann.

Weitere Informationen finden Sie im Windows-FAQ.

Docker Engine aus Binärdateien

ArcGIS Notebook Server unter Windows mit Docker Engine aus Binärdateien unterstützt die folgenden Betriebssysteme und Docker Engine-Versionen:

Betriebssystem

Container-Engine

Zusätzliche Anforderungen

Windows Server 2025 Standard und Datacenter

Windows Server 2022 Standard und Datacenter

Docker Engine Community Version 29.2.0 oder höher

Optional können Sie Hyper-V installieren.

Hinweis:

Es gibt Beschränkungen bezüglich der maximalen Anzahl an Containern, die mit der Hyper-V-Isolation unter Windows Server Standard ausgeführt werden kann.

Weitere Informationen finden Sie im Windows-FAQ.

Installieren von Mirantis Container Runtime

Führen Sie die folgenden Schritte aus, um Mirantis Container Runtime zu installieren:

  1. Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.

  2. 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.

  3. Führen Sie die Schritte unter Install Mirantis Container Runtime on Windows Server in der Mirantis-Dokumentation aus, um das install.ps1-Installationsskript für Mirantis Container Runtime für Windows Server abzurufen und auszuführen.

    Verwenden Sie zum Ausführen des Installationsskriptes den folgenden Code:

    ./install.ps1

  4. Vergewissern Sie sich, dass Mirantis Container Runtime korrekt installiert ist und durch den folgenden Befehl gestartet wurde:

docker run hello-world:nanoserver

  1. Führen Sie nach der Fertigstellung die unter Konfigurieren der Docker-Komponente beschriebenen Schritte zur Konfiguration von Mirantis Container Runtime aus.

Installieren von Docker Engine aus Binärdateien

Führen Sie zum Installieren von Docker Engine aus Binärdateien die folgenden Schritte aus:

  1. Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.

  2. Deaktivieren Sie die Funktion "Container" auf Ihrem lokalen Server, falls sie aktiviert ist.

    Weitere Informationen finden Sie in der Microsoft-Dokumentation.

  3. Aktivieren Sie die Funktion "Container", indem Sie in Microsoft PowerShell den folgenden Befehl mit Administratorberechtigungen ausführen:

Add-WindowsFeature Containers

  1. Folgen Sie den Eingabeaufforderungen, um den Computer neu zu starten.

  2. Überprüfen Sie die Installation der Funktion "Container", indem Sie den folgenden Befehl ausführen:

Get-WindowsFeature Containers

  1. Befolgen Sie die Anweisungen im Abschnitt Install server and client binaries on Windows in der Docker-Dokumentation.

    Hinweis:

    Docker Engine aus Binärdateien wird nicht automatisch aktualisiert. Sie müssen die Aktualisierung auf neuere Docker-Versionen manuell durchführen. Weitere Informationen zu Einschränkungen bei der Verwendung von Docker aus Binärdateien in einer Produktionsumgebung finden Sie in der Dokumentation Installieren von Docker Engine aus Binärdateien. Auf dieser Seite wird zwar die Verwendung von Docker Desktop empfohlen, jedoch unterstützt ArcGIS Notebook Server mit Windows-Containern Docker Desktop unter Windows nicht als Container-Engine.

  2. Fügen Sie in den Systemvariablen der PATH-Umgebungsvariable den Docker-Verzeichnispfad hinzu, z. B. C:\Program Files\docker.

  3. Überprüfen Sie den Ausführungsstatus der Installation und des Docker-Daemons mit dem folgenden Befehl:

docker version

  1. Führen Sie nach der Fertigstellung die unter Konfigurieren der Docker-Komponente beschriebenen Schritte zur Konfiguration von Docker Engine aus.

Konfigurieren der Docker-Komponente

Führen Sie die folgenden Schritte aus, um die Docker-Komponente zu konfigurieren:

  1. Wenn das zum Installieren von ArcGIS Notebook Server verwendete Konto nicht Teil der Administratorgruppe ist, führen Sie die folgenden Schritte aus:

    1. Öffnen Sie über das Start-Menü Ihres Windows-Computers die Anwendung Computerverwaltung.

    2. Blenden Sie auf der linken Seitenleiste das Element Lokale Benutzer und Gruppen ein, und öffnen Sie den Ordner Gruppen.

    3. Wählen Sie die Gruppe docker-users aus der Gruppenliste aus, und doppelklicken Sie darauf.

      Falls die Gruppe docker-users noch nicht vorhanden ist, erstellen Sie sie.

    4. Klicken Sie auf die Schaltfläche Hinzufügen, suchen Sie das zum Installieren von ArcGIS Notebook Server verwendete Konto, und wählen Sie es aus. Klicken Sie zur Bestätigung auf OK.

    5. Klicken Sie auf OK, um das Dialogfeld mit den Gruppen zu schließen.

    6. Erstellen Sie unter C:\ProgramData\docker\config\daemon.json eine Konfigurationsdatei, um eine Sicherheitsgruppe für Docker festzulegen.

    7. Bearbeiten Sie C:\ProgramData\docker\config\daemon.json, um die Gruppe docker-users hinzuzufügen.

       {
     "group" : "docker-users"
   }

  2. Konfigurieren Sie den Docker-Service mit dem folgenden Befehl zur Überwachung einer benannten Pipe:

sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H npipe://"

  1. Führen Sie mit dem folgenden Befehl den Neustart von Docker aus:

    net stop docker
net start docker

  2. 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.

Ändern des Standardinstallationsverzeichnisses für das Docker-Image

Führen Sie optional die folgenden Schritte aus, um das Standardinstallationsverzeichnis für das Docker-Image zu ändern:

  1. Bearbeiten Sie die Datei unter C:\ProgramData\docker\config\daemon.json.

  2. Ändern Sie das Standardinstallationsverzeichnis für das Docker-Image, indem Sie für data-root den gewünschten Speicherort auf dem lokalen Computer festlegen.

     {
"data-root": "d:\\\\docker"
}

  3. Speichern Sie daemon.json.

  4. Starten Sie Docker mit dem folgenden Befehl neu:

    net stop docker
net start docker

Sie können jetzt ArcGIS Notebook Server auf Ihrem Computer installieren.

Konfigurieren eines nicht standardmäßigen temporären Verzeichnisses für Docker

Docker Engine 29.4 und höher unterstützt die Konfiguration von nicht standardmäßigen temporären Verzeichnissen mithilfe der Umgebungsvariablen DOCKER_TMPDIR. Mit dieser Umgebungsvariablen kann Docker ein anderes Verzeichnis als das Standardverzeichnis "C:\temp" für temporäre Daten verwenden, beispielsweise nach der Installation beim Laden des Notebook-Runtime-Image. Führen Sie die folgenden Schritte aus, um ein nicht standardmäßiges temporäres Verzeichnis für Docker zu konfigurieren:

  1. Erstellen Sie ein temporäres Verzeichnis auf einem anderen Laufwerk als dem Standardlaufwerk.

    Beispiel:

    d:\docker-temp

  2. Klicken Sie in Windows auf Systemeigenschaften > Erweitert > Umgebungsvariablen > Systemvariablen.

  3. Legen Sie eine systemweite Umgebungsvariable mit den folgenden Informationen fest:

    Variablenname: DOCKER_TMPDIR

    Variablenwert: <new temporary directory created in step 1>

  4. Starten Sie den Docker-Service neu:

    net stop docker
net start docker