########################################
Theasoft WCF - Update instructions
########################################

Last Update 2021-09-20 for version 4.214.100

If you have any issues or question please contact the Theasoft support.
FON:   +49 40 7373737
EMAIL: support@theasoft.de

########################################
Pre-Update
########################################
Beginning with 4.213.x the minimum required Microsoft .NET Framework is 4.7.2.
Before you run the update, you might have to install it first.

To check what version is installed you can run the following line in Powershell:
Get-ChildItem "hklm:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\" | Get-ItemPropertyValue -Name Release

As result you get a number. If it is equal or higher than 461808, your installed version fulfills the requirement.

########################################
Update
########################################


WARNING:
If the folder for the saved files of the AttachmentService is located below the folder of the website, it must be relocated.
Please contact Theasoft Support for this, as settings must also be adjusted.
To check open the folder of the website. It should only contain the "App_Data", "bin" and "Config" folders.

----------

The enclosed program "theasoftWcfSetup.exe" can be used for updating.
If the IIS is installed, you can directly select a website. This is automatically stopped and started again.
Alternatively, you can select a folder in which the website is located.
Before the update, the existing version can be saved in a ZIP file.

Proceed as follows:

01. Start the enclosed program "theasoftWcfSetup.exe".
    The main window opens in which you can see the version of the update.

02. Click on "Update" to open the window for the update.

03. Select the website from the IIS or the folder of the website.
    The info field shows you further details on the application found, including the version.

    The backup option is enabled by default. You can see the path and the file name under "Backup file".
    You can adjust both as required.

05. Click on "OK" to start the update.
    If your selection is invalid, you will receive a corresponding message.

########################################
Restore Backup
########################################

If you want to restore a backup, proceed as follows:

01: Go to the backup directory and unzip the ZIP file.

02: Stop the webpage.

03: Open the website folder.

04. Delete the contents of the folder.

05. Copy the contents of the ZIP data into the folder.

06. Start the website.

#######################################
Update permissions
#######################################

If you are currently using version 4.184.x or earlier (to determine the version, see section "Performing an update", point 3),
you must also run the sql script "wcf_user_permissions_for_attachments.sql" on the theasoft database.
This script grants the WCF Service user additional permissions in the database.

In the script you have to enter the name of the user who connects to the theasoft database.
If you are using integrated security, this is the user the application pool is running under.
If you are not using integrated security, you can find the name in the settings.common.config file.

The script only needs to be executed once. 

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

Please note that this file was created using an online translation service.