Upgrade von ArcGIS Notebook Server

Mit dem Upgrade von ArcGIS Notebook Server verfügt Ihre Organisation über die neuesten Funktionen und Verbesserungen der Software, während die vorhandenen Notebooks Ihrer Benutzer erhalten bleiben. Beim Upgrade Ihrer ArcGIS Enterprise-Bereitstellung müssen Sie auch ein Upgrade von ArcGIS Notebook Server auf dieselbe Version durchführen.

Das Installationspaket für ArcGIS Notebook Server erkennt, ob Sie eine bestehende Installation einer früheren Version von ArcGIS Notebook Server auf Ihrem Computer installiert haben. Wenn dies der Fall ist, können Sie ein Upgrade der Software durchführen.

Sie müssen auch neue Container-Images von Esri installieren, damit Ihre Benutzer die geeigneten Notebook-Runtimes erhalten. Da die Notebook-Runtimes der vorherigen Version in der Site nicht entfernt werden, können die Benutzer weiterhin Notebooks mit diesen Runtimes ausführen. Wenn Ihre Benutzer jedoch die Funktionalität, die in der aktuellen Version neu hinzugefügt wurde, verwenden möchten, dann müssen die Benutzer die Runtime ihrer Notebooks aktualisieren.

Hinweis:

Wenn in Notebooks benutzerdefinierte Runtimes verwendet wurden, müssen Sie die benutzerdefinierten Runtimes auf dem Windows-Notebook-Server neu erstellen und registrieren und die Runtime-Einstellungen der verknüpften Notebook-Elemente aktualisieren.

Hinweis:

Notebook-Runtimes gehen in Übereinstimmung mit dem ArcGIS Enterprise-Lebenszyklus in die Phase "Retired" über. Eine Notebook-Runtime geht zeitgleich mit der verknüpften Version von ArcGIS Enterprise in die Phase "Retired" über. In Notebooks sollten keine in die Phase "Retired" übergegangenen Runtimes verwendet werden. Nehmen Sie daher die Aktualisierung auf eine unterstützte Runtime vor.

Beim Upgrade des ArcGIS Enterprise-Portals werden auch die verfügbaren Beispiel-Notebooks in der Galerie der Site aktualisiert.

Es werden ArcGIS Notebook Server-Sites mit mehreren Computern unterstützt. Wenn Sie eine Site mit nur einem Computer verwenden und Ihre -Site nach dem Upgrade auf mehrere Computer erweitern möchten, führen Sie die Schritte zum Verbinden weiterer Computer mit der Site aus, nachdem Sie das Upgrade abgeschlossen haben.

Der Upgrade-Prozess für ArcGIS Notebook Server ist ein direktes Upgrade, bei dem das Deinstallieren und erneute Installieren von Software nicht erforderlich ist. Da die Site während des Upgrades inaktiv ist, können Benutzer bis zum Abschluss dieses Prozesses Notebooks weder aufrufen noch ausführen.

Führen Sie die folgenden Schritte aus, um das Upgrade von ArcGIS Notebook Server durchzuführen.

Vorbereiten des Upgrades von

Lesen Sie vor dem Upgrade die folgenden Informationen:

Vor dem Upgrade können Sie auf alle erforderlichen Dateien in My Esri, einschließlich der aktuellen Version der Container-Images, zugreifen.
Damit ArcGIS Notebook Server ordnungsgemäß funktioniert, muss seine Version mit der Version des Portals, in dem es eingebunden wird, übereinstimmen.
Befindet sich Ihr Notebook-Server aktuell im schreibgeschützten Modus, deaktivieren Sie den Modus vor dem Upgrade-Prozess.
Installieren einer Container-Engine für ArcGIS Notebook Server
Führen Sie ein Upgrade Ihrer ArcGIS Enterprise-Bereitstellung durch.
Führen Sie ein Upgrade für alle anderen Server durch, einschließlich ArcGIS Notebook Server.
Deinstallieren Sie Ihren bestehenden ArcGIS Notebook Server nicht. Mit den Setup- und Befehlszeilen-Installationsprogrammen für ArcGIS Notebook Server kann eine vorhandene Installation von ArcGIS Notebook Server-Komponenten erkannt und aktualisiert werden.
An keiner Stelle im Upgrade-Prozess dürfen Sie die Einbindung Ihrer ArcGIS Notebook Server-Site im Portal aufheben oder ihre Festlegung als Notebook Server des Portals entfernen. Dies würde sich auf die vorhandenen Notebooks, die durch das Portal gehostet werden, negativ auswirken.
Sie können das Upgrade für ArcGIS Notebook Server entweder über das Setup-Programm oder über das Befehlszeilen-Installationsprogramm durchführen. Verwenden Sie für das Upgrade eine der beiden Methoden.
Löschen Sie vor dem Upgrade die Caches aller Webbrowser auf dem ArcGIS Notebook Server-Computer.

Verschieben des Workspace-Verzeichnisses

Dieser Prozess ist für ArcGIS Notebook Server-Bereitstellungen auf einem Computer unter Linux erforderlich, bei denen sich ein Workspace-Verzeichnis im Notebook Server-Installationsverzeichnis befindet.

Hinweis:

Diesen Schritt müssen Sie nicht ausführen, wenn sich das Workspace-Verzeichnis bereits außerhalb des Notebook Server-Installationsverzeichnisses befindet.

Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Manager.
Klicken Sie auf die Registerkarte Einstellungen.
Klicken Sie auf Verzeichnisse.
Ermitteln Sie, ob sich der aktuelle Pfad zum arcgisworkspace-Verzeichnis im ArcGIS Notebook Server-Installationsverzeichnis befindet.

<installdir>/arcgis/notebook/directories/arcgisworkspace

Wenn sich das arcgisworkspace-Verzeichnis im ArcGIS Notebook Server-Installationsverzeichnis befindet, müssen Sie das Workspace-Verzeichnis an einen Speicherort außerhalb des Installationsverzeichnisses verschieben, bevor Sie ein Upgrade durchführen können.

Wenn sich das arcgisworkspace-Verzeichnis nicht im ArcGIS Notebook Server-Installationsverzeichnis befindet, brauchen Sie die weiteren Schritte in diesem Abschnitt nicht auszuführen.
Klicken Sie für das arcgisworkspace-Verzeichnis auf Bearbeiten.
Ersetzen Sie den vorhandenen Wert des Verzeichnispfades durch den neuen, außerhalb des Installationsverzeichnisses liegenden Pfad für das arcgisworkspace-Verzeichnis.

<installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace
Klicken Sie auf Speichern.
Kopieren Sie manuell den gesamten Inhalt des vorherigen arcgisworkspace-Verzeichnisses in das neue arcgisworkspace-Verzeichnis.

Aktualisieren des Konfigurationsspeicherorts

Dieser Prozess ist für ArcGIS Notebook Server-Bereitstellungen auf einem Computer unter Linux erforderlich, bei denen sich ein Konfigurationsspeicher im Notebook Server-Installationsverzeichnis befindet. Weitere Informationen finden Sie unter Angeben des Speicherorts für den Konfigurationsspeicher.

Hinweis:

Diesen Schritt müssen Sie nicht ausführen, wenn die Site einen cloudbasierten Konfigurationsspeicher verwendet oder wenn sich der Konfigurationsspeicher bereits außerhalb des Notebook Server-Installationsverzeichnisses befindet.

Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Manager.
Klicken Sie auf die Registerkarte Einstellungen.
Klicken Sie auf Konfigurationsspeicher.
Überprüfen Sie, ob sich der Konfigurationsspeicher im Notebook Server-Installationsverzeichnis befindet.

Beispielverzeichnis: /installation_directory/arcgis/notebookserver/usr/config-store.
Wenn sich der Konfigurationsspeicher im Notebook Server-Installationsverzeichnis befindet, verschieben Sie die Konfiguration mit den folgenden Schritten an einen externen Speicherort:
1. Aktualisieren Sie den Pfad zum neuen Speicherort.
  
  Beispielverzeichnis: /installation_directory/arcgisnotebookserver/usr/config-store.
2. Klicken Sie auf Ja, um die aktuelle Konfiguration zu verschieben.
3. Klicken Sie auf Speichern.

Aktualisieren von Serververzeichnissen

Dieser Prozess ist für ArcGIS Notebook Server-Bereitstellungen auf einem Computer unter Linux erforderlich, bei denen sich Serververzeichnisse im Notebook Server-Installationsverzeichnis befinden.

Hinweis:

Diesen Schritt müssen Sie nicht ausführen, wenn sich das Serververzeichnis bereits außerhalb des Notebook Server-Installationsverzeichnisses befindet.

Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Manager.
Klicken Sie auf die Registerkarte Einstellungen.
Klicken Sie auf Verzeichnisse.
Überprüfen Sie, ob sich die Verzeichnisse "arcgisoutput", "arcgisjobs" und "arcgissystem" im Installationsverzeichnis befinden.

/installation_directory/arcgis/notebookserver/usr/directories
Wenn sie sich im Installationsverzeichnis befinden, führen Sie für jedes Verzeichnis die folgenden Schritte aus.
1. Klicken Sie auf Bearbeiten.
2. Aktualisieren Sie den Pfad zum neuen Speicherort.
  
  Beispielverzeichnis: /installation_directory/arcgisnotebookserver/usr/directories/<server directory>.
3. Klicken Sie auf Speichern.

Aktualisieren des Protokollverzeichnisses

Dieser Prozess ist für ArcGIS Notebook Server-Bereitstellungen auf einem Computer unter Linux erforderlich, bei denen sich das Protokollverzeichnis im Notebook Server-Installationsverzeichnis befinden.

Hinweis:

Diesen Schritt müssen Sie nicht ausführen, wenn sich das Protokollverzeichnis bereits außerhalb des Notebook Server-Installationsverzeichnisses befindet.

Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Manager.
Klicken Sie auf die Registerkarte Einstellungen.
Klicken Sie auf Protokolle.
Überprüfen Sie, ob sich das Protokollverzeichnis im Installationsverzeichnis befindet.

/installation_directory/arcgis/notebookserver/usr/directories
Wenn es sich im Installationsverzeichnis befindet, führen Sie die folgenden Schritte aus, um es an einen externen Speicherort zu verschieben.
1. Aktualisieren Sie den Pfad zum neuen Speicherort.
  
  Beispielverzeichnis: /installation_directory/arcgisnotebookserver/logs.
2. Klicken Sie auf Speichern.
3. Kopieren Sie manuell alle Inhalte aus dem vorherigen Protokollverzeichnis an den neuen Speicherort.

Sichern der Bereitstellung

Vor dem Upgrade sollten Sie Sicherungskopien der Bereitstellung erstellen.

Weitere Informationen finden Sie unter Sichern und Wiederherstellen ArcGIS Notebook Server.

Durchführen eines Upgrades der Container-Engine

Führen Sie ein Upgrade der Container-Engine auf eine unterstützte Version durch.

Hinweis:

Führen Sie diesen Schritt für ein Upgrade einer Notebook Server-Site mit mehreren Computern auf jedem Computer aus.

Durchführen eines Upgrades mit dem Installationsprogramm

Hinweis:

Verwenden Sie die Setup-Datei, um ein Upgrade von ArcGIS Notebook Server durchzuführen. Nach dem Upgrade des Setups müssen Sie für die ArcGIS Notebook Server-Site ein Upgrade mithilfe des Konfigurationsassistenten oder mit dem Dienstprogramm zum Durchführen eines Upgrades für Sites durchführen.

Wenn Sie eine Site mit mehreren Computern verwenden, dann führen Sie die Schritte 1 bis 3 für einen Computer aus, und wiederholen Sie diese Schritte für jeden Computer in der Site.

Mit ArcGIS Notebook Server kann eine bestehende Installation von ArcGIS Notebook Server-Komponenten erkannt und aktualisiert werden.

Führen Sie zum Ausführen des Upgrades mit dem Installationsprogramm die folgenden Schritte aus:

Führen Sie ./Setup in dem Verzeichnis aus, in dem ArcGIS Notebook Server extrahiert wurde. Befolgen Sie dann die Anweisungen, um das Upgrade abzuschließen.

Das Setup muss mit dem Benutzerkonto ausgeführt werden, unter dem die vorhandenen ArcGIS Notebook Server-Komponenten installiert wurden. Während der Installation erkennt das Setup-Programm die vorhandene Installation, und Sie werden aufgefordert, das Upgrade zu bestätigen. Geben Sie y ein, um mit der Installation fortzufahren.

Daraufhin wird die ältere Version von ArcGIS Notebook Server deinstalliert und die neue Version von ArcGIS Notebook Server installiert.
Nachdem Sie das Upgrade-Dienstprogramm ausgeführt haben, müssen Sie die ArcGIS Notebook Server-Software neu autorisieren. Verwenden Sie für die Autorisierung den Softwareautorisierungsassistenten.
Rufen Sie den Konfigurationsassistenten über die URL auf, die angezeigt wird, nachdem Sie für die Installation ein Upgrade durchgeführt haben, und befolgen Sie die Anweisungen auf dem Bildschirm, um für die Site ein Upgrade durchzuführen.
Bei einer Site mit mehreren Computern führen Sie für die einzelnen Computer die Schritte 1 bis 3 durch.

Durchführen eines Upgrades über die Befehlszeile

Für ein Upgrade über die Befehlszeile führen Sie die folgenden Schritte aus:

Um das Upgrade zu starten, rufen Sie ./Setup in dem Verzeichnis, in dem ArcGIS Notebook Server extrahiert wurde, mit dem im Beispiel weiter unten angegebenen Argument auf und befolgen die Anweisungen zum Durchführen des Upgrades.

Daraufhin wird die ältere Version von ArcGIS Notebook Server deinstalliert und die neue Version von ArcGIS Notebook Server installiert.

<untar directory>/Setup -l yes -m silent
Nachdem Sie das Upgrade-Dienstprogramm ausgeführt haben, müssen Sie die ArcGIS Notebook Server-Software neu autorisieren. Führen Sie die Softwareautorisierung mit der folgenden Syntax aus, um ArcGIS Notebook Server automatisch zu autorisieren:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

Führen Sie den folgenden Befehl aus, um alle Optionen für die Autorisierung anzuzeigen:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

Hinweis:

Informationen zum Autorisieren von ArcGIS Notebook Server-Installationen in einer nicht verbundenen Umgebung finden Sie unten im Abschnitt Autorisieren in einer nicht verbundenen Umgebung.
Verwenden Sie zum Durchführen eines Upgrades für die Site das Befehlszeilendienstprogramm upgradesite.

Für dieses Dienstprogramm gibt es zwei Parameter:
- -s: Bei Angabe im Befehl veranlasst dieser Parameter, dass das Upgrade gestartet wird. Ohne -s wird das Upgrade nicht gestartet. Mit dieser Schutzmaßnahme soll sichergestellt werden, dass Sie das Upgrade erst dann starten, wenn Sie bereit sind.
- -h: Zeigt die Hilfe für das Dienstprogramm an. Wenn der Befehl ohne -s ausgeführt wird, wird die Hilfe auch angezeigt.
Standardmäßig ist das Dienstprogramm upgradesite unter ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh verfügbar.

Vor einem Upgrade sollten Sie sich die Informationen zur Vorbereitung am Anfang dieses Themas genau anschauen. Wenn Sie für das Upgrade bereit sind, dann öffnen Sie auf dem Computer, auf dem das Upgrade durchgeführt werden soll, ein Befehlsterminal. Navigieren Sie zu dem Verzeichnis, in dem sich das Dienstprogramm befindet, und führen Sie den folgenden Befehl aus:

> ./upgradesite.sh -s

Das Dienstprogramm zeigt Fortschrittsberichte an und wird beendet, wenn das Upgrade abgeschlossen ist.
Bei einer Site mit mehreren Computern führen Sie für die einzelnen Computer die Schritte 1 bis 3 durch und fahren dann mit dem nächsten Abschnitt fort.

Automatische Autorisierung

Nachdem Sie das Upgrade-Dienstprogramm ausgeführt haben, müssen Sie die ArcGIS Notebook Server-Software neu autorisieren.

Führen Sie die Softwareautorisierung mit der folgenden Syntax aus, um ArcGIS Notebook Server automatisch zu autorisieren:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

Führen Sie den folgenden Befehl aus, um alle Optionen für die Autorisierung anzuzeigen:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

Autorisieren in einer nicht verbundenen Umgebung

Sie können ArcGIS Notebook Server in einer nicht verbundenen Umgebung mit einer Provisioning-Datei (.prvc) autorisieren. In diesem Prozess wird eine Datei generiert, die Sie an Esri senden müssen, um den Prozess abzuschließen.

Führen Sie an der Eingabeaufforderung den unten angegebenen Befehl aus, wenn das Upgrade von ArcGIS Notebook Server abgeschlossen ist:

<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>
Nachdem die Ausgabe-Informationsdatei erstellt wurde, führen Sie einen der folgenden Schritte aus:
- Navigieren Sie zur Self-Service-Site von Esri. Folgen Sie den Anweisungen auf dem Bildschirm, um die Datei mit den Autorisierungsinformationen hoch- und die .ecp-Autorisierungsdatei herunterzuladen.
- Senden Sie die Datei mit den Autorisierungsinformationen per E-Mail an authorize@esri.com. Esri sendet die .ecp-Autorisierungsdatei per E-Mail an Sie zurück.
Wenn Sie die .ecp-Autorisierungsdatei mit einer der beiden vorstehenden Methoden empfangen haben, führen Sie das Skript authorizeSoftware erneut aus, um sie zu verarbeiten und die Serverautorisierung abzuschließen:

<ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

Wiederholen Sie diesen Workflow für jeden Computer, auf dem ArcGIS Notebook Server ausgeführt wird.

Schritte nach dem Upgrade

Bevor die ArcGIS Notebook Server-Site nach dem Upgrade und der Autorisierung verwendet werden kann, müssen Sie das Postinstallationsdienstprogramm ausführen, um der Site die neuen Docker-Container-Images hinzuzufügen. Sie müssen auch die Instanzen von ArcGIS Web Adaptor, die bei der Site registriert sind, entsprechend der neuen Version ersetzen.

Ausführen des Postinstallationsdienstprogramms

Gehen Sie zum Ausführen des Postinstallationsdienstprogramms folgendermaßen vor:‎

Öffnen Sie unter Verwendung des Installationskontos von ArcGIS Notebook Server ein Terminal.
Ändern Sie das Arbeitsverzeichnis in den Ordner für die ArcGIS Notebook Server-Werkzeuge.

Standardmäßig lautet dieser Pfad ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
Rufen Sie optional die Hilfe des Dienstprogramms durch folgenden Befehl auf:

./PostInstallUtility.sh -h
Für ArcGIS Notebook Server muss eine Container Engine auf dem Computer installiert sein. Überprüfen Sie, ob eine Container Engine auf dem Computer aktiv ist, indem Sie den folgenden Befehl ausführen:

./PostInstallUtility.sh -d
1. Wenn die Docker-Installationsanforderungen nicht erfüllt sind, führen Sie die Installation jetzt durch‏.
Laden Sie die für Ihr Setup erforderlichen Runtime-Images herunter von My Esri:
- ArcGIS Notebook Server-Python-Container-Image (Standard)
- ArcGIS Notebook Server-Python-Container-Image (Advanced)
  
  Hinweis:
  
  Die Advanced-Runtime ist nur erforderlich, wenn Sie über eine Advanced-Lizenz für ArcGIS Notebook Server verfügen.
Installieren Sie das Runtime-Image oder die Images, indem Sie deren Dateipfade angeben.

Hinweis:

Das Image sollte im .tar.gz-Format gezippt sein.

Hinweis:

Stellen Sie sicher, dass Ihr Computer über mindestens 75 GB freien Speicherplatz verfügt.

Hinweis:

Wenn Sie über eine Advanced-Lizenz verfügen, stellen Sie sicher, dass Sie beide Container-Images installieren, da Ihre Benutzer möglicherweise weiterhin die Standard-Runtime verwenden müssen.

Führen Sie den folgenden Befehl aus:

./PostInstallUtility.sh -l <path of .tar.gz Docker image>

Hinweis:

Ältere Images werden nicht automatisch entfernt. Sie müssen die mit den einzelnen Notebooks verknüpften Runtimes manuell auf die neuere Version aktualisieren, bevor Sie die vorherigen Runtime-Images löschen.

Ersetzen von ArcGIS Web Adaptor-Instanzen

Führen Sie zum Ersetzen von ArcGIS Web Adaptor-Instanzen die folgenden Schritte aus:

Entfernen Sie die Registrierung der vorherigen Instanz von ArcGIS Web Adaptor von der Site, und deinstallieren Sie die Instanz.
1. Melden Sie sich beim ArcGIS Notebook Server-Administratorverzeichnis an.
2. Navigieren Sie zu System > Web Adaptors > Registered machine.
3. Klicken Sie auf Unregister Web Adaptor.
Installieren Sie eine neue Instanz von ArcGIS Web Adaptor und konfigurieren Sie sie mit ArcGIS Notebook Server.

Nach dem Upgrade der Bereitstellung können Sie die neue Funktionalität der aktuellen Version verwenden.

Die ArcGIS Notebook Server-Site ist jetzt bereit, ArcGIS Notebooks zu hosten.

Aktualisieren der Runtimes von vorhandenen Notebooks und Web-Werkzeugen

Dieser Prozess muss von jedem Notebook-Autor durchgeführt werden, um die Notebooks und Notebook-Web-Werkzeuge zu aktualisieren und die neuesten Notebook-Runtimes zu verwenden.

Führen Sie die Schritte unter Ändern der Notebook-Runtime aus, um die Runtime jedes Notebook-Elements auf die neueste Notebook-Runtime zu aktualisieren.
Wenn ein Notebook als Web-Werkzeug veröffentlicht wird, überschreiben Sie das Web-Werkzeug nach der Aktualisierung der Notebook-Runtime.
Wenn in Notebooks benutzerdefinierte Runtimes ausgeführt wurden, aktualisieren Sie die benutzerdefinierte Runtime, und aktualisieren Sie die Runtime-Einstellungen der verknüpften Notebook-Elemente.

Entfernen vorheriger Notebook-Runtimes

Optional können Sie vorherige Versionen des ArcGIS Notebook Server-Runtime-Image entfernen, um Speicherplatz freizugeben.

Achtung:

Stellen Sie sicher, dass alle vorhandenen Notebooks auf die neueste Version des ArcGIS Notebook Server-Runtime-Image aktualisiert wurden, bevor Sie vorherige Versionen entfernen.

Öffnen Sie die Eingabeaufforderung als Administrator.
Geben Sie den folgenden Befehl ein, um die Liste der aktuellen Images anzuzeigen, und notieren Sie sich die IMAGE-ID der vorherigen Version, die Sie entfernen möchten.

docker images -a
Geben Sie den folgenden Befehl ein, um die vorherige Runtime-Version zu entfernen.

docker image rm <IMAGE ID>

ArcGIS Notebook Server unter Windows-Containern wird unter Windows Server 2022 und Windows Server 2025 unterstützt.

Hinweis:

Wenn Sie bereits eine Installation von ArcGIS Notebook Server unter Windows Server 2019 haben, müssen Sie ein Upgrade des Betriebssystems durchführen, bevor Sie ein Upgrade auf ArcGIS Notebook Server unter Windows-Containern durchführen. Alternativ können Sie eine Neuinstallation von ArcGIS Notebook Server unter Windows Server 2022 oder Windows Server 2025 durchführen und diesen als Server für Notebook Server für Ihre ArcGIS Enterprise-Bereitstellung konfigurieren.

Hinweis:

Befindet sich Ihr Notebook-Server aktuell im schreibgeschützten Modus, deaktivieren Sie den Modus vor dem Upgrade-Prozess.

Sichern der Bereitstellung

Vor dem Upgrade sollten Sie Sicherungskopien der Bereitstellung erstellen.

Weitere Informationen finden Sie unter Sichern und Wiederherstellen ArcGIS Notebook Server.

Upgrade einer ArcGIS Notebook Server-Installation auf einem unterstützten Windows-Betriebssystem

Für ein Upgrade von ArcGIS Notebook Server unter Windows Server 2022 oder Windows Server 2025 führen Sie die folgenden Schritte aus:

Führen Sie ein Upgrade Ihrer ArcGIS Enterprise-Bereitstellung durch.
Wenn Sie ein Upgrade von 11.3 oder einer früheren Version durchführen, deinstallieren Sie ArcGIS Notebook Server-Beispieldaten entweder mithilfe des Deinstallationsprogramms für ArcGIS Notebook Server-Beispieldaten oder der Befehlszeile.

Um über die Befehlszeile zu deinstallieren, führen Sie den folgenden Befehl aus:

msiexec /x {3A9E12F6-7D4B-4DA2-BA2C-C9D0E900CF94} /qb
Führen Sie das Upgrade für ArcGIS Notebook Server entweder über das Setup-Programm oder über die Befehlszeile durch.
Entfernen Sie die Registrierung der vorherigen Instanz von ArcGIS Web Adaptor von der Site.
Deinstallieren Sie ArcGIS Web Adaptor.
Installieren Sie eine neue Instanz von ArcGIS Web Adaptor und konfigurieren Sie sie mit ArcGIS Notebook Server.

Hinweis:

Stellen Sie sicher, dass für die Web Adaptor-Instanz der gleiche Name beibehalten wird.
Führen Sie ein Upgrade der Container-Engine durch.
Installieren Sie die neuesten Windows-Container-Images für ArcGIS Notebook Server.
Stellen Sie sicher, dass jeder Notebook-Autor die Runtime seiner vorhandenen Notebook-Elemente und Web-Werkzeuge auf die neueste ArcGIS Notebook Server-Runtime aktualisiert.

Weitere Informationen finden Sie im Abschnitt Ändern der Notebook-Runtime.

Wenn ein Notebook als Web-Werkzeug veröffentlicht wird, müssen Sie nach der Aktualisierung der Notebook-Runtime dieses Web-Werkzeug überschreiben.

Hinweis:

Wenn in Notebooks benutzerdefinierte Runtimes ausgeführt wurden, müssen Sie die benutzerdefinierten Runtimes auf dem Windows-Notebook-Server neu erstellen und registrieren und die Runtime-Einstellungen der verknüpften Notebook-Elemente aktualisieren.

Aktualisieren Sie die in den Runtimes konfigurierten Einstellungen für Speicher- und CPU-Auslastung.
Optional können Sie die vorherige Version des ArcGIS Notebook Server-Runtime-Image entfernen, um Speicherplatz freizugeben.

Achtung:

Stellen Sie sicher, dass alle vorhandenen Notebooks auf die neueste Version des ArcGIS Notebook Server-Runtime-Image aktualisiert wurden.
1. Erstellen Sie eine Liste der Images.
docker images -a
1. Notieren Sie die IMAGE ID der vorherigen Version des ArcGIS Notebook Server-Runtime-Image.
2. Entfernen Sie das Image.
docker image rm <IMAGE ID>

Upgrade von ArcGIS Notebook Server unter Windows Server 2022 und Migration von Linux-Containern zu Windows-Containern

Gehen Sie folgendermaßen vor, um ein Upgrade für ArcGIS Notebook Server unter Windows Server 2022 ausgehend von einer vorherigen Installation durchzuführen und von Linux-Containern zu Windows-Containern zu migrieren:

Führen Sie ein Upgrade Ihrer ArcGIS Enterprise-Bereitstellung durch.
Wenn Sie ein Upgrade von 11.3 oder einer früheren Version durchführen, deinstallieren Sie ArcGIS Notebook Server-Beispieldaten entweder mithilfe des Deinstallationsprogramms für ArcGIS Notebook Server-Beispieldaten oder der Befehlszeile.

Um über die Befehlszeile zu deinstallieren, führen Sie den folgenden Befehl aus:

msiexec /x {3A9E12F6-7D4B-4DA2-BA2C-C9D0E900CF94} /qb
Führen Sie das Upgrade für ArcGIS Notebook Server entweder über das Setup-Programm oder über die Befehlszeile durch.
Entfernen Sie die Registrierung der vorherigen Instanz von ArcGIS Web Adaptor von der Site.
Deinstallieren Sie ArcGIS Web Adaptor.
Installieren Sie eine neue Instanz von ArcGIS Web Adaptor und konfigurieren Sie sie mit ArcGIS Notebook Server.

Hinweis:

Stellen Sie sicher, dass für die Web Adaptor-Instanz der gleiche Name beibehalten wird.
Wenn der Notebook Server neu gestartet wurde und der Zugriff auf das Administratorverzeichnis möglich ist, melden Sie sich als Administrator an.
Klicken Sie auf Notebooks > Runtimes.
Führen Sie Restore Factory Runtimes aus.

Dadurch werden die Esri Notebook-Runtimes auf die Verwendung der Windows-Container-basierten Notebook-Runtime-Images aktualisiert.
Deinstallieren Sie Docker Desktop.
Installieren Sie Mirantis Container Runtime oder Docker Engine aus den Binärdateien.
Installieren Sie die neuesten Windows-Container-Images für ArcGIS Notebook Server.

Hinweis:

Wiederholen Sie im Fall einer Site mit mehreren Computern Schritt 3 und 10 bis 12 für jeden Computer der Site.
Stellen Sie sicher, dass jeder Notebook-Autor die Runtime seiner vorhandenen Notebook-Elemente und Web-Werkzeuge auf die neueste ArcGIS Notebook Server-Runtime aktualisiert.

Weitere Informationen finden Sie im Abschnitt Ändern der Notebook-Runtime.

Wenn ein Notebook als Web-Werkzeug veröffentlicht wird, müssen Sie nach der Aktualisierung der Notebook-Runtime dieses Web-Werkzeug überschreiben.

Hinweis:

Wenn in Notebooks benutzerdefinierte Runtimes verwendet wurden, müssen Sie die benutzerdefinierten Runtimes auf dem Windows-Notebook-Server neu erstellen und registrieren und die Runtime-Einstellungen der verknüpften Notebook-Elemente aktualisieren.
Aktualisieren Sie die in den Runtimes konfigurierten Einstellungen für Speicher- und CPU-Auslastung.

Upgrade von ArcGIS Notebook Server unter Windows Server 2019 mit Linux-Containern auf ArcGIS Notebook Server unter Windows Server 2022 oder Windows Server 2025 mit Windows-Containern

Um ein Upgrade auf ArcGIS Enterprise unter Windows Server 2022 oder Windows Server 2025 mit ArcGIS Notebook Server unter Windows-Containern von einer früheren Installation unter Windows Server 2019 mit Linux-Containern durchzuführen, führen Sie folgende Schritte durch:

Entfernen Sie ArcGIS Notebook Server aus ArcGIS Enterprise mit folgenden Unterschritten:
1. Melden Sie sich als Administrator Ihrer Organisation beim ArcGIS-Portalverzeichnis im Administratorverzeichnis an.
  
  Hinweis:
  
  Die URL liegt im Format https://webadaptorhost.domain.com/arcgis/portaladmin vor, wobei arcgis der Name des beim Portal registrierten Web Adaptor ist.
2. Klicken Sie auf Verbund > Server.
3. Wählen Sie den Notebook Server aus, dessen Verbindung Sie trennen möchten.
4. Klicken Sie auf Verbindung aufheben.
Führen Sie ein Upgrade Ihrer ArcGIS Enterprise-Bereitstellung durch.
Richten Sie auf dem Notebook Server-Computer die erforderliche Software ein.
Installieren Sie ArcGIS Notebook Server.
Konfigurieren Sie ArcGIS Notebook Server nach der Installation.
Erstellen Sie eine Site.
Installieren und konfigurieren Sie ArcGIS Web Adaptor.
Wiederholen Sie im Fall einer Site mit mehreren Computern die Schritte 4 und 5 für jeden Computer, und verbinden Sie zusätzliche Computer mit der Site.
Konfigurieren Sie ArcGIS Notebook Server mit dem Portal.
Stellen Sie sicher, dass jeder Notebook-Autor die Runtime seiner vorhandenen Notebook-Elemente und Web-Werkzeuge auf die neueste ArcGIS Notebook Server-Runtime aktualisiert.

Weitere Informationen finden Sie im Abschnitt Ändern der Notebook-Runtime.

Wenn ein Notebook als Web-Werkzeug veröffentlicht wird, müssen Sie nach der Aktualisierung der Notebook-Runtime dieses Web-Werkzeug überschreiben.

Hinweis:

Wenn in Notebooks benutzerdefinierte Runtimes verwendet wurden, müssen Sie die benutzerdefinierten Runtimes auf dem Windows-Notebook-Server neu erstellen und registrieren und die Runtime-Einstellungen der verknüpften Notebook-Elemente aktualisieren.
Aktualisieren Sie die in den Runtimes konfigurierten Einstellungen für Speicher- und CPU-Auslastung.

Konfigurieren einer unverbundenen Bereitstellung

Wenn Sie ArcGIS Notebook Server in einer Umgebung konfigurieren, in der keine Internetverbindung vorhanden ist oder der Internetzugriff von der Organisation nicht erlaubt wird, folgen Sie den Schritten unter Konfigurieren einer unverbundenen Bereitstellung.