Upgrade von ArcGIS Notebook Server unter Windows Server 2019 (Linux-Container)

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.
• Durchführen eines Upgrades von Docker Desktop for Windows auf Version 4.24.2
• Um das Upgrade Ihrer ArcGIS Enterprise-Bereitstellung durchzuführen, gehen Sie wie folgt vor:
  1. Führen Sie ein Upgrade von Portal for ArcGIS durch.
  2. Führen Sie ein Upgrade von ArcGIS Web Adaptor (für das Portal) durch.
  3. Führen Sie ein Upgrade der ArcGIS Server-Site durch, die als Hosting-Server des Portals dient.
  4. Führen Sie ein Upgrade von ArcGIS Web Adaptor (für Server) durch.
  5. Führen Sie ein Upgrade von ArcGIS Data Store (zuerst primär und danach Standby) durch.
  6. Führen Sie ein Upgrade jedes anderen Servers durch, einschließlich ArcGIS Notebook Server.
  7. 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.
• Das Windows-Dienstkonto für Ihre ArcGIS Notebook Server-Site (ihr ausführendes Konto) muss beim Upgrade unverändert erhalten bleiben.

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:

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

2. Navigieren Sie zu site > Export Site.
3. 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.

4. Klicken Sie auf Exportieren.

   Wenn der Exportvorgang abgeschlossen ist, fügt das Verzeichnis einen Link zum Speicherort der Sicherungsdatei auf dem Server hinzu.

5. 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:

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

2. 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.
3. 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.
4. 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:

1. Führen Sie den ArcGIS Notebook Server-Befehl "setup" mit dem im nachstehenden Beispiel angegebenen Argument aus. Achten Sie darauf, dass Sie das ArcGIS Notebook Server-Konto verwenden, das auch für die vorhandene Installation verwendet wird.

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

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. Verwenden Sie das Dienstprogramm upgradesite, und führen Sie das Upgrade durch, indem Sie den folgenden Befehl ausführen. Standardmäßig ist das Dienstprogramm upgradesite unter C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat verfügbar.

   upgradesite.bat -s

   Das Dienstprogramm zeigt Fortschrittsberichte an und wird beendet, wenn das Upgrade abgeschlossen ist. 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.

3. Bei einer Site mit mehreren Computern wiederholen Sie für die einzelnen Computer die Schritte 1 und 2 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 SoftwareAuthorization.exe mit der folgenden Syntax aus, um ArcGIS Notebook Server automatisch zu autorisieren. Vor der Ausführung der Datei müssen alle Benutzerinformationen in der Autorisierungs- oder Provisioning-Datei vollständig sein.

Wenn Sie eine Autorisierungsdatei besitzen und Ihr Computer mit dem Internet verbunden ist, dann führen Sie Folgendes aus:

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

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.

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

   <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. 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 [e-mail]. Esri sendet die .ecp-Autorisierungsdatei per E-Mail an Sie zurück.
3. 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:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /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:‎

1. Öffnen Sie das Eingabeaufforderungsfenster als Administrator.
2. Wechseln Sie zum Ordner "Tools" von ArcGIS Notebook Server. Standardmäßig lautet der Pfad C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.
3. Rufen Sie optional die Hilfe des Dienstprogramms mit folgendem Befehl auf: PostInstallUtility.bat -h
4. Für ArcGIS Notebook Server ist es erforderlich, dass Docker Engine Community Edition auf Ihrem Computer installiert ist. Überprüfen Sie, ob Docker auf Ihrem Computer aktiv ist, indem Sie folgenden Befehl ausführen: PostInstallUtility.bat -d
5. Wenn Docker Desktop nicht installiert ist, installieren Sie es jetzt.

   ArcGIS Notebook Server verwendet Linux-Container in Docker Desktop. Stellen Sie bei der Installation von Docker Desktop sicher, dass Linux-Container angegeben sind, und klicken Sie nicht auf die Option Switch to Windows containers.

6. Wenn Sie Docker Desktop verwenden, müssen Sie alle folgenden Einstellungen ändern:
   1. Klicken Sie in der Taskleiste mit der rechten Maustaste auf die Schaltfläche Docker, und klicken Sie auf Settings. Aktivieren Sie unter General die Option Expose daemon on tcp://localhost:2375 without TLS.

      Sie verwenden die Docker-Remote-API, die die Verwendung von Port 2375 erfordert.

   2. Klicken Sie in der Taskleiste mit der rechten Maustaste auf die Schaltfläche Docker, und klicken Sie auf Settings. Klicken Sie im Menü "Einstellungen" auf Ressourcen > Dateifreigabe, und fügen Sie das Laufwerkverzeichnis hinzu, das für Ihren ArcGIS Notebook Server-Konfigurationsspeicher verwendet werden soll.

      Hinweis:

      Docker für Windows unterstützt nur lokale Verzeichnisse unter Windows, die für Linux-Container freigegeben werden.

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

Gehen Sie zum Installieren und Konfigurieren der Beispieldaten wie folgt vor:

1. Führen Sie den Installationsassistenten für ArcGIS Notebook Server-Beispieldaten aus, den Sie von My Esri heruntergeladen haben.

   Die Beispieldaten werden im Installationsverzeichnis von ArcGIS Notebook Server installiert.

2. Öffnen Sie das Eingabeaufforderungsfenster als Administrator.
3. Wechseln Sie zum Ordner "Tools" von ArcGIS Notebook Server.

   Standardmäßig lautet dieser Pfad C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.

4. Rufen Sie optional die Hilfe des Dienstprogramms durch folgenden Befehl auf:

    > PostInstallUtility.bat -h

5. Führen Sie das Dienstprogramm für die Postinstallation aus, um die Beispieldaten in das Verzeichnis "arcgisworkspace" der Notebook Server-Site zu extrahieren:

    PostInstallUtility.bat -x

Ersetzen von ArcGIS Web Adaptor-Instanzen

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

1. Entfernen Sie die Registrierung der vorherigen Instanz von ArcGIS Web Adaptor in der Site, und deinstallieren Sie die Instanz.
   1. Melden Sie sich bei Ihrem ArcGIS Notebook Server-Administratorverzeichnis an.
   2. Navigieren Sie zu System > Web Adaptors > registered machine.
   3. Klicken Sie auf Unregister Web Adaptor.
2. Installieren Sie eine neue ArcGIS Web Adaptor-11.3-Instanz, und konfigurieren Sie sie mit ArcGIS Notebook Server.
Nach dem Upgrade der Bereitstellung können Sie die Funktionalität von Version 11.3 verwenden.
3. 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:
   1. Aktualisieren Sie bei Bedarf vorhandene benutzerdefinierte Rollen, die Notebook-Berechtigungen besitzen, indem Sie die neue Berechtigung Zeitplan für Notebooks festlegen hinzufügen.
   2. 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.