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 to 5.4+ on an SQL Server Database, you will need to make a change to your connectionString in your SSO and Cinchy appsettings. Adding TrustServerCertificate=True will allow you to bypass the certificate chain during validation.

Ex: 

"SqlServer" : "Server=MyServer;Database=Cinchy;User ID=cinchy;Password=password;Trusted_Connection=False;Connection Timeout=30;Min Pool Size=10;TrustServerCertificate=True"

1.1 Prerequisites

  1. Take a backup of your database.

  2. Extract the new build for the version you wish to upgrade to.

  3. Download .NET 6.0

1.2 Upgrade Process

  1. Merge the following configs with your current instance configs:

    • Cinchy/web.config

    • Cinchy/appsettings.json

    • CinchySSO/appsettings.json

    • CinchySSO/web.config

  2. 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: 

    "SqlServer" : "Server=MyServer;Database=Cinchy;User ID=cinchy;Password=password;Trusted_Connection=False;Connection Timeout=30;Min Pool Size=10;TrustServerCertificate=True"

  3. Execute the following command:

iisreset -stop

4. Replace the Cinchy and CinchySSO folders with the new build and your merged configs.

5. Execute the following command:

iisreset -start

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.

Previousv5.4 (IIS)Nextv5.6 (IIS)

Last updated

Was this helpful?