Die Vorgehensweise beim Durchführen eines Upgrades hängt davon ab, wie und wann Sie die ArcGIS Notebook Server-Site auf Amazon Web Services (AWS) erstellt haben.
- Für eine ArcGIS Notebook Server-Site auf AWS kann ein Upgrade mithilfe eines manuellen Upgrade-Verfahrens durchgeführt werden. Wenn Sie die Site vor der Version 10.8 erstellt haben, müssen Sie das Upgrade mithilfe des manuellen Verfahrens durchführen.
- Wenn Sie die ArcGIS Notebook Server-Site mithilfe einer Esri Amazon Web Services CloudFormation-Vorlage von Version 10.8 oder 10.8.1 erstellt haben, können Sie das Upgrade mithilfe von Chef-Skripten durchführen.
- Wenn Sie die ArcGIS Notebook Server-Site unter Verwendung einer Esri CloudFormation-Vorlage der Version 10.9. 10.9.1, 11.0, 11.1 oder 11.2 erstellt haben, können Sie das Upgrade mithilfe der entsprechenden CloudFormation-Vorlage von Version 11.3 durchführen.
- Wenn Sie die ArcGIS Notebook Server-Site mit ArcGIS Enterprise Cloud Builder for Amazon Web Services von Version 10.9, 10.9.1, 11.0, 11.1 oder 11.2 erstellt haben, können Sie ArcGIS Enterprise Cloud Builder for AWS der Version 11.3 verwenden, um das Upgrade durchzuführen.
Bevor Sie die Aktualisierung ausführen
Überprüfen Sie unabhängig von der verwendeten Upgrade-Methode die folgenden Informationen, bevor Sie das Upgrade Ihrer Bereitstellung durchführen:
- Sie müssen eine neue Lizenzdatei abrufen, um das Upgrade auf 11.3 durchzuführen.
- Erstellen Sie vor dem Aktualisieren eine Sicherung der ArcGIS Notebook Server-Site.
- Für eine ArcGIS Notebook Server-Site mit einem Computer müssen Sie das Workspace-Verzeichnis der ArcGIS Notebook Server-Site verschieben.
- Sie müssen vor dem Upgrade der ArcGIS Notebook Server-Site das Upgrade des ArcGIS Enterprise-Portals, mit dem ArcGIS Notebook Server verbunden ist, durchführen.
- Wenn Sie ein Upgrade mit manuellen Upgrade-Verfahren oder einem Chef-Skript durchführen, müssen Sie die Amazon Elastic Compute Cloud (EC2)-Instanzen in der ArcGIS Notebook Server-Site gegebenenfalls aus der AWS Auto Scaling-Gruppe entfernen, bevor Sie das Upgrade für die Site durchführen können. Nach dem Upgrade können Sie die Instanzen nicht wieder der Auto Scaling-Gruppe hinzufügen. Daher müssen Sie Instanzen bei Bedarf manuell in der ArcGIS Notebook Server-Site hinzufügen oder löschen. Außerdem können Sie die mit Amazon Web Services CloudFormation-Vorlagen von Esri erstellten Lambda-Funktionen nicht zum Beenden und Starten dieser Instanzen verwenden.
Wenn Sie die Instanzen nicht entfernen oder die Instanzen nach dem Upgrade wieder der Auto Scaling-Gruppe hinzufügen, wird auf den Instanzen, die durch die Auto Scaling-Gruppe der ArcGIS Notebook Server-Site hinzugefügt werden, die alte Version der Software ausgeführt. Da es nicht möglich ist, in einer Site mehrere Versionen von ArcGIS Server zu verwenden, kann dadurch die Bereitstellung beschädigt werden.
Upgrade mit manuellen Upgrade-Verfahren
Das manuelle Upgrade-Verfahren für eine ArcGIS Notebook Server-Site unter AWS ähnelt dem Durchführen eines Upgrades für eine entsprechende lokale Site. Der Unterschied unter AWS besteht darin, dass Sie, wenn die Amazon Elastic Compute Cloud-Instanzen der ArcGIS Notebook Server-Site in einer AWS Auto Scaling-Gruppe bereitgestellt sind, die Instanzen vor dem Upgrade aus der Auto Scaling-Gruppe entfernen müssen.
Führen Sie die folgenden Schritte aus, um alle EC2-Instanzen aus der Auto Scaling-Gruppe zu entfernen.
- Melden Sie sich bei der AWS Management Console an, und suchen Sie die Auto Scaling-Gruppe, die mit Ihrer ArcGIS Notebook Server-Site verknüpft ist.
Die Auto Scaling-Gruppe enthält den Namen des CloudFormation-Stacks. Sie können auch die Instanzverwaltung für die Gruppe öffnen und sich vergewissern, dass die EC2-Instanzen in der Gruppe Teil der Site sind.
- Ändern Sie die Eigenschaften für die minimale Kapazität und die maximale Kapazität der Auto Scaling-Gruppe des Stacks in "0".
- Entfernen Sie alle EC2-Instanzen aus der Auto Scaling-Gruppe.
- Ändern Sie die Eigenschaft für die gewünschte Kapazität der Auto Scaling-Gruppe in "0".
Wenn Sie alle EC2-Instanzen entfernt haben, löschen Sie die Auto Scaling-Gruppe, um zu verhindern, dass Benutzer die Instanzen nach dem Upgrade der ArcGIS Notebook Server-Site wieder hinzufügen.
Jetzt können Sie das Upgrade der ArcGIS Notebook Server-Site gemäß den Installationsanweisungen für ArcGIS Notebook Server durchführen. Lesen Sie die Anweisungen für das Betriebssystem Ihrer EC2-Instanzen:
Upgrade mit Chef-Skripten
Wenn Sie die ArcGIS Notebook Server-Site mithilfe einer Esri Amazon Web Services CloudFormation-Vorlage von Version 10.8 oder 10.8.1 erstellt haben, können Sie das Upgrade mithilfe von Chef-Skripten durchführen.
Entfernen Sie die ArcGIS Notebook Server EC2-Instanzen aus der AWS Auto Scaling-Gruppe. Führen Sie als Nächstes das Upgrade der ArcGIS Notebook Server-Site und dann das Upgrade des ArcGIS Web Adaptor der Site durch.
Anpassen der Einstellungen für Auto Scaling-Gruppen
Führen Sie die folgenden Schritte aus, um alle EC2-Instanzen aus der Auto Scaling-Gruppe zu entfernen.
- Melden Sie sich bei der AWS Management Console an, und suchen Sie die Auto Scaling-Gruppe, die mit Ihrer ArcGIS Notebook Server-Site verknüpft ist.
Die Auto Scaling-Gruppe enthält den Namen des CloudFormation-Stacks. Sie können auch die Instanzverwaltung für die Gruppe öffnen und sich vergewissern, dass die EC2-Instanzen in der Gruppe Teil der Site sind.
- Ändern Sie die Eigenschaften für die minimale Kapazität und die maximale Kapazität der Auto Scaling-Gruppe des Stacks in "0".
- Entfernen Sie alle EC2-Instanzen aus der Auto Scaling-Gruppe.
- Ändern Sie die Eigenschaft für die gewünschte Kapazität der Auto Scaling-Gruppe in "0".
Wenn Sie alle EC2-Instanzen entfernt haben, löschen Sie die Auto Scaling-Gruppe, um zu verhindern, dass Benutzer die Instanzen nach dem Upgrade der ArcGIS Notebook Server-Site wieder hinzufügen.
Upgrade von ArcGIS Notebook Server
- Stellen Sie als ubuntu- Benutzer eine SSH-Verbindung mit der ersten EC2-Instanz in der ArcGIS Notebook Server-Site her.
- Verwenden Sie einen der folgenden Befehle, um einen unterstützten Chef- oder Cinc-Client herunterzuladen und zu installieren.
Informationen zu unterstützten Versionen finden Sie in der ArcGIS Cookbook-Kompatibilitätsmatrix. Ersetzen Sie den Text der Versionsnummer in den folgenden Anweisungen durch die von Ihnen installierte Client-Version, z. B. 18.30.
- Chef-Client: sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v <version_number>
- Cinc-Client: sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v <version_number>
- Laden Sie die folgenden Installationsdateien für Version 11.3 aus Ihrem Konto in My Esri herunter, und laden Sie die Dateien in das Verzeichnis /opt/software/archives auf der EC2-Instanz hoch.
- ArcGIS_Notebook_Server_Linux_113_190340.tar.gz
- ArcGIS_Notebook_Server_Samples_Data_Linux_113_190346.tar.gz
- ArcGIS_Notebook_Docker_Advanced_113_190270.tar.gz
- ArcGIS_Notebook_Docker_Standard_113_190269.tar.gz
- ArcGIS_Web_Adaptor_Java_Linux_113_190319.tar.gz
- Rufen Sie eine Autorisierungsdatei für ArcGIS Notebook Server 11.3 ab, und legen Sie sie in einem lokalen Ordner auf der EC2-Instanz oder in einer Dateifreigabe ab, auf die Sie über die EC2-Instanz zugreifen können.
- Laden Sie das ArcGIS Cookbook Version 5.0.0 (arcgis-5.0.0-cookbooks.tar.gz) auf die EC2-Instanz herunter, entpacken Sie die Datei, und legen Sie den Inhalt der Datei im Verzeichnis /opt/chef ab.
- Wechseln Sie zum Verzeichnis /opt/chef/templates/arcgis-notebooks/11.3/linux, öffnen Sie die Datei notebook-server.json in einem Text-Editor, und ändern Sie die folgenden Parameter:
- Legen Sie das Installationsverzeichnis auf /home fest.
"arcgis" : { "notebook_server": { "install_dir": "/home" - Geben Sie den Speicherort an, in dem Sie die Autorisierungsdatei für ArcGIS Notebook Server abgelegt haben.
"arcgis" : { "notebook_server": { "authorization_file": "/<folder>/<subfolder>", - Legen Sie den Benutzernamen und das Kennwort für den Administrator der ArcGIS Notebook Server-Site fest.
"arcgis" : { "notebook_server": { "admin_username": "<username>", "admin_password": "<password>", - Legen Sie den Speicherort für das Stammverzeichnis des Servers auf /net/FILESERVER/gisdata/notebookserver/directories fest. Sie müssen im Standardtext FILESERVER durch die IP-Adresse des Dateiserverknotens ersetzen.
"arcgis" : { "notebook_server": { "directories_root": "/net/FILESERVER/gisdata/notebookserver/directories", - Legen Sie den Speicherort für das ArcGIS Notebook Server-Workspace-Verzeichnis auf /net/FILESERVER/gisdata/notebookserver/directories/arcgisworkspace fest. Sie müssen im Standardtext FILESERVER durch die IP-Adresse des Dateiserverknotens ersetzen.
"arcgis" : { "notebook_server": { "workspace": "/net/FILESERVER/gisdata/notebookserver/directories/arcgisworkspace", - Legen Sie die Verbindungszeichenfolge für den Speicherort des ArcGIS Notebook Server-Konfigurationsverzeichnisses auf /net/FILESERVER/gisdata/notebookserver/config-store fest. Sie müssen im Standardtext FILESERVER durch die IP-Adresse des Dateiserverknotens ersetzen.
"arcgis" : { "notebook_server": { "config_store_connection_string": "/net/FILESERVER/gisdata/notebookserver/config-store", - Legen Sie das Protokollverzeichnis auf /home/arcgis/notebookserver/usr/logs fest.
"arcgis" : { "notebook_server": { "log_dir": "/home/arcgis/notebookserver/usr/logs",
- Legen Sie das Installationsverzeichnis auf /home fest.
- Speichern und schließen Sie die notebook-server.json-Datei.
- Wechseln Sie als ubuntu-Benutzer zum Verzeichnis /opt/chef, und führen Sie den folgenden Befehl aus: sudo chef-client -z -j /opt/chef/templates/arcgis-notebooks/11.3/linux/notebook-server.json.
- Wenn sich mehrere EC2-Instanzen in der ArcGIS Notebook Server-Site befinden, stellen Sie eine SSH-Verbindung mit der nächsten EC2-Instanz her, und wiederholen Sie die Schritte 2 bis 8, bis das Upgrade für alle Instanzen durchgeführt wurde.
Wenn das Upgrade von ArcGIS Notebook Server auf allen EC2-Instanzen in der Site abgeschlossen ist, führen Sie das Upgrade für den ArcGIS Web Adaptor durch.
Upgrade von ArcGIS Web Adaptor
Verwenden Sie die Datei notebook-server-webadaptor.json, die auch in dem Cookbook enthalten ist, das Sie in Schritt 5 im vorherigen Abschnitt heruntergeladen haben, zum Durchführen des Upgrades des ArcGIS Web Adaptor der ArcGIS Notebook Server-Site.
- Öffnen Sie die notebook-server-webadaptor.json-Datei in einem Texteditor, und legen Sie die folgenden Parameter fest:
- Legen Sie den Speicherort der PKSC12-Keystore-Datei (.pfx) mit einem SSL-Zertifikat für Apache Tomcat fest.
"arcgis" : { "tomcat": { "keystore_file": "/<folder>/<subfolder>/<file name>.pfx", - Legen Sie das Kennwort für die Keystore-Datei mit einem SSL-Zertifikat für Tomcat fest.
"arcgis" : { "tomcat": { "keystore_password": "<password>" - Legen Sie den Benutzernamen und das Kennwort für den Administrator der ArcGIS Notebook Server-Site fest.
"arcgis" : { "mission_server": { "admin_username": "<username>", "admin_password": "<password>",
- Legen Sie den Speicherort der PKSC12-Keystore-Datei (.pfx) mit einem SSL-Zertifikat für Apache Tomcat fest.
- Speichern und schließen Sie die notebook-server-webadaptor.json-Datei.
- Wechseln Sie als ubuntu-Benutzer zum Verzeichnis /opt/chef, und führen Sie den folgenden Befehl aus: chef-client -z -j /opt/chef/templates/arcgis-notebooks/11.3/linux/notebook-server-webadaptor.json.
Durchführen eines Upgrades mithilfe einer CloudFormation-Vorlage
Wenn Sie eine von Esri bereitgestellte CloudFormation-Bereitstellungsvorlage von Version 10.9, 10.9.1, 11.0, 11.1 oder 11.2 zum Erstellen einer ArcGIS Notebook Server-Site verwendet haben, können Sie die entsprechende Upgradevorlage von Version 11.3 für das Upgrade verwenden.
In der folgenden Tabelle sind entsprechende Bereitstellungs- und Upgradevorlagen sowie Links zu Anweisungen für die Verwendung der Upgradevorlagen aufgeführt.
| Bereitstellungsvorlage von Version 10.9, 10.9.1, 11.0, 11.1 oder 11.2 | Upgradevorlage von Version 11.3 | Anweisungen zum Verwenden der Upgradevorlage |
|---|---|---|
arcgis-notebook-server-singlemachine.template.json | arcgis-notebook-server-singlemachine-upgrade.template.json | Verwenden von CloudFormation für ein Upgrade einer ArcGIS Notebook Server-Site mit einem Computer |
arcgis-notebook-server-ha.template.json | arcgis-notebook-server-ha-upgrade.template.json |