# Update-Guide
# Manuelles Update von ELO Azure Administration ohne Server-Setup
Um die ELO Azure Administration manuell zu aktualisieren, muss zunächst der ELO Azure Administration-Dienst beendet werden.
Danach müssen die Dateien aus der ELO Azure Administration ZIP-Datei in das ELO Azure Administration-Installationsverzeichnis extrahiert werden. Dazu sollten die bereits vorhandenen Dateien entfernt werden, um Inkonsistenzen zu vermeiden. Lediglich die Datei appsettings.json mit den Konfigurationsdaten kann behalten werden.
Nachdem sichergestellt wurde, dass die Daten in der appsettings.json korrekt sind und z. B. auch das angegebene Zertifikat an dem entsprechenden Pfad existiert, kann der Dienst wieder neu gestartet werden. Dadurch ist das manuelle Update abgeschlossen.
Information
Es empfiehlt sich, das bestehende Installationsverzeichnis umzubenennen, und die ELO Azure Administration-Dateien in einen neuen Ordner mit dem Namen der alten Installation zu kopieren. Dadurch bleiben temporär beide Versionen erhalten, und Konfigurationsdateien wie die appsettings.json können einfach ausgetauscht werden. Dies ist insbesondere bei größeren Versionssprüngen ratsam, da sich dort ggf. der Aufbau von Konfigurationsdateien geändert hat oder neue Eigenschaften hinzugekommen sind. Dadurch können dann die alte und die neue appsettings.json einfach verglichen und entsprechend befüllt werden.
# Aktualisieren von Versionen vor 25.00.020
# Änderungen mit großen Auswirkungen
# Bestehende App-Registrierungen
Beachten Sie
App-Registrierungen in Microsoft Azure, die mit einer vorherigen Version der ELO Azure Administration erstellt wurden, werden mit dieser Version der ELO Azure Administration nicht mehr erkannt. Diese müssen ggf. manuell in Microsoft Azure entfernt und über die ELO Azure Administration wieder neu angelegt werden, damit sie über die ELO Azure Administration verwaltet werden können.
# Änderungen in 'appsettings.json'
Die neue Datei appsettings.json enthält Konfigurationsoptionen, die in der älteren Version nicht vorhanden waren. Ersetzen Sie die alte Datei appsettings.json durch die neue und übertragen dann die Werte aus der alten Datei in die neue.
# 'ConnectionString'-Änderung für SQL Server bei Verwendung selbstsignierter Zertifikate erforderlich
Wenn die ELO Azure Administration keine Verbindung zur SQL-Server-Datenbank herstellen kann, ist möglicherweise eine Aktualisierung des ConnectionString in der Datei appsettings.json erforderlich.
Wenn die Protokolldatei von ELO Azure Administration den folgenden Fehler (oder einen ähnlich formulierten) enthält, hat sich die Vertrauenswürdigkeit für das Serverzertifikat geändert:
Microsoft.Data.SqlClient.SqlException
Dieser Fehler tritt aufgrund einer Änderung des Standardverhaltens bei der Verbindung mit SQL Server auf. Das Serverzertifikat muss nun von einer vertrauenswürdigen Zertifizierungsstelle signiert sein. Selbstsignierte Zertifikate, wie sie von dem Standard-SQL-Server-Setup erstellt werden, werden nicht mehr akzeptiert.
Als Workaround können Sie TrustServerCertificate=true; zum ConnectionString in der
appsettings.json hinzufügen, um das Vertrauen in selbstsignierte Zertifikate wieder zu aktivieren.