########################################
Theasoft WCF - Update Anleitung
########################################

Stand 20.09.2021 für Version 4.214.100

Falls Sie Probleme oder Fragen haben kontaktieren Sie bitte den Theasoft Support.
FON:   +49 40 7373737
EMAIL: support@theasoft.de

########################################
Vor dem Update
########################################
Ab 4.213.x wird Microsoft .NET Framework 4.7.2 oder höher benötigt.
Dies muss eventuell vor dem Update installiert werden.

Zum Prüfen der installierten .NET Framework Version führen Sie folgende Zeile in der Powershell aus:
Get-ChildItem "hklm:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\" | Get-ItemPropertyValue -Name Release

Als Ergebnis wird eine Zahl ausgegeben. Wenn diese gleich oder höher als 461808 ist, dann ist bereits eine ausreichende Version installiert.

########################################
Update  durchführen
########################################

ACHTUNG:
Sollte sich der Ordner für die gespeicherten Dateien des AttachmentService unterhalb des Ordners der Webseite befinden, so muss dieser verlegt werden.
Kontaktieren Sie dafür bitte den Theasoft Support, da auch Einstellungen angepasst werden müssen.
Zur Überprüfung Öffnen Sie den Ordner der Webseite. Es sollten sich nur die Ordner "App_Data", "bin" und "Config" darin befinden.

----------

Das beiligende Programm "theasoftWcfSetup.exe" kann zum Aktualisieren verwendet werden.
Wenn der IIS installiert ist, können Sie direkt eine Webseite auswählen. Diese wird automatisch angehalten und auch wieder gestartet.
Alternativ können Sie einen Ordner auswählen, in dem sich die Webseite befindet.
Vor dem Update kann die bestehende Version in eine ZIP-Datei gesichert werden.

Gehen Sie wie folgt vor:

01. Starten Sie das beiligende Programm "theasoftWcfSetup.exe".
    Das Hauptfenster öffnet sich, in dem Sie die Version des Updates sehen können.

02. Klicken Sie auf "Aktualisieren" um das Fenster für das Update zu öffnen.

03. Wählen Sie die Webseite aus dem IIS aus bzw. den Ordner der Webseite.
    Das Info Feld zeigt Ihnen zur gefundenen Anwendung weitere Details an, unter anderem die Version.

    Die Option für das Backup ist standardmäßig aktiviert. Den Pfad und den Dateinamen sehen Sie unter "Backupdatei".
    Beides können Sie nach Bedarf anpassen.

05. Klicken Sie auf "OK" um das Update zu starten.
    Sollte Ihre Auswahl ungültig sein, bekommen Sie entsprechende Meldungen.

########################################
Backup wiederherstellen
########################################

Sollten Sie ein Backup wiederherstellen wollen, gehen Sie wie folgt vor:

01: Gehen Sie in das Backupverzeichnis und entpacken Sie die ZIP Datei.

02: Halten Sie die Webseite an.

03: Öffnen Sie den Ordner der Webseite.

04. Löschen Sie den Inhalt des Ordners.

05. Kopieren Sie den Inhalt der ZIP Datet in den Ordner.

06. Starten Sie die Webseite.

########################################
Berechtigungen aktualisieren
########################################

Sollten Sie derzeit die Version 4.184.x oder früher einsetzen (zum Ermitteln der Version siehe Abschnitt "Update durchführen", Punkt 3),
so müssen Sie zusätzlich das Sql-Skript "wcf_user_permissions_for_attachments.sql" auf der theasoft Datenbank ausführen.
Dieses Skript erteilt dem WCF Service Benutzer zusätzliche Berechtigungen in der Datenbank.

Sie müssen im Skript den Namen des Benutzers angeben, der sich mit der theasoft Datenbank verbindet.
Wenn Sie integrierte Sicherheit verwenden, ist das der Benutzer, unter dem der Anwendungspool läuft.
Wenn Sie keine integrierte Sicherheit verwenden, finden Sie den Namen in der Datei "settings.common.config".

Das Skript muss nur einmalig ausgeführt werden.

########################################
