Sitecore XP 8.2 support for MongoDB 4.4


Description

Life support reaches the end in April 2021 for MongoDB 3.6, and in April 2022 for MongoDB 4.0 (as stated here). To provide continuing support for our customers, Sitecore XP 8.2.5 and Sitecore XP 8.2.7 have been tested and certified to work with MongoDB 4.4.

Prerequisites

  1. Download the MongoDb_4_4_Sitecore.zip file.
  2. Unzip the files to a local folder.

Updating Instructions For XP 8.2.5 and 8.2.7

The following instructions are only valid for Sitecore XP 8.2.5 and 8.2.7. Customers running any previous versions must update the instance to Sitecore XP 8.2.5 or Sitecore XP 8.2.7.

To update on Mongo:

  1. Navigate to the wwwroot\<instance>\Website\Bin catalog.
  2. Replace next Mongo dlls with the same ones from the unzipped folders:
    • From MongoDb_Libs folder:
      • MongoDB.Bson.dll(*.xml)
      • MongoDB.Driver.Core.dll(*.xml)
      • MongoDB.Driver.dll(*.xml)
      • MongoDB.Driver.Legacy.dll(*.xml)
    • From AdditionalLibraries:
      • System.Runtime.InteropServices.RuntimeInformation.dll by same with version 4.0.1.0
  3. Add dlls from AdditionalLibraries to wwwroot\<instance>\Website\Bin:
    • DnsClient, Version=1.3.1.1
    • System.Buffers, Version=4.4.0.0
  4. Add the following lines to the assemblyBinding section of the web.config file:
    <dependentAssembly>
        <assemblyIdentity name="MongoDB.Bson"/>
        <bindingRedirect newVersion="2.8.0.0" oldVersion="0.0.0.0-2.4.4.0"/>
    </dependentAssembly>
    <dependentAssembly>
        <assemblyIdentity name="MongoDB.Driver"/>
        <bindingRedirect newVersion="2.8.0.0" oldVersion="0.0.0.0-2.4.4.0"/>
    </dependentAssembly>
    <dependentAssembly>
        <assemblyIdentity name="MongoDB.Driver.Core"/>
        <bindingRedirect newVersion="2.8.0.0" oldVersion="0.0.0.0-2.4.4.0"/>
    </dependentAssembly>
    <dependentAssembly>
        <assemblyIdentity name="MongoDB.Driver.Legacy"/>
        <bindingRedirect newVersion="2.8.0.0" oldVersion="0.0.0.0-2.4.4.0"/>
    </dependentAssembly>
    <dependentAssembly>
        <assemblyIdentity name="system.runtime.interopservices.runtimeinformation" publicKeyToken="b03f5f7f11d50a3a"/>
        <bindingRedirect newVersion="4.3.0" oldVersion="0.0.0.0-4.0.1.0"/>
    </dependentAssembly>
  5. Repeat steps 1-4 for all roles and/or instances.