Skip to main content

Upgrade einer Basisbereitstellung mit ArcGIS Enterprise Builder

ArcGIS Enterprise Builder kann das Upgrade einer Basisbereitstellung durchführen, die zuvor durch den Builder installiert wurde. Das Upgrade von Bereitstellungen, die mit einer anderen Methode eingerichtet wurden, kann mit dem Builder nicht durchgeführt werden. Dabei gelten dieselben Beschränkungen wie bei der Installation.

Zusammenfassung des Upgrades

Im Folgenden finden Sie eine Zusammenfassung der Schritte, die erforderlich sind, um ein Upgrade einer Basisbereitstellung mit ArcGIS Enterprise Builder durchzuführen:

  1. Führen Sie die erforderlichen Schritte zur Vorbereitung aus.

  2. Führen Sie ein Upgrade von ArcGIS Web Adaptor-Instanzen durch.

  3. Führen Sie das Setup-Programm von ArcGIS Enterprise Builder aus, um die ArcGIS Enterprise-Komponenten zu installieren.

  4. Verwenden Sie den Konfigurationsassistenten oder das Befehlszeilendienstprogramm upgradebasedeployment, um das Upgrade durchzuführen.

  5. Führen Sie die nach dem Upgrade erforderlichen Schritte durch.

Voraussetzungen

Lesen Sie sorgfältig die folgenden Informationen, und führen Sie alle erforderlichen Aktionen durch, bevor Sie ein Upgrade mit ArcGIS Enterprise Builder durchführen:

  • Informieren Sie sich über die Systemanforderungen für ArcGIS Enterprise Builder, um sicherzustellen, dass Ihre Hardware den aktuellen Anforderungen entspricht.

  • Bestätigen Sie, dass Ihre vorhandene Version von ArcGIS Enterprise für ein direktes Upgrade auf diese Version unterstützt wird.

    Hinweis:

    Version 10.7.1 und frühere Versionen sind in die Phase "Retired" übergegangen. Für das Upgrade dieser Versionen sind Upgrades auf zwei Zwischenversionen erforderlich. Weitere Informationen finden Sie in der Dokumentation zum Upgrade von Version 11.5.

  • Sie müssen die Software für 12.1 erneut autorisieren. In My Esri können Sie auf die neuen Autorisierungsdateien und die ArcGIS Enterprise Builder-Datei zugreifen.

  • Die Ausführen als-Konten für alle ArcGIS Enterprise-Softwarekomponenten müssen identisch sein.

Upgrade Ihrer ArcGIS Web Adaptor-Instanzen

Der ArcGIS Enterprise Builder kann kein Upgrade von ArcGIS Web Adaptor (Java Platform) durchführen, da ein zusätzlicher Schritt für die Aufhebung der Bereitstellung des Web Adaptor über den Java-Webserver erforderlich ist. Führen Sie diese Schritte durch, bevor Sie ArcGIS Enterprise Builder ausführen.

  1. Wechseln Sie als Administrator zum Installationsverzeichnis von ArcGIS Web Adaptor.

  2. Deinstallieren Sie die Instanz der ArcGIS Web Adaptor-Datei vom Computer.

    Dadurch werden die ArcGIS Web Adaptor-Instanzen vom Java-Webserver entfernt.

  3. Heben Sie die Bereitstellung beider ArcGIS Web Adaptor-Instanzen über den Anwendungsserver auf.

  4. Installieren Sie ArcGIS Web Adaptor 12.1.

  5. Stellen Sie mithilfe der Datei arcgis.war zwei ArcGIS Web Adaptor-Instanzen für den Anwendungsserver bereit, eine für ArcGIS Server und eine für Portal for ArcGIS.

Sie können jetzt mit dem Upgrade von ArcGIS Enterprise Builder fortfahren.

Ausführen des ArcGIS Enterprise Builder-Setup-Programms

ArcGIS Enterprise Builder ist darauf ausgelegt, eine vorhandene Installation von ArcGIS Enterprise Builder-Komponenten zu erkennen und zu aktualisieren. Um das Upgrade zu starten, führen Sie ./Setup in dem Verzeichnis aus, in dem ArcGIS Enterprise Builder extrahiert wurde. Befolgen Sie dann die Anweisungen, um das Upgrade der ArcGIS Enterprise Builder-Komponenten abzuschließen. Das Setup muss mit dem Benutzerkonto ausgeführt werden, unter dem die vorhandenen ArcGIS Enterprise Builder-Komponenten installiert wurden.

Die Autorisierungsdateien von ArcGIS Server können beim Ausführen des Setups mit der Methode, die unter Automatisches Installieren von ArcGIS Enterprise Builder beschrieben ist, oder im Anschluss an das Setup mit den Werkzeugen zur Softwareautorisierung im Ordner mit den ArcGIS Server-Werkzeugen übergeben werden. Die Installation erfolgt im Pfad <EnterpriseBuilderInstallPath>/arcgis/server/tools/authorizeSoftware.

Hinweis:

Der Installationspfad kann während des Upgrades nicht geändert werden.

Gehen Sie wie folgt vor, um aktualisierte Basiskomponenten von ArcGIS Enterprise mit ArcGIS Enterprise Builder zu installieren:

  1. Starten Sie das Setup-Programm über die Datei Builder.exe.

  2. Lesen und akzeptieren Sie die Lizenzvereinbarung, oder beenden Sie die Installation, wenn Sie den Bedingungen nicht zustimmen.

    Der Zielordner der zuvor installierten ArcGIS Enterprise Builder-Komponenten ist dann bereits angegeben. Diesen Zielordner können Sie während eines Upgrades nicht ändern.

  3. Klicken Sie auf Weiter, um das Setup-Programm fortzusetzen.

  4. Geben Sie das Kennwort für das angegebene Konto an.

    Unter diesem Konto wurden alle ArcGIS Enterprise-Komponenten ausgeführt. Wenn Sie nicht das richtige Kennwort verwenden, gibt das Setup-Programm eine Fehlermeldung zurück. Wenn Sie das Kennwort für das angegebene Benutzerkonto nicht kennen, wenden Sie sich an den Systemadministrator.

    Beim Upgrade einer vorhandenen Bereitstellung können Sie die Namen von ArcGIS Web Adaptor (IIS) für den Hosting-Server und das Portal nicht ändern. Das Setup-Programm konfiguriert Namen von ArcGIS Web Adaptor (IIS) basierend auf Ihrer vorherigen Konfiguration.

  5. Geben Sie im Dialogfeld "Softwareautorisierung" das Verzeichnis der Autorisierungsdateien für Portal for ArcGIS und ArcGIS Server an.

    Dies müssen die Autorisierungsdateien für die Version sein, die Sie installieren möchten.

Nachdem die Installation aktualisiert wurde, wird der Konfigurationsassistent automatisch in Ihrem Standard-Webbrowser geöffnet.

Upgrade der ArcGIS Enterprise-Bereitstellung

Im Anschluss an die Installation können Sie den Konfigurationsassistenten zum Durchführen eines Upgrades von ArcGIS Enterprise verwenden oder den Browser schließen und das Befehlszeilendienstprogramm upgradebasedeployment verwenden, um das Upgrade der Basisbereitstellung durchzuführen.

Upgrade mit dem Konfigurationsassistenten

Führen Sie die folgenden Schritte aus, um das Upgrade mithilfe des Konfigurationsassistenten durchzuführen:

  1. Navigieren Sie zur URL des Konfigurationsassistenten im Format http://mymachine.myexample.com:6080/arcgis/enterprise, sofern sie nicht bereits geöffnet ist.

    Alternativ können Sie den Computer auch nach dem ArcGIS Enterprise-Konfigurationsassistenten durchsuchen und ihn über die Verknüpfung starten.

    Achtung:

    Während des Upgrades dürfen Sie den Browser weder schließen noch aktualisieren.

  2. Lesen Sie die Informationen auf der Landing Page, auf der erläutert wird, dass der Assistent eine sichere Verbindung benötigt, und klicken Sie auf Weiter.

    Der Assistent leitet Sie an den sicheren Port 6443 weiter. Wenn Sie zum ersten Mal auf den sicheren Assistenten zugreifen, müsste in Ihrem Browser eine Sicherheitswarnung angezeigt werden. Nach der Sicherheitswarnung können Sie fortfahren. Die genaue Vorgehensweise variiert je nach Browser.

  3. Navigieren Sie im Assistenten auf der Seite License and Upgrade ArcGIS Enterprise zur .json-Datei des Portals, in der die autorisierten Benutzertypen und Apps enthalten sind.

    Diese Datei wird von My Esri abgerufen.

  4. Klicken Sie auf Aktualisieren.

    Dadurch wird der Upgrade-Prozess ausgelöst und eine Fortschrittsseite (Configuring a Deployment) geöffnet. Der Upgrade-Prozess kann einige Minuten dauern.

Wenn der Upgrade-Assistent abgeschlossen ist, wird dies auf einer letzten Seite bestätigt. Schließen Sie diese Seite, um die Schritte nach dem Upgrade auszuführen.

Upgrade mit dem Befehlszeilendienstprogramm

Nachdem Sie mit ArcGIS Enterprise Builder die Software installiert haben, können Sie mit dem Befehlszeilendienstprogramm upgradebasedeployment das Upgrade der Basisbereitstellung abschließen.

Führen Sie das Befehlszeilendienstprogramm aus, während Sie an dem Konto angemeldet sind, mit dem die Installation der Software durchgeführt wurde.

Das Befehlszeilendienstprogramm upgradebasedeployment befindet sich im Verzeichnis <ArcGIS Server installation directory>/tools/upgradebasedeployment.

Das Befehlszeilendienstprogramm müssen Sie als Windows-Administrator ausführen.

Das Befehlszeilendienstprogramm upgradebasedeployment befindet sich im Verzeichnis <ArcGIS Server installation directory>\tools\upgradebasedeployment.

Dieses Verzeichnis lautet standardmäßig C:\Program Files\ArcGIS\Server\tools\upgradebasedeployment.

Im Befehlszeilendienstprogramm werden die folgenden Parameter verwendet:

  • -lf: Gibt den Pfad zur .json-Lizenzdatei des Portals an. Wenn Sie ein Upgrade auf eine Version innerhalb derselben Versionsserie durchführen, wird diese Eigenschaft ignoriert, und Sie können bei Bedarf nach dem Upgrade eine neue Lizenzdatei importieren. Die .json-Lizenzdatei des Portals wird von My Esri abgerufen.

  • -s: Automatisches Upgrade der ArcGIS Enterprise-Basisbereitstellung ohne Eingabeaufforderung.

  • -h: Zeigt die Hilfe an und beendet das Programm.

Führen Sie folgende Schritte aus, um das Upgrade von ArcGIS Enterprise mithilfe Dienstprogramms upgradebasedeployment durchzuführen:

  1. Öffnen Sie eine Befehlszeile.

  2. Wechseln Sie an der Befehlszeile zum Arbeitsverzeichnis des Dienstprogramms upgradebasedeployment, z. B. <ArcGIS Server installation directory>/tools/upgradebasedeployment.

  3. Wechseln Sie an der Befehlszeile zum Arbeitsverzeichnis des Dienstprogramms upgradebasedeployment, z. B. <ArcGIS Server installation directory>\tools\upgradebasedeployment.

  4. Geben Sie den Befehl upgradebasedeployment mit Parameter direkt an der Eingabeaufforderung ein.

    ./upgradebasedeployment.sh -lf <path to portal json file> -s

    upgradebasedeployment.bat -lf <path to portal json file> -s

Sobald das Upgrade abgeschlossen ist, erhalten Sie Links zum Portal und zur Hosting-Server-Site.

Fahren Sie mit den Schritten fort, die nach dem Upgrade erforderlich sind.

Nach dem Upgrade erforderliche Schritte

Stellen Sie im Anschluss an das Upgrade der ArcGIS Enterprise-Bereitstellung mit ArcGIS Enterprise Builder sicher, dass die Bereitstellung funktionsfähig ist. Es gibt noch weitere optionale Schritte, die Sie möglicherweise ausführen müssen.

  1. Überprüfen Sie, ob Sie sich als Administrator über die ArcGIS Web Adaptor-URL in der Organisation anmelden können. Die URL hat das Format https://webadaptorhost.example.com/webadaptorname/home.

    Hinweis:

    Überprüfen Sie den Index anhand des ArcGIS-Administratorverzeichnisses. Falls er nicht übereinstimmt, indizieren Sie Portal for ArcGIS neu.

  2. Optional können Sie die Skripte serverScan.py und portalScan.py verwenden, um zu überprüfen, ob es nach dem Upgrade Sicherheitsempfehlungen für ArcGIS Server und das ArcGIS Enterprise-Portal gibt.