Mit dem Upgrade von ArcGIS Notebook Server erhält Ihre Organisation die neuesten Funktionen und Verbesserungen an der Software, während die vorhandenen ArcGIS Notebooks Ihrer Benutzer erhalten bleiben. Beim Upgrade Ihrer ArcGIS Enterprise-Bereitstellung auf 10.9 müssen Sie auch ein Upgrade von ArcGIS Notebook Server durchführen.
Das ArcGIS Notebook Server 10.9-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 10.9 durchführen.
Beim Upgrade von Version 10.8.1 oder früher müssen Sie eine erneute Autorisierung Ihrer ArcGIS Notebook Server-Software für 10.9 durchführen.
Sie müssen auch neue Container-Images von Esri installieren, damit Ihre Benutzer die 10.9 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 10.9 neu ist, verwenden möchten, dann müssen sie die Runtime ihrer Notebooks aktualisieren. Die Notebook-Runtimes, die 10.9 entsprechen, sind in Version 5.0 (ArcGIS Notebook Server Standard 5.0 und ArcGIS Notebook Server Advanced 5.0).
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, dann führen Sie die Schritte zum Verbinden weiterer Computer mit der Site aus, nachdem Sie das Upgrade auf 10.9 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 10.9 durchzuführen.
Vorbereiten des Upgrades
Lesen Sie vor dem Upgrade sorgfältig die folgenden Informationen:
- Vor dem Upgrade können Sie auf alle erforderlichen Dateien in My Esri, einschließlich der 10.9-Container-Images, zugreifen.
- Damit ArcGIS Notebook Server ordnungsgemäß funktioniert, muss seine Version mit der Version des Portals, in dem es eingebunden wird, übereinstimmen.
- Führen Sie ein Upgrade von Docker auf eine unterstützte Version 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 Ihrer ArcGIS Notebook Server-Site im Portal aufheben oder ihre Festlegung als Notebook-Server des Portals entfernen. Dies würde sich auf die vorhandenen ArcGIS 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.
Sichern der Bereitstellung
Vor dem Upgrade sollten Sie unbedingt Sicherungskopien Ihrer Bereitstellung erstellen.
Vorversion:
In 10.7 müssen Sie den Konfigurationsspeicher und die Serververzeichnisse der Site manuell sichern.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 die folgenden Schritte aus, um den Sicherungsvorgang auszuführen:
- Ö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 > Site exportieren.
- Geben Sie den vollständigen Pfad des Speicherorts auf Ihrem Computer ein, 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 10.9. 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. Um das Upgrade zu starten, starten Sie ./Setup in dem Verzeichnis, 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 Dienstprogramm zum Durchführen eines Upgrades ausgeführt haben, müssen Sie Ihre ArcGIS Notebook Server-Software für 10.9 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 Ihre 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
- 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 Dienstprogramm zum Durchführen eines Upgrades ausgeführt haben, müssen Sie Ihre ArcGIS Notebook Server-Software für 10.9 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 der Notebook Server-Installationen in einer nicht verbundene 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 befindet sich das Dienstprogramm upgradesite im Verzeichnis ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.
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
Beim Upgrade von Version 10.8.1 oder früher müssen Sie nach der erfolgreichen Beendigung des Dienstprogramms eine erneute Autorisierung Ihrer ArcGIS Notebook Server-Software für 10.9 durchführen.
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 Website des Esri Customer Service unter https://service.esri.com/drm. 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 Ihre .ecp-Autorisierungsdatei per E-Mail an Sie zurück.
- Wenn Sie die .ecp-Autorisierungsdatei mit einer der beiden 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 Ihre ArcGIS Notebook Server-Site nach dem Upgrade und der Autorisierung verwendet werden kann, müssen Sie das Postinstallationsdienstprogramm ausführen, um der Site Ihre neuen Docker-Container-Images hinzuzufügen. Sie müssen auch die Instanzen von ArcGIS Web Adaptor, die bei Ihrer Site registriert sind, entsprechend der neuen Version ersetzen.
Ausführen des Postinstallationsdienstprogramms
- Ö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 nicht installiert ist, installieren Sie es jetzt.
- Installieren Sie das Docker-Image, indem Sie den entsprechenden Dateipfad angeben. Das Image sollte im .tar.gz-Format gezippt sein. Wenn Sie eine Advanced-Lizenz besitzen, 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. 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.
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 Datei tar.gz für ArcGIS Notebook Server 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
- Entfernen Sie die Registrierung der vorherigen Instanz von ArcGIS Web Adaptor in Ihrer 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 Instanz von ArcGIS Web Adaptor 10.9, und registrieren Sie sie bei ArcGIS Notebook Server.
- Nach dem Upgrade Ihrer Bereitstellung können Sie die Funktionalität von 10.9 nutzen. 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 Ihre vorhandenen benutzerdefinierten Rollen, die Notebook-Berechtigungen besitzen, indem Sie die neue Berechtigung Zeitplan für Notebooks festlegen hinzufügen, wenn dies gewünscht ist.
- Teilen Sie Ihren 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.
Ihre ArcGIS Notebook Server 10.9-Site ist jetzt bereit, als Host für ArcGIS Notebooks zu fungieren.