Update einer bestehenden Installation

Diese Seite beschreibt, wie Sie security.manager NEXT 1.0.0 auf 1.1.0 aktualisieren.

Beachten Sie die Update-Hinweise in den Release Notes der aktuellen Version.

Das Update betrifft alle Komponenten des security.manager NEXT:

Die Aktualisierung der SOI erfordert das Sichern und Wiederherstellen bestehender Zugriffsrechte. Dies kann über die CLI durchgeführt werden. Stellen Sie daher sicher, dass Sie die Aktualisierung der CLI vor der SOI vornehmen. Die Sicherung und Wiederherstellung von Zugriffsrechten ist nachfolgend beschrieben.

Vorbereitung des Updates

Bevor Sie mit der Aktualisierung starten, entpacken Sie die Installationsdatei security.manager-NEXT-1.1.0.zip in einen beliebigen Ordner. Darin wird der Ordner security.manager-NEXT-1.1.0 erstellt, der im Folgenden als [SECMAN-DIR] bezeichnet wird.

Aktualisierung der Manager UI

Hinweis: Um die Versionsnummer der Manager UI vor oder nach einem Update zu prüfen, rufen Sie https://<tomcat-host>/secman-next/info.txt im Browser auf.

Gehen Sie wie folgt vor, um die Manager UI zu aktualisieren:

  • Ermitteln Sie das konfigurierte Datenverzeichnis (Parameter data.directory.location) innerhalb der Datei [TOMCAT]\webapps\secman-next\WEB-INF\classes\custom-application.properties. Das Verzeichnis enthält die angepasste Konfiguration der installierten Version des security.manager NEXT. Diesen Wert benötigen Sie, um die aktuelle Konfiguration wiederherstellen zu können.

  • Stoppen Sie den Apache Tomcat-Dienst, auf dem die Manager UI installiert ist.

  • Entfernen Sie die alte Manager UI-Webanwendung unter [TOMCAT]\webapps. Es wird empfohlen, den bestehenden Ordner zunächst in einem Backup-Verzeichnis zu sichern, bevor dieser endgültig gelöscht wird.

  • Entpacken Sie die Datei [SECMAN-DIR]\secman-next.war aus der Auslieferung in den Ordner [TOMCAT]\webapps.

  • Editieren Sie Datei [TOMCAT]\webapps\secman-next\WEB-INF\classes\custom-application.properties und passen Sie den Parameter data.directory.location auf den zuvor ermittelten Wert an.

  • Starten Sie den Apache Tomcat-Dienst neu.

  • Prüfen Sie die Version der Manager UI wie oben beschrieben.

Aktualisierung der CLI

Die Anwendung secmanctl wird als ausführbare Datei für Windows- und Linux-Betriebssysteme (x86-64 Architektur) ausgeliefert. Alternativ kann die Anwendung als Paket über die öffentlichen npm-Registry installiert werden. Je nachdem wie secmanctl zuvor installiert worden ist, bestehen zwei Möglichkeiten die CLI zu aktualisieren:

  • Wenn die ausführbare Datei installiert wurde, erfolgt die Aktualisierung im entsprechenden Installationsverzeichnis.

  • Wenn die Anwendung als npm-Paket installiert worden ist, erfolgt die Aktualisierung über die npm-Registry.

Aktualisierung der ausführbaren Datei

In der Auslieferung finden Sie die Anwendung secmanctl im Verzeichnis:

  • [SECMAN-DIR]/cli/linux_x64 für Linux.

  • [SECMAN-DIR]\cli\windows_x64 für Windows.

Für die Aktualisierung im bestehenden Installationsverzeichnis führen Sie folgende Schritte aus:

  • Ermitteln Sie den aktuellen Installationsverzeichnis der Anwendung.

    • Unter Linux führen Sie dafür den Befehl which secmanctl aus.

    • Unter Windows führen Sie dafür den Befehl where secmanctl aus.

  • Löschen Sie alle Dateien der vorherigen Installation aus dem aktuellen Installationsverzeichnis.

  • Kopieren Sie alle Dateien aus der Auslieferung in das Installationsverzeichnis.

  • Prüfen Sie die neue Version der CLI mit dem Befehl secmanctl --version. Die Version sollte 1.1.0 oder höher sein.

Aktualisierung des npm-Pakets

Gehen Sie wie folgt vor, um eine Aktualisierung des npm-Pakets durchzuführen:

  • Führen Sie den Befehl npm update aus: npm update -g @conterra/secmanctl.

  • Prüfen Sie die neue Version der CLI mit dem Befehl secmanctl --version. Die Version sollte 1.1.0 oder höher sein.

Aktualisierung der SOI

Mit dem Release des security.manager NEXT 1.1.0 wurden die SOE-Dateien umbenannt:

  • ct-security-soi-1.0.0-arcmap.soe wurde umbenannt nach ct-security-soi-arcmap.soe

  • ct-security-soi-1.0.0-arcgispro.soe wurde umbenannt nach ct-security-soi-arcmap.soe

Es ist notwendig, die alten SOI-Dateien über den ArcGIS Server Manager zu entfernen und anschließend die neuen SOE-Dateien hinzuzufügen.

Beim Löschen der SOE-Dateien gehen bestehende Zugriffsrechte verloren! Im Rahmen des Updates werden die Zugriffsrechte über das CLI-Kommando sync zunächst gesichert und anschließend wiederhergestellt. Verwenden Sie für die Sicherung kein bestehendes Zugriffsrechtverzeichnis.

Stellen Sie sicher, dass die Aktualisierung der CLI vor der Aktualisierung der SOI durchgeführt wurde.

Gehen Sie wie folgt vor, um die SOI zu aktualisieren:

  1. Sichern Sie bestehende Zugriffsrechte:

    1. Für die Sicherung, verwenden Sie ein lokales Verzeichnis, beispielsweise backup_policies. Erstellen Sie den Unterordner backup_policies/services.

    2. Nutzen Sie das CLI-Kommando sync mit der --reverse Option:

      $ secmanctl sync --reverse -f ./backup_policies -d https://gis.example.com:6443/arcgis -t MghzyNeWubQtT..

    3. Prüfen Sie die Ausgabe nach Fehlern und den Inhalt des Backup-Verzeichnisses auf Vollständigkeit.

  2. Aktualisieren Sie die SOI über den ArcGIS Server Manager:

    1. Melden Sie sich beim ArcGIS Server Manager an und navigieren Sie zum Abschnitt Site und dort in den Bereich Erweiterungen.

    2. Löschen Sie die beiden installierten SOE-Dateien (löscht alle Zugriffsrechte!):

      • ct-security-soi-1.0.0-arcmap.soe

      • ct-security-soi-1.0.0-arcgispro.soe

    3. Klicken Sie auf Erweiterung hinzufügen, um beide SOE-Dateien aus dem [SECMAN-DIR] hochzuladen.

  3. Stellen Sie die gesicherten Zugriffsrechte per CLI wieder her:

    1. Führen Sie das sync-Kommando (nun ohne die --reverse-Option) aus, um die gesicherten Zugriffsrechte wiederherzustellen:

      $ secmanctl sync -f ./backup_policies -d https://gis.example.com:6443/arcgis -t MghzyNeWubQtT..

      Überprüfen Sie die Ausgabe nach Fehlern. Wenn alle Zugriffsrechte angewendet wurden, können Sie das Sicherungsverzeichnis löschen.

Geschafft! Sie haben die Aktualisierung erfolgreich abgeschlossen. Sie können nun die neuen Features des security.manager NEXT kennenlernen.