Zum Hauptinhalt springen

Neuere Versionen installieren

Wenn eine neue Version von iCL Portal veröffentlicht wird, sind in der Regel die folgenden Schritte zu unternehmen

  • Sichern Sie die SQL-Datenbanken von iCL Portal und stellen Sie sicher, dass eine Wiederherstellung tatsächlich funktioniert
  • Sichern Sie Ihre aktuelle Web.config und NLog.config des iCL Portal Web Front-end
  • Löschen Sie alle Dateien im bin-Ordner der Website außer App_Data, Web.config und NLog.config
app-pool recyceln

Falls eine Datei nicht gelöscht werden kann, weil sie von einem anderen Prozess (IIS) verwendet wird, öffnen Sie den IIS-Manager und recyceln Sie den Anwendungspool der iCL Portal-Website.

DO NOT RESTART IIS

Starten Sie IIS nicht neu, da dies alle anstehenden Anfragen unterbricht und zu Datenbeschädigung und/oder Datenverlust führen kann!

  • Entpacken Sie das Archiv iCL.Portal.xxxx.zip in den Ordner der Website.

  • Führen Sie schließlich die Datei "migrate_databases.bat" aus. Sie wird Sie fragen, ob Sie alle ausstehenden DB-Schemaänderungen auf alle Tenant-Datenbanken des iCL-Portals anwenden möchten.

  • Bestätigen Sie mit Y und drücken Sie Enter.

Datenmigrationen können dauern

Ab iCL Portal 1.60 führt migrate_databases.bat zusätzlich zu den Schema-Migrationen auch Datenmigrationen aus. Diese können bei großen Mandanten (Tenants) erhebliche Zeit in Anspruch nehmen.

Das System bleibt während der Datenmigration verwendbar

Das System ist bereits betriebsbereit und kann während der laufenden Datenmigrationen verwendet werden. Benutzer können weiterarbeiten; es ist nicht notwendig, sie bis zum Abschluss der Migrationen auszusperren.

  • Öffnen Sie die Datei web.config und ersetzen Sie das Element <runtime>...</runtime> durch das im Paket enthaltene Element (runtime.xml)

  • Befolgen Sie die zusätzlichen Anweisungen in der mitgelieferten Readme-Datei (z. B. Änderungen an der Web.config) im zugehörigen Upgrade-Handbuch.

Upgrade auf iCL Portal 1.60+​

Für 1.60+ sind zusätzliche manuelle Schritte erforderlich

1.60 bringt tiefgreifende Änderungen mit sich (neues Authentifizierungssystem, SQL 2017+, Änderungen an der web.config, WSFED-Neukonfiguration). Lesen Sie Upgrade auf iCL Portal 1.60+ und führen Sie die dort beschriebenen Schritte zusätzlich zum oben beschriebenen allgemeinen Upgrade-Ablauf aus.

Upgrade des dox42-Hosts​

Der dox42-Host wird als eigenständiger Windows-Dienst (iCLPortalDox42) ausgeliefert. Die Release-Pakete enthalten leere Werte für betreiberseitige Einstellungen — ein direktes Kopieren eines neuen Pakets über die bestehende Installation würde daher Verbindungsstrings, iKey, Tags und Log-Ordner überschreiben. Verwenden Sie stattdessen upgrade.bat.

  1. Das neue Paket nicht über die bestehende Installation entpacken.
  2. Entpacken Sie das neue Dox42Host v{version}.zip in einen frischen Ordner (z. B. C:\Installers\Dox42Host-v{version}).
  3. Führen Sie upgrade.bat als Administrator aus dem entpackten Ordner aus und übergeben Sie den Pfad der bestehenden Installation (oder geben Sie ihn bei Aufforderung ein):
    upgrade.bat "C:\Program Files\iCLPortalDox42"
  4. Das Skript wird:
    • den Dienst iCL.Portal.Reporting.Dox42$dox42_<MACHINE> anhalten,
    • das neue bin\-Verzeichnis über das alte spiegeln (entfernte DLLs werden bereinigt),
    • die bestehenden betreiberseitigen Werte (Default-Verbindungsstring, StorageConnectionString, iKey, ApplicationInsights-Tags customer/environment, NLog logDir) aus den alten Config-Dateien in die neuen übernehmen,
    • die aktualisierten Root-Skripte (install.bat, uninstall.bat, config.bat, start.bat, upgrade.bat, upgrade.ps1) kopieren,
    • anbieten, den Dienst neu zu starten.
  5. Falls die neue Version zusätzliche betreiberseitige Einstellungen einführt, führen Sie anschließend config.bat im Installationsordner aus, um diese zu prüfen.