On-Premises Installation: Installers Post-6.10.0

If you want to update your instance to a version that is more recent than 6.10.0, you must first download and run the 6.10.0 installer.

Overview

Starting with ConceptShare 6.10.0, installers will no longer be additive/sequential in their operation. This is in contrast to the workings of previous installers (for more information, see Background). After updating to 6.10, when you apply the installer file, you will be updated directly to that version. This new approach will save time for on-premises IT teams by requiring downloads of (approximately 90%) smaller installer files, and by turning a series of sequential, gated updates, into a single update.

Background

Historically, ConceptShare’s on-premises installers (v 4.0.0–v 6.10.0) have been sequential and cumulative.

For example, suppose you are on version A and want to upgrade to version X using the old installers. You would download the version X installer, which would upgrade your installation by sequentially applying upgrades B, then C, all the way through X.

Each installer file contained the entire chronological history of updates. This approach allowed an administrator to stop the update at any intermediate version; however, it imposed a burden on administrators too, forcing them to sit through intermediary updates to get to the end-point they actually wanted. In addition, this approach made each subsequent installer file grow in size relative to its predecessor. At the time of writing, the older installer files had grown to 4 GB in size, while the newer installers are closer to 400 MB each.

Important Note to On-Premises Administrators

If you are currently running a version older than 6.10.0, you must first perform an update to 6.10.0 explicitly. That installer performs background actions and is the bridge between the old and the new installer formats. Without first upgrading to 6.10.0 explicitly, this "bridge" will not be available to later installer files, and therefore, they cannot correctly update your instance of ConceptShare.

You can download the following 6.10.0 installer:

Apply web.config Updates

Before you can apply the two web.config updates, you must first download and install version 6.10.0.

  1. Add the following to the web.config under the system.webServer node:
    <modules>
      <remove name="TelemetryCorrelationHttpModule" />
      <add name="TelemetryCorrelationHttpModule" 
    type="Microsoft.AspNet.TelemetryCorrelation.TelemetryCorrelationHttpModule, 
    Microsoft.AspNet.TelemetryCorrelation" preCondition="integratedMode,managedHandler" />
      <remove name="ApplicationInsightsWebTracking" />
      <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" 
    preCondition="managedHandler" />
    </modules>
  2. Add the following to the web.config under the runtime\assemblyBinding node:
    <dependentAssembly>
        <assemblyIdentity name="Microsoft.ApplicationInsights" publicKeyToken="31bf3856ad364e35" 
    culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-2.4.0.0" newVersion="2.4.0.0" />
    </dependentAssembly>
    <dependentAssembly>
        <assemblyIdentity name="Microsoft.Azure.KeyVault.Core" publicKeyToken="31bf3856ad364e35" 
    culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-2.0.0.0" newVersion="2.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
        <assemblyIdentity name="System.IO.Compression" publicKeyToken="b77a5c561934e089" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.1.2.0" newVersion="4.1.2.0" />
    </dependentAssembly>