primedocs-Serverwartung
Diese Seite enthält Informationen rund um die Wartung der primedocs-Serverapplikationen und -datenbanken.
Diese Seite betrifft die OnPremises-Variante.
Bei der "Software as a Service"-Variante sind keine Wartungen durch den Kunden notwendig.
Allgemeines
primedocs baut auf Standardwerkzeugen und -technologien von Microsoft auf. Daher die Hinweise für den Betrieb der Internet Information Services und des SQL Servers beachten.
Servermigration
Im Fall einer Servermigration sollten alle Schritte der Serverinstallation auch auf der neuen Umgebung ausgeführt werden. Nach erfolgreicher Installation müssen die folgenden Artefakte der bestehenden Installation auf den neuen Server übernommen werden:
primedocs.configcert.pfx(bzw. das Signing-Zertifikat, falls im Zertifikat-Store — siehe Signierungs-Zertifikat)- Data-Protection-Keys (
key-*.xml) nlog.config(falls angepasst)
Ohne das bisherige Signing-Zertifikat und die Data-Protection-Keys werden bestehende Tokens und Sessions ungültig — alle Benutzer müssen sich neu anmelden.
Das Kopieren der key-*.xml-Dateien funktioniert nur, wenn die Data-Protection-Keys unverschlüsselt im Dateisystem abgelegt sind.
SQL-Datenbank-Migration
Wird die SQL-Datenbank über das SQL-Tooling von einem Server auf den anderen migriert, sollte dies nach Möglichkeit über ein "Full Database Backup" mit anschliessendem "Restore" erfolgen.
Ursache
Bei der Synchronisation zwischen Client und Server wird die "RowVersion" als Änderungsmerkmal genutzt. Nur bei einem "Backup" und "Restore" bleibt die "RowVersion" gleich.
Wenn kein "Backup" und "Restore" möglich ist und die Migration nur über "SQL Statements" erfolgen kann, müssen alle bestehenden Caches gelöscht werden oder die id der datasource in der primedocs.config muss geändert werden. Damit müssen die Clients sich komplett neu synchronisieren.