v5.5 (IIS)
1. Upgrading on IIS
The following process can be run when upgrading any v5.x instance to v5.5 on IIS.
Warning: There is a mandatory upgrade for this release that requires you to run the Cinchy Upgrade Utility. Please review and follow the directives for Upgrade 5.5 here.
Additionally, If you are upgrading from Cinchy v5.1 or lower to Cinchy v5.5, you must first run a mandatory process (Upgrade 5.2) using the Cinchy Utility and deploy version 5.2. Once complete, you can continue on with your 5.5 upgrade.
If you are upgrading from Cinchy v5.3 or lower to Cinchy v5.5 on an SQL Server Database, you will need to make a change to your connectionString. Adding TrustServerCertificate=True will allow you to bypass the certificate chain during validation.
For a Kubernetes deployment, you can add this value in your deployment.json file:
1.1 Prerequisites
Take a backup of your database.
Extract the new build for the version you wish to upgrade to.
1.2 Upgrade Process
Merge the following configs with your current instance configs:
Cinchy/web.config
Cinchy/appsettings.json
CinchySSO/appsettings.json
CinchySSO/web.config
If you are upgrading to 5.5 on an SQL Server Database and did not do so in any previous updates, you will need to make a change to your connectionString in both your SSO and Cinchy appsettings. Adding TrustServerCertificate=True will allow you to bypass the certificate chain during validation.
Ex:
Execute the following command:
4. Replace the Cinchy and CinchySSO folders with the new build and your merged configs.
5. Execute the following command:
6. Open your Cinchy URL in your browser.
7. Ensure you can log in.
If you encounter an error during this process, restore your database backup and contact Cinchy Support.
Last updated