Sitecore XP 8.2におけるMongoDB 3.6およびMongoDB Atlasの対応について


説明

Sitecore XP 8.2.xで使用されているMongoDB 3.4は、以前にお知らせした通り、2020年1月にサポートが終了しました。Sitecore XP 8.2は既に延長サポート フェーズに入っているため、MongoDB 4.0に対応した最新のSitecore XPバージョンにアップグレードしていただくことをお薦めいたします。

Sitecore XP 8.2.xをサポートされているMongoDBバージョンでSitecore XP 8.2.xを継続して利用することを希望されるお客様は、Sitecore XP 8.2.7にアップグレードし、MongoDBサーバーをバージョン3.6にアップグレードし、「解決策」節の通り、MongoDBドライバをアップデートしていただく必要があります。

なお、mLabは、Managed CloudおよびxDBクラウド サービスが使用するデータベースを提供する会社である、MongoDB, Incの一部となりました。本件の背景については、こちらのお知らせをご覧ください。この2つの組織の合併の一環として、mLabサービスが廃止され、ユーザーと連携してMongoDB Atlasへ移行される予定です。

解決策

前提条件:Sitecore XPバージョン8.2.7以前使用されているお客様の場合、正常にアップグレードするには、Sitecore XP 8.2.7にアップグレードする必要があります。

MongoDBドライバの更新については、以下の手順に従って実施してください:

  1. MongoDriver_AtlasCompatible.zipファイルをダウンロードします。
  2. ZIPファイルを解凍し、フォルダ内から以下のアセンブリを抽出します。
    • MongoDB.Bson.dll
    • MongoDB.Driver.Core.dll
    • MongoDB.Driver.dll
    • MongoDB.Driver.Legacy.dll
    • System.Buffers.dll
    • System.Runtime.InteropServices.RuntimeInformation.dll
    • DnsClient.dll
  3. 全ての(/binフォルダ配下に含まれる) Sitecore XPインスタンスに含まれるMongoDBドライバのアセンブリを上記のアセンブリで上書きします。

    重要:MongoDB Atlasの接続文字列のパラメータを区切るには、「&」ではなく「&amp」 を使用してください。
    誤:
    mongodb+srv://sa:12345@cluster0-paklo.mongodb.net/test?retryWrites=true&w=majority
    正:
    mongodb+srv://sa:12345@cluster0-paklo.mongodb.net/test?retryWrites=true&w=majority

ご不明な点がございましたら、Sitecoreサポートにご連絡ください。