Zum Hauptinhalt gehen

Lizenzierungsagent aktualisieren

Marion Frei
  • Aktualisiert

Diese Anleitung beschreibt das empfohlene Vorgehen, um eine bestehende Installation des Lizenzierungsagenten zu aktualisieren.

Sie können den Lizenzierungsagenten in der Version 2.0 hier herunterladen.

Update auf Version 2.0.0 (ausgehend von jeder Version)

1. Windows-Dienst stoppen

Stoppen Sie den Windows-Dienst axes4 Licensing Agent.

2. Vorhandenen Installationsordner sichern

Erstellen Sie eine Kopie des vorhandenen Installationsordners (Standardpfad: C:\Program Files\axes4 Licensing Agent). Diese Kopie dient als Sicherung und wird in Schritt 4 benötigt.

3. Installationsprogramm ausführen

Starten Sie das Installationsprogramm, um auf Version 2.0.0 zu aktualisieren.

4. Konfigurationsdatei (appsettings.json) übertragen

Öffnen Sie die Datei appsettings.json aus dem Installationsordner (mit Administratorrechten) sowie die Kopie dieser Datei aus Schritt 2 nebeneinander. Übernehmen Sie die bestehenden Werte aus der ursprünglichen Datei in die neue appsettings.json.

Wichtig: Da sich das Schema dieser Datei zwischen Versionen ändern kann, dürfen Sie die neue Datei nicht einfach durch die alte ersetzen. Übertragen Sie stattdessen nur die relevanten Werte einzeln.

Achten Sie dabei besonders auf folgende Bereiche:

  • Node „Agent": Server-URL, Port und UUID
  • Gesamter Node „Kestrel" (enthält die Zertifikatseinstellungen)
    • Falls Sie das automatisch generierte Zertifikat agent.pfx verwenden, kopieren Sie diese Datei zusätzlich in den Installationsordner und überschreiben Sie die bestehende Datei.
  • Node „Proxy" (falls vorhanden): Übernehmen Sie diesen unverändert in die neue appsettings.json.

Beispiel:

{
  "Agent": {
    "Server": "https://[Host]:[Port]",
    "Uuid": "[Guid]"
  },
  "Kestrel": {
    ...
  }
}

5. Änderungen speichern

Speichern Sie die Änderungen in der Datei appsettings.json.

6. Dienst neu starten

Starten Sie den Windows-Dienst des Lizenzierungsagenten neu.

Nach dem Update: Aufräumen

Prüfen Sie zuerst, ob alles wie erwartet funktioniert und sich Ihre Endbenutzer erfolgreich gegen den aktualisierten Agenten aktivieren können. Erst danach:

  • Löschen Sie die in Schritt 2 erstellte Kopie des Installationsordners.
  • Falls auf dem System keine anderen Anwendungen .NET 8 benötigen, können Sie die .NET-8-Komponenten (z. B. das Hosting Bundle) deinstallieren.