¶ Upgrade manual JOIN Customer contact
Link to manual: https://joinsupport.decos.com/a/solutions/articles/17000103001
¶ General
On this page you will find more information about updating an existing installation of JOIN Customer Contact. Use this guide to install version 2020.1 and higher.
¶ Download
To update JOIN Customer Contact, the latest websetup.exe file must always be downloaded and unblocked. You also need the build itself which comes as a ZIP file with the same version number as the release notes.
Download the web setup (EXE file), the patch (ZIP file) and optionally the SSO_Enable (CMD file) and PreLoadEnabled_2012R2 (CMD file).
After downloading, create a new folder in Builds named the version you are going to install. Place all the files you just downloaded here.
Don’t forget to unblock the ZIP and EXE file. (Do not extract the ZIP file!):
¶ Installation of the patch
Run the Web Setup Executable (.exe) as an administrator
Click on “continue” on the start screen
If the screen below appears, the line can be left empty and you can click on “continue”
¶ Under JKC LICENSE:
In this screen you can optionally enter a license file with the corresponding activation code. This is only necessary if something has changed in the license. If not, you can skip this screen and click “continue”.
¶ Under JOIN CUSTOMER CONTACT:
Select the correct website (usually Default Web Site) and the patch ZIP file (browse for .zip file) for the local installation.
¶ Under LICENSED COMPONENTS:
In this screen you can generally leave the check marks as if nothing has been changed in the license. If it turns out that something is wrong, you can check / uncheck the component yourself. The unchecked component will not be installed as a result.
Example: Task (Decos Connect) and Task (Exchange) are not used in this case.
¶ Under CHOICE COMPONENTS:
Leave the checkmarks below if there are no changes to the license.
If something is not correct in the list, request a new .lic file from Decos and go back by clicking “Correct license”
Confirm the installation by clicking on “Install”. This will start the installation.
After the update is complete, you may see some error messages that occurred during the installation. This could be an error that a service has not been started, but it is only caused by a timeout.
If no error messages are displayed, the installation has been successfully completed.
After installation, check whether the Decos JKC Deployment Service has been restarted under Services. If the server is a bit slow, this can be true. The Deployment Service will restart all components and the Cache database will be filled.
Wait 5 minutes and then the application will be fully available again. Click on “Continue”
The update wizard is completed, click on “Exit”.
Run PreLoadEnabled_2012R2.cmd.
Finally, run SSO_Enable.cmd. Side note: Even though it can be assumed that SSO (single sign on) is on, it is still useful that this is checked. If SSO is not running on the server (this is the case on some test servers) it is very important that this last script is NOT executed! If you are unsure how, please contact System Administrator.
¶ Troubleshooting Setup
There may be an error during the installation that prevents the setup from being completed (progress freezes for 100%). The installation log file can be consulted to determine the cause. You can find this in the% TEMP% folder and search for the file Output \ Install.log.
Most likely the setup has crashed and you can find the reason for this at the bottom of the log file.
In any case: When a problem has been solved, the setup can then be carried out again without any problems. Please note that the previous setup is not still running in the background. You can check this by checking the task manager to see if Decos.JKC.Setup.exe is still running. When two setups are running simultaneously, this can cause problems.
And make sure that the websetup.exe is run as Administrator (right mouse button, “Run as administrator”) and that both the .exe and .zip file are unblocked after downloading.
.png)
.png)