How-To: Update des Serviceware Authenticator von Version 1.0 auf 1.1

Wenn Sie den Serviceware Authenticator bereits verwenden, können Sie diesen auf die aktuelle Version aktualisieren.

Sie müssen die alte Version des Serviceware Authenticator deinstallieren und dann die aktuelle Version installieren. Ihre Konfigurationsdateien können Sie sichern und wieder einspielen. Zur Deinstallation des Serviceware Authenticator steht Ihnen optional ein Script zur Verfügung. Aus diesem Grund können Sie zwischen zwei Wegen wählen, um den Serviceware Authenticator zu aktualisieren.
WARNUNG: Wenn Sie in der Vergangenheit manuelle Änderungen an der Konfiguration des Authenticator vorgenommen haben, beachten Sie auch den FAQ-Eintrag zum Thema Das Authenticator-Update schlägt fehl, weil der Realm umbenannt wurde. Welche Schritte muss ich unternehmen?

Script-unterstütztes Authenticator-Update

Wenn Sie Administratoren-Rechte besitzen, können Sie das Update mit Unterstützung eines Scripts ausführen.

Gehen Sie wie folgt vor, um den Serviceware Authenticator mit Hilfe des Scripts UninstallAuthenticator1.0.ps1 zu aktualisieren.
  1. Öffnen Sie den Dienste-Manager und stoppen Sie den Authenticator-Dienst Serviceware Authenticator.
  2. Laden Sie das Script UninstallAuthenticator1.0.ps1. Sie können den Download sofort starten oder das Script zunächst im Browser ansehen.
  3. Prüfen Sie im Script, ob die Pfade zum Serviceware Authenticator sowie zur Authenticator-Konfiguration für Ihr System zutreffen.
  4. Ändern Sie die Pfade ggf. vor Ausführung des Scripts für Ihr System in einem Texteditor und speicher das Script.
  5. Starten Sie PowerShell als Administrator.
  6. Führen Sie das Script aus.
    Der Serviceware Authenticator 1.0 wurde deinstalliert.
  7. Installieren Sie die aktuelle Version des Authenticator wie im Kapitel Installation beschrieben.
  8. Vor der Konfiguration des Serviceware Authenticator spielen Sie die Datei terraform.tfstate wieder ein über copy C:\serviceware\common\Authenticator-Backup\terraform.tfstate %SW_HOME%\Common\Authenticator\Provisioning.
  9. Stellen Sie sicher, dass der Name des Customer_Realms gleich lautet wie die internal_id für den Realm. Diesen Schritt müssen Sie nur vornehmen, wenn der Name des Realms manuell angepasst wurde. Haben Sie den Namen des Realms angepasst, folgen Sie der Anleitung im entsprechenden FAQ-Eintrag.
  10. Konfigurieren Sie den Serviceware Authenticator wie im Abschnitt Konfiguration beschrieben.
Sie verwenden den Serviceware Authenticator nun in der aktuellen Version.

Manuelles Authenticator-Update auf die Version 1.1

Es ist weiterhin möglich, das Update ohne Hilfe eines Scripts auszuführen.

Gehen Sie dazu wie folgt vor.
  1. Öffnen Sie den Dienste-Manager und stoppen Sie den Authenticator-Dienst SWAuthenticator.
  2. Öffnen Sie eine Kommandozeile und erstellen Sie ein Backup Ihrer Authenticator-Konfigurationsdateien.
    1. Erstellen Sie einen Ordner für die gesicherten Dateien, beispielsweise: md "%USERPROFILE%\Desktop\Backup".
    2. Kopieren Sie die Dateien Application.keystore über copy "C:\Serviceware\Common\Authenticator\standalone\configuration\standalone.xml" "%USERPROFILE%\Desktop\Backup".
    3. Kopieren Sie die Datei application.keystore über copy "C:\Serviceware\Common\Authenticator\standalone\configuration\application.keystore" "USERPROFILE%\Desktop\Backup".
    4. Kopieren Sie die Datei standalone.conf.bat über copy "C:\Serviceware\Common\Authenticator\bin\standalone.conf.bat" "%USERPROFILE%\Desktop\Backup".
    5. Kopieren Sie die Datei terraform.tfstate über copy "C:\Serviceware\Common\Authenticator-configuration\terraform.tfstate" "%USERPROFILE%\Desktop\Backup".
  3. Deinstallieren Sie den Serviceware Authenticator 1.0 über die Windows Systemsteuerung.
  4. Löschen Sie die Verzeichnisse Authenticator und Authenticator-configuration: über del /s /q “C:\Serviceware\Common\Authenticator” del /s /q “C:\Serviceware\Common\Authenticator-configuration”.
    Der Serviceware Authenticator 1.0 wurde deinstalliert.
  5. Installieren Sie die aktuelle Version des Authenticator wie im Kapitel Installation beschrieben.
  6. Vor der Konfiguration des Serviceware Authenticator spielen Sie die Datei terraform.tfstate wieder ein über copy %USERPROFILE%\Desktop\Backup\terraform.tfstate %SW_HOME%\Common\Authenticator\Provisioning.
  7. Stellen Sie sicher, dass der Name des Customer_Realms gleich lautet wie die internal_id für den Realm. Diesen Schritt müssen Sie nur vornehmen, wenn der Name des Realms manuell angepasst wurde. Haben Sie den Namen des Realms angepasst, folgen Sie der Anleitung im entsprechenden FAQ-Eintrag.
  8. Konfigurieren Sie den Serviceware Authenticator wie im Abschnitt Konfiguration beschrieben.
Sie verwenden denServiceware Authenticator nun in der aktuellen Version.