Update einer bestehenden Installation

Diese Seite beschreibt, wie Sie security.manager NEXT auf eine neuere Version aktualisieren. Ein Update umfasst dabei die Aktualisierung der folgenden Komponenten:

Vor dem Update

Bitte beachten Sie auch die Update-Hinweise in den Release Notes der aktuellen Version sowie aller Versionen die zwischen der aktuellen und der bislang bei Ihnen installierten Version liegen.

Vorbereitung des Updates

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

Aktualisierung der Manager UI

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:

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

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

  3. Entfernen Sie die alte Manager UI-Webanwendung unter [TOMCAT]\webapps. Sichern Sie den bestehenden Ordner zunächst in einem Backup-Verzeichnis, bevor Sie ihn endgültig löschen.

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

  5. Editieren Sie die 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.

  6. Starten Sie den Apache Tomcat-Dienst neu.

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

  1. Ermitteln Sie das aktuelle 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.

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

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

  4. Prüfen Sie die neue Version der CLI mit dem Befehl secmanctl --version. Die Version sollte 1.2.0 sein.

Aktualisierung des npm-Pakets

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

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

  2. Prüfen Sie die neue Version der CLI mit dem Befehl secmanctl --version. Die Version sollte 1.2.0 sein.

Aktualisierung der SOI

Wichtige Hinweise zum Update

  • Ein Update der SOI der Version 1.0.0 auf eine neuere Version erfordert im Gegensatz zur nachfolgenden Beschreibung die Löschung und Neuinstallation der SOI. Wenn bei Ihnen die SOI in der Version 1.0.0 installiert ist, fahren Sie bitte mit den Anweisungen des Abschnitts Aktualisierung der SOI Version 1.0.0 fort.

  • Stellen Sie sicher, dass die Aktualisierung der CLI vor der Aktualisierung der SOI vorgenommen wurde.

  • Wir empfehlen vor jedem Update der SOI-Komponente, eine Sicherung bestehender Zugriffsrechte mit Hilfe der CLI zu erstellen.

  • Nach dem Update der SOI sind alle Services, für die die SOI aktiviert war, gestoppt. Starten die daher nach dem Update der SOI die benötigten Services neu.

  • Das Löschen der SOI über den ArcGIS Server Manager führt zum Löschen bestehender Zugriffsrechte. Achten Sie beim Update daher bitte darauf, die Erweiterungen zu aktualisieren, nicht aber zu löschen. Haben Sie eine Erweiterung versehentlich gelöscht, können zuvor gesicherte Zugriffsrechte mit der CLI wiederhergestellt werden.

Durchführung des Updates

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

  1. 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. Führen Sie nun ein Update der beiden installierten SOE-Dateien über die Aktion Erweiterung bearbeiten durch.

      • Aktualisieren Sie die Erweiterung ct-security-soi-arcmap.soe mit der gleichnamigen Datei aus dem Ordner [SECMAN-DIR].

      • Aktualisieren Sie die Erweiterung ct-security-soi-arcgispro.soe mit der gleichnamigen Datei aus dem Ordner [SECMAN-DIR].

      • Überprüfen Sie, dass die Versionsnummer der aktualisierten Erweiterungen in der Spalte Anzeigename nun die Version 1.2.0 enthält.

  2. Überprüfen Sie, dass zuvor bestehende Zugriffsrechte weiterhin gesetzt sind. Dazu haben Sie folgende Möglichkeiten:

    1. Überprüfen Sie die Zugriffsrechte mithilfe der Manager UI.

    2. Oder überprüfen Sie die Zugriffsrechte mithilfe der CLI. Das sync-Kommando mit der --dry-Option sollte keine Unterschiede zwischen den gesetzten und den gesicherten Zugriffsrechten anzeigen:

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

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

Aktualisierung der SOI Version 1.0.0 auf eine neuere Version

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-arcgispro.soe

Es ist notwendig, die alten SOE-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.