Zum Hauptinhalt springen
Version: 4.0 (2026 H1)

Aktualisierung primedocs-Server

hinweis

Diese Seite betrifft die OnPremises-Variante.
Bei der "Software as a Service"-Variante sind keine Serveraktualisierungen durch den Kunden notwendig.

Bevor Sie beginnen:

Voraussetzung für die Aktualisierung des primedocs-Servers ist eine vollständige primedocs Installation (durchgeführt wie hier beschrieben).

Aktualisierung​

Im Installationspaket ist ein PowerShell-Skript "Update.ps1" enthalten, welche eine bestehende Installation aktualisiert. Das Skript muss als Administrator ausgeführt werden.

Beim Aktualisieren werden die neuen Applikationsdateien über Robocopy kopiert, wobei bestehende Konfigurationen (web.config, nlog.config, primedocs.config sowie IIS-Konfigurationen) beibehalten werden.

hinweis

HINWEIS
Das Aktualisierungsskript ("Update.ps1") ist für die Aktualisierung von genau einer primedocs-Umgebung auf einem Server ausgelegt. Falls mehrere primedocs-Umgebungen gefunden werden, Wenn mehrere primedocs-Umgebungen auf demselben Server laufen sollen, dann muss das Skript mehrfach mit dem richtigen Installationspfad aufgerufen werden.

Skript ausführen​

Die Installations-Zip-Datei muss vorgängig entpackt werden.

Die Update.ps1 ist signiert und kann mit den Argumenten aufgerufen werden. Diese sind in der Datei in einem grossen Kommentar beschrieben (unter "Usages").

Standardaufruf (hierfür muss zuvor ins Installationsverzeichnis navigiert werden, z. B. mit cd "C:\temp\primedocs_Install_Package"), wenn primedocs unter c:\inetpub\wwwroot\primedocs installiert wurden ist:

.\Update.ps1

Weitere Aufrufmöglichkeiten sind in "Update.ps1" unter "Usages" beschrieben.

Update via Neuinstallation​

Um bei vollautomatischen primedocs-Deployments sicherzustellen, dass die IdentityServer-Signatur (cert.pfx) und die ASP.NET Core Data-Protection-Keys über Neuinstallationen hinweg erhalten bleiben und damit bestehende OIDC-Sessions / Tokens weiterhin akzeptiert werden, sind folgende Schritte notwendig:

  1. Vor der Neuinstallation: Sicherung der relevanten Dateien/Artifacts:

Um zu verhindern, dass die Dateien bei einer Neuinstallation überschrieben oder gelöscht werden, sollten sie ausserhalb des Installationsverzeichnisses abgelegt werden.

  • primedocs.config
  • cert.pfx (oder vorhandenes Signing-Zertifikat, wenn im Store)
  • Data-Protection Keys (key-*.xml)
  • nlog.config (falls angepasst)
  1. Neuinstallation / Installationsskript ausführen
  2. Gesicherte Dateien an ihre vorherigen Orte zurückspielen bzw. Zertifikat in Store importieren

Datenbank Migrationen​

Nach einer Aktualisierung sollte die DataSourceAdminApp aufgerufen werden um etwaige Datenbank-Migrationen auszuführen.