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 auf 11.3 müssen Sie auch ein Upgrade von ArcGIS Notebook Server durchführen.
Das ArcGIS Notebook Server 11.3-Setup-Paket erkennt, ob eine vorherige Version von ArcGIS Notebook Server auf Ihrem Computer installiert ist. Wenn dies der Fall ist, können Sie ein Upgrade dieser Software auf 11.3 durchführen.
Beim Upgrade von Version 10.8.1 oder früher müssen Sie eine erneute Autorisierung der ArcGIS Notebook Server-Software für 11.3 durchführen.
Sie müssen auch neue Container-Images von Esri installieren, damit Ihre Benutzer die Notebook-Runtimes der Version 11.3 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 11.3 neu ist, verwenden möchten, dann müssen sie die Runtime ihrer Notebooks aktualisieren. Die Notebook-Runtimes, die 11.3 entsprechen, sind in Version 10.0 (Optionen ArcGIS Notebook Server Standard 10.0 und ArcGIS Notebook Server Advanced 10.0).
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.
Ab Version 10.7.1 werden ArcGIS Notebook Server-Sites mit mehreren Computern unterstützt. Wenn Sie eine Site mit nur einem Computer verwenden und Ihre ArcGIS Notebook Server-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 auf 11.3 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 auf 11.3 durchzuführen.
Vorbereiten des Upgrades
Lesen Sie vor dem Upgrade die folgenden Informationen:
- Vor dem Upgrade können Sie auf alle erforderlichen Dateien in My Esri, einschließlich der 11.3-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.
- Führen Sie ein Upgrade von Docker auf Version 23.0 oder höher durch.
- Um das Upgrade Ihrer ArcGIS Enterprise-Bereitstellung durchzuführen, gehen Sie wie folgt vor:
- Führen Sie ein Upgrade von Portal for ArcGIS durch.
- Führen Sie ein Upgrade von ArcGIS Web Adaptor (für das Portal) durch.
- Führen Sie ein Upgrade der ArcGIS Server-Site durch, die als Hosting-Server des Portals dient.
- Führen Sie ein Upgrade von ArcGIS Web Adaptor (für Server) durch.
- Führen Sie ein Upgrade von ArcGIS Data Store (zuerst primär und danach Standby) durch.
- Führen Sie ein Upgrade jedes anderen Servers durch, einschließlich ArcGIS Notebook Server.
- Installieren von ArcGIS Notebook Server-Beispieldaten
- Deinstallieren Sie nicht Ihren vorhandenen ArcGIS Notebook Server. 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 der 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.
- Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Server 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.
Sichern der Bereitstellung
Vor dem Upgrade sollten Sie Sicherungskopien der Bereitstellung erstellen.
In Portal-Sicherungen, die mit dem Dienstprogramm webgisdr durchgeführt werden, sind Notebooks enthalten.
Sie können den Vorgang exportSite im ArcGIS Notebook Server-Administratorverzeichnis verwenden, um den Konfigurationsspeicher einer Site wie unten beschrieben zu sichern. Zusätzlich zu dieser Sicherung der Site-Konfiguration sollten Sie auch manuell Sicherungskopien Ihres Dateisystems anfertigen.
Führen Sie zum Ausführen des Sicherungsvorgangs die folgenden Schritte aus:
- Öffnen Sie das ArcGIS Notebook Server-Administratorverzeichnis, und melden Sie sich als Benutzer mit Administratorberechtigungen an.
In der Regel lautet die URL https://notebookserver.domain.com:11443/arcgis/admin.
- Navigieren Sie zu site > Export Site.
- Geben Sie den vollständigen Pfad des Speicherorts auf Ihrem Computer an, in den Sie die Datei exportieren möchten.
Die Site muss Zugriff auf dieses Verzeichnis haben.
- Klicken Sie auf Exportieren.
Wenn der Exportvorgang abgeschlossen ist, fügt das Verzeichnis einen Link zum Speicherort der Sicherungsdatei auf dem Server hinzu.
- Laden Sie die Datei mit der Dateierweiterung .agssite so schnell wie möglich herunter.
Durchführen eines Upgrades mit dem Installationsprogramm
Hinweis:
Verwenden Sie die Setup-Datei für das Upgrade von ArcGIS Notebook Server auf 11.3. 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.
ArcGIS Notebook Server ist dafür ausgelegt, eine vorhandene Installation von ArcGIS Notebook Server-Komponenten zu erkennen und ein Upgrade durchzuführen.
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 der vorhandene ArcGIS Notebook Server installiert wurde. 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 für 11.3 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 für 11.3 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/authorizeSoftwareFühren Sie den folgenden Befehl aus, um alle Optionen für die Autorisierung anzuzeigen:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --helpHinweis:
Informationen zum Autorisieren von ArcGIS Notebook Server-Installationen in einer nicht verbundenen Umgebung finden Sie 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 -sDas 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 Dienstprogramm zum Durchführen eines Upgrades ausgeführt haben, müssen Sie die ArcGIS Notebook Server-Software für 11.3 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<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 ArcGIS Notebook Server-Upgrade 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.
- Wechseln Sie zum Ordner "Tools" von ArcGIS Notebook Server. Standardmäßig lautet der Pfad ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Rufen Sie optional die Hilfe des Dienstprogramms mit folgendem Befehl auf: ./PostInstallUtility.sh -h
- Für ArcGIS Notebook Server ist es erforderlich, dass Docker Engine auf Ihrem Computer installiert ist. Überprüfen Sie, ob Docker auf Ihrem Computer aktiv ist, indem Sie folgenden Befehl ausführen: ./PostInstallUtility.sh -d
- Wenn Docker Desktop nicht installiert ist, installieren Sie es jetzt.
- Installieren Sie das Notebooks-Image, indem Sie den entsprechenden Dateipfad angeben. Das Image sollte im .tar.gz-Format gezippt sein. Wenn Sie über eine Advanced-Lizenz und Docker Desktop verfügen, führen Sie den Befehl zweimal aus, um sowohl das Standard-Container-Image als auch das erweiterte Image, die Sie von My Esri heruntergeladen haben, zu installieren.
Hinweis:
Stellen Sie sicher, dass Ihr Computer über mindestens 75 GB freien Speicherplatz verfügt.
Führen Sie den folgenden Befehl aus: ./PostInstallUtility.sh -l <path of .tar.gz Docker image>
Hinweis:
Vergewissern Sie sich, dass beide Container-Images installiert werden. Selbst wenn Sie die Advanced-Lizenz besitzen, müssen die Benutzer ggf. die Standard-Runtime verwenden können.
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.
Installieren und Konfigurieren von ArcGIS Notebook Server-Beispieldaten
Beim Einrichten einer ArcGIS Notebook Server-Site mit mehreren Computern müssen Sie die Beispieldaten nur auf dem ersten Computer, auf dem Sie Notebook Server installiert und die Site erstellt haben, installieren und konfigurieren.
Führen Sie die folgenden Schritte aus, um ArcGIS Notebook Server-Beispieldaten zu installieren:
- Öffnen Sie eine Befehlsshell als der Benutzer, der ArcGIS Notebook Server ausführen wird. Wechseln Sie zum Verzeichnis, in das Sie die ArcGIS Notebook Server-Beispieldatendatei tar.gz von My Esri heruntergeladen haben.
- Dekomprimieren Sie die Datei tar.gz mit dem folgenden Befehl:
tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz - Navigieren Sie zu <install directory>/notebookserver/License, und lesen Sie die Lizenzvereinbarung.
- Führen Sie über das Verzeichnis das Skript aus.
./ArcGISNotebookServerSamplesData-Setup.sh - Wechseln Sie zum Ordner "Tools" von ArcGIS Notebook Server.
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ühren Sie das Dienstprogramm für die Postinstallation aus, um die Beispieldaten in das Verzeichnis "arcgisworkspace" der Notebook Server-Site zu extrahieren.
> ./PostInstallUtility.sh -x
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 in der Site, und deinstallieren Sie die Instanz.
- Melden Sie sich bei Ihrem ArcGIS Notebook Server-Administratorverzeichnis an.
- Navigieren Sie zu System > Web Adaptors > registered machine.
- Klicken Sie auf Unregister Web Adaptor.
- Installieren Sie eine neue ArcGIS Web Adaptor-11.3-Instanz, und konfigurieren Sie sie mit ArcGIS Notebook Server.
- Bei einem Upgrade von Version 10.8 oder früher gehen Sie wie folgt vor, um Zeitplan für Notebooks festlegen im Portal zu aktivieren:
- Aktualisieren Sie bei Bedarf vorhandene benutzerdefinierte Rollen, die Notebook-Berechtigungen besitzen, indem Sie die neue Berechtigung Zeitplan für Notebooks festlegen hinzufügen.
- Teilen Sie den Notebook-Autoren mit, dass sie die Runtime jedes ihrer Notebooks aktualisieren müssen, wenn sie die Planungsfunktion verwenden möchten.
Geplant werden können nur Notebooks, die die 10.8.1 Runtime (Version 4.0) oder höher verwenden.
Die ArcGIS Notebook Server-Site 11.3 ist jetzt bereit, als Host für ArcGIS Notebooks zu fungieren.