Skip to main content

v5.10 (IIS)

Upgrading on IIS​

The following process can be run when upgrading any v5.x instance to v5.10 on IIS.

warning

After upgrading to version 5.10 all users must log out and back in to your Cinchy environment in order for the changes to properly take effect.

warning

When upgrading Cinchy Event Listener to version 5.10.0, note that the service name has changed. Please see the Event Listener Service Change section for further instructions.

Changes to Personal Access Tokens​

There was an issue affecting Personal Access Tokens (PATs) generated in Cinchy wherein tokens created from v5.7 onwards were incompatible with subsequent versions of the platform. This issue has been resolved, however please note that:

  • Any tokens created on versions 5.7.x, 5.8.x, and 5.9.x will need to be regenerated.
  • "401 Unauthorized" errors may indicate the need to regenerate the token.
  • PATs created before 5.7.x and from 5.10 onwards are unaffected.
AppSetting changes

The upgrade of any version to Cinchy v5.10 may require changes to be made to various AppSetting files.

Prerequisites​

info

If you have made custom changes to your deployment file structure, please contact your Support team before you upgrade your environments.

  • Download the latest Cinchy Artifacts from the Cinchy Releases Table > Release Artifacts column.
  • Download .NET 6.0 if not already installed.

Depending on your current version, you may need to:

If you are upgrading from 5.0-5.3 to 5.4 on an SQL Server Database, you will need to make a change to your connectionString in your SSO and Cinchy appsettings.json. 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"
Current VersionRun the 5.2 Upgrade ScriptRun the 5.5 Upgrade ScriptConnection String Changes (SQL Server DB)
5.0YesYesYes
5.1YesYesYes
5.2XYesYes
5.3XYesYes
5.4XYesX
5.5XXX
5.6XXX
5.7XXX
5.8XXX
5.9XXX

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.10 on an SQL Server Database and didn't do so in any previous updates you will need to make a change to your connectionString in both your SSO and Cinchy appsettings.json. 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. When upgrading to 5.10, and if you didn't do so in any previous updates, you are required to make some changes to various appsettings.json files. If you made these changes on a prior upgrade please proceed to step 4. These changes are outlined in the following sections:

  4. Execute the following command:

iisreset -stop
  1. Replace the Cinchy and CinchySSO folders with the new build and your merged configs.
  2. Execute the following command:
iisreset -start
  1. Open your Cinchy URL in your browser.
  2. All users must log out and back in to your Cinchy environment in order for the changes to properly take effect.

Event Listener Service Change​

When upgrading Cinchy Event Listener to version 5.10.0, note that the service name has changed. To ensure this change is properly reflected in the Windows Service, you need to follow these steps:

  1. Open a PowerShell 5.1 terminal within the CinchyEventListener deployment directory.
  2. Run the PowerShell file remove-cinchy-event-listener-windows-service.ps1.
  3. After removing the service, run the PowerShell file create-cinchy-event-listener-windows-service.ps1 "path to CinchyEventListener".

If your Cinchy Event Listener is using a trusted connection, remember to update these details for the CinchyENV Event Listener service in the Services.msc control panel.

Support​

If you encounter an error during this process, restore your database backup and contact Cinchy Support.