MongoDB 4.0に対するSitecore XPのサポート


解説

MongoDB 3.6は、(このリンク先に記載されている通り)2021年4月にサポート終了となります。お客様に継続的なサポートを提供するため、以下のバージョンのSitecore XPがテストされ、MongoDB 4.0.5および4.0.13で動作することが認定されています:

Sitecore XP 9.1.1以前のバージョンを使用されているお客様は、MongoDB バージョン4.0以降にアップグレードしていただく必要があります。

前提条件

  1. MongoDb4Sitecore.zip ファイルをダウンロードします。
  2. ファイルをローカル フォルダに解凍します。

XP 8.2の更新手順

以下の手順は、Sitecore XP 8.2.7でのみ有効であることに注意してください。それより前のバージョンを実行されているお客様は、インスタンスをSitecore XP 8.2.7以降に更新する必要があります。

  1. wwwroot\Website\Bin カタログで、次のMongo .dll ファイルをバージョン2.8の同じファイルに置き換えます。
    • CSharpDriver-2.8.0\net452 フォルダー:
      • MongoDB.Bson.dll
      • MongoDB.Driver.Core.dll
      • MongoDB.Driver.dll
      • MongoDB.Driver.Legacy.dll

    • AdditionalLibraries
      • System.Runtime.InteropServices.RuntimeInformation(バージョン4.0.1.0と同じもの)
  2. AdditionalLibraries からのdllファイルを wwwroot\Website\Binに追加します:
    • DnsClient、バージョン=1.3.1.1
    • System.Buffers、バージョン=4.4.0.03
  3. web.config  assemblyBinding セクションに次の行を追加します: 
    <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>
  4. ..\wwwroot\Website\App_Config\ConnectionStrings.config のポート番号がMongoDB サーバー4.0と等しいことを再確認します。
  5. 手順2から4までをすべてのロールやインスタンスに対して繰り返します。

XP 9.0.2-9.1.1のCollection Databaseの更新手順

この手順は、以下のバージョンに適用されます:


以下の場所にあるすべてのMongoDB ドライバー アセンブリ(MongoDB.*.dll)をコピーし、上書きします:

  1. xConnect Collection および xConnect Collection Search ロールのbin フォルダー
  2. xConnect Collection Search ロールのApp_data\jobs\continuous\IndexWorker フォルダー

9.0.0-9.1.1のセッション状態プロバイダーの更新手順

この手順は、以下のバージョンに適用されます:

ソリューションでMongo セッション状態プロバイダーが使用されている場合、Sitecore XP ロールのbin フォルダーにあるすべてのMongoDB ドライバー アセンブリ(MongoDB.*.dll )を上書きします。