Skip To Content

Upgrade einer ArcGIS Notebook Server-Site unter AWS

Sie können ein Upgrade für eine ArcGIS Notebook Server-Site unter Amazon Web Services (AWS) mit manuellen Upgrade-Verfahren durchführen. Wenn Sie die Bereitstellung mit von Esri bereitgestellten Amazon Web Services CloudFormation-Vorlagen von Version 10.8 oder 10.8.1 erstellt haben, können Sie das Upgrade auch mithilfe von Chef-Skripten durchfü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 benötigen eine neue Lizenzdatei, um ein Upgrade auf Version 10.9 durchzuführen.
  • Erstellen Sie vor dem Aktualisieren eine Sicherung der ArcGIS Notebook Server-Site.
  • 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.
  • Sie müssen 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 der 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 eine Mischung aus ArcGIS Server-Versionen 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.

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

  2. Ändern Sie die Eigenschaften für die minimale Kapazität und die maximale Kapazität der Auto Scaling-Gruppe des Stacks in "0".
  3. Entfernen Sie alle EC2-Instanzen aus der Auto Scaling-Gruppe.
  4. Ä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

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.

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

  2. Ändern Sie die Eigenschaften für die minimale Kapazität und die maximale Kapazität der Auto Scaling-Gruppe des Stacks in "0".
  3. Entfernen Sie alle EC2-Instanzen aus der Auto Scaling-Gruppe.
  4. Ä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

  1. Stellen Sie als ubuntu- Benutzer eine SSH-Verbindung mit der ersten EC2-Instanz in der ArcGIS Notebook Server-Site her.
  2. Verwenden Sie einen der folgenden Befehle, um Chef oder Cinc Client 15 herunterzuladen und zu installieren. Wenn eine ältere Version von Chef installiert ist, aktualisieren Sie sie auf Version 15.
    • Chef-Client: sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 15.14.0
    • Cinc Client: sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v 15.14.0
  3. Laden Sie die folgenden Installationsdateien für Version 10.9 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_109_177908.tar.gz
    • ArcGIS_Notebook_Server_Samples_Data_Linux_109_177914.tar.gz
    • ArcGIS_Notebook_Docker_Advanced_109_177823.tar.gz
    • ArcGIS_Notebook_Docker_Standard_109_177822.tar.gz
    • ArcGIS_Web_Adaptor_Java_Linux_109_177888.tar.gz

  4. Rufen Sie eine Autorisierungsdatei für ArcGIS Notebook Server 10.9 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.
  5. Laden Sie das ArcGIS Cookbook Version 3.7.0 (arcgis-3.7.0-cookbooks.tar.gz) auf die EC2-Instanz herunter, entpacken Sie die Datei, und legen Sie den Inhalt der Datei im Ordner /opt/chef ab.
  6. Die Datei notebook-server.json, die Sie für das Upgrade verwenden, ist in dem Cookbook enthalten, das Sie im vorherigen Schritt heruntergeladen und extrahiert haben.
  7. Wechseln Sie zum Verzeichnis /opt/chef/templates/arcgis-notebooks/10.9/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 ArcGIS Notebook Server-Site-Administrator fest:
      "arcgis" : {
          "notebook_server": {
      	       "admin_username": "<username>",
              "admin_password": "<password>",
    • Legen Sie den Speicherort für das Stammverzeichnis des Servers auf /net/primary/gisdata/notebookserver/directories fest. Sie müssen im Standardtext FILESERVER durch primary ersetzen.
      "arcgis" : {
          "notebook_server": {
          "directories_root": "/net/primary/gisdata/notebookserver/directories",
    • Legen Sie den Speicherort für das ArcGIS Notebook Server-Workspace-Verzeichnis auf /net/primary/gisdata/notebookserver/directories/arcgisworkspace fest. Sie müssen im Standardtext FILESERVER durch primary ersetzen.
      "arcgis" : {
          "notebook_server": {
          "workspace": "/net/primary/gisdata/notebookserver/directories/arcgisworkspace",
    • Legen Sie die Verbindungszeichenfolge für den Speicherort des ArcGIS Notebook Server-Konfigurationsverzeichnisses auf /net/primary/gisdata/notebookserver/config-store fest. Beachten Sie, dass Sie im Standardtext FILESERVER durch primary ersetzen müssen.
      "arcgis" : {
          "notebook_server": {
          "config_store_connection_string": "/net/primary/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",

  8. Speichern und schließen Sie die notebook-server.json-Datei.
  9. 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/10.9/linux/notebook-server.json.
  10. 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.

  1. Ö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 ArcGIS Notebook Server-Site-Administrator fest:
      "arcgis" : {
          "mission_server": {
      	       "admin_username": "<username>",
              "admin_password": "<password>",

  2. Speichern und schließen Sie die notebook-server-webadaptor.json-Datei.
  3. 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/10.9/linux/notebook-server-webadaptor.json.