MSRP - MongoDB ストレージリソースプロバイダー msrp-mongodb-storage-resource-provider

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

MSRP について about-msrp

AEM Communitiesが MSRP を共通ストアとして使用するように設定されている場合、同期やレプリケーションを必要とせずに、すべてのオーサーインスタンスとパブリッシュインスタンスからユーザー生成コンテンツ (UGC) にアクセスできます。

関連トピック SRP オプションの特性 および 推奨されるトポロジ.

要件 requirements

MongoDB 設定 mongodb-configuration

MSRP を選択 select-msrp

この ストレージ設定コンソール では、使用する SRP の実装を指定するデフォルトのストレージ設定を選択できます。

オーサー環境でストレージ設定コンソールにアクセスするには、次の手順に従います。

  • グローバルナビゲーションから: ツール/コミュニティ/ストレージ設定

chlimage_1-28

  • 選択 MongoDB ストレージリソースプロバイダー (MSRP)

  • MongoDB 設定

    • MongoDB URI

      デフォルト//localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred

    • MongoDB データベース

      デフォルト:コミュニティ

    • MongoDB UGC コレクション

      デフォルト:コンテンツ

    • MongoDB 添付ファイルコレクション

      デフォルト:添付ファイル

  • SolrConfiguration

    • 🔗Zookeeper ホスト

      で実行する場合 SolrCloud モード 外部の ZooKeeper で、この値を HOST:PORT ZooKeeper の my.server.com:2181
      ZooKeeper アンサンブルの場合は、コンマ区切りで入力します。 HOST:PORT 値: host1:2181,host2:2181
      Solr をスタンドアロンモードで実行する場合は、内部 ZooKeeper を使用して空白のままにします。
      デフォルト: <blank>

    • Solr URL
      スタンドアロンモードで Solr との通信に使用する URL です。
      SolrCloud モードで実行する場合は空白のままにします。

      デフォルト//127.0.0.1:8983/solr/

    • Solr コレクション
      Solr コレクション名です。

      デフォルト:collection1

  • 送信」を選択します。

NOTE
MongoDB データベース。デフォルトの名前はです。 communitiesを、使用するデータベースの名前に設定しないでください。 ノードストアまたはデータ(バイナリ)ストア. 関連トピック AEM 6 のストレージ要素.

MongoDBレプリカセット mongodb-replica-set

本番環境では、プライマリセカンダリレプリケーションと自動フェイルオーバーを実装する MongoDB サーバーのクラスターであるレプリカセットをセットアップすることを強くお勧めします。

レプリカセットの詳細については、MongoDB の レプリケーション ドキュメント。

レプリカセットの操作と、アプリケーションと MongoDB インスタンス間の接続を定義する方法については、MongoDB の 接続文字列 URI の形式 ドキュメント。

レプリカセットに接続するための URL の例 example-url-for-connecting-to-a-replica-set

# Example url for:

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
#     servers "mongoserver1", "mongoserver2", "mongoserver3"

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
#     replica set 'rs0'

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
# port numbers only necessary if not default port 27017

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
mongodb://mongoserver1:<mongoport1>,mongoserver2:<mongoport2>,mongoserver3:<mongoport3>/?replicaSet=rs0&maxPoolSize=100&waitQueueMultiple=50&readPreference=secondaryPreferred

Solr 設定 solr-configuration

異なるコレクションを使用することで、1 つの Solr インストールをノードストア (Oak) と共通ストア (MSRP) の間で共有できます。

Oak コレクションと MSRP コレクションの両方を集中的に使用する場合は、パフォーマンス上の理由から 2 つ目の Solr をインストールすることができます。

実稼動環境の場合、 SolrCloud モード では、スタンドアロンモード(単一のローカル Solr 設定)よりも高いパフォーマンスを提供します。

設定の詳細については、 SRP 用の Solr 設定.

アップグレード upgrading

MSRP で設定された以前のバージョンからアップグレードする場合は、次の手順を実行する必要があります。

  1. を実行します。 AEM Communitiesへのアップグレード

  2. 新しい Solr 設定ファイルをインストールします

  3. MSRP のインデックス再作成の節を参照 MSRP インデックス再作成ツール

設定の公開 publishing-the-configuration

MSRP は、すべてのオーサーインスタンスとパブリッシュインスタンスで共通ストアとして識別する必要があります。

パブリッシュ環境で同じ設定を使用できるようにするには、次の手順を実行します。

  • 作成者:

    • メインメニューからに移動します。 [ ツール ] > [ 操作 ] > [ レプリケーション ]
    • 選択 ツリーをアクティベート
    • 開始パス:
      • 参照先 /etc/socialconfig/srpc/
    • 選択 有効化

ユーザーデータの管理 managing-user-data

以下に関する情報: ユーザー, ユーザープロファイル および ユーザーグループ ​パブリッシュ環境に入力されることが多い場合は、次にアクセスします。

MSRP インデックス再作成ツール msrp-reindex-tool

新しい設定ファイルをインストールしたり、破損した Solr インデックスを修復する際に、MSRP 用の Solr のインデックスを再作成するための HTTP エンドポイントがあります。

このツールを使用すると、MongoDB は 真実 (MSRP 用)バックアップは MongoDB からのみ取得する必要があります。

UGC ツリー全体のインデックスを再作成することも、*path *data パラメーターで指定された特定のサブツリーのみを再作成することもできます。

このツールは、cURL または他の HTTP ツールを使用してコマンドラインから実行できます。

インデックス再作成時には、メモリとパフォーマンスの間のトレードオフがあります。このトレードオフは、*batchSize *data パラメータで制御し、バッチごとに再インデックスされる UGC レコードの数を指定します。

適切なデフォルト値は 5000 です。

  • メモリが問題の場合は、より小さい数値を指定します
  • 速度が問題の場合は、速度を上げるために大きい数値を指定します

cURL コマンドを使用した MSRP インデックス再作成ツールの実行 running-msrp-reindex-tool-using-curl-command

次の cURL コマンドは、MSRP に格納された UGC を再インデックスする HTTP リクエストに必要な事項を示しています。

基本的な形式は次のとおりです。

cURL -u サインイン -d データ reindex-url

サインイン = administrator-id:password
例:admin:admin

データ = "batchSize=サイズ&path=path"

サイズ =操作ごとにインデックスを再作成する UGC エントリの数
/content/usergenerated/asi/mongo/

パス =再インデックスする UGC のツリーのルート位置

  • すべての UGC を再インデックスするには、 asipathプロパティ
    /etc/socialconfig/srpc/defaultconfiguration
  • インデックスを一部の UGC に制限するには、次のサブツリーを指定します。 asipath

reindex-url = SRP のインデックス再作成のエンドポイント
http://localhost:4503/services/social/datastore/mongo/reindex

NOTE
次の場合、 DSRP Solr のインデックス再作成の場合、URL は /services/social/datastore/rdb/reindex

MSRP インデックス再作成の例 msrp-reindex-example

curl -s -u admin:admin -d 'batchSize=10000&path=/content/usergenerated/asi/mongo/' http://localhost:4503/services/social/datastore/mongo/reindex

MSRP のデモ方法 how-to-demo-msrp

デモ環境または開発環境用に MSRP を設定するには、 デモ用に MongoDB を設定する方法.

トラブルシューティング troubleshooting

MongoDB で UGC が表示されない ugc-not-visible-in-mongodb

ストレージオプションの設定を確認して、MSRP がデフォルトのプロバイダーに設定されていることを確認します。 デフォルトでは、ストレージリソースプロバイダーは JSRP です。

すべてのオーサーインスタンスとパブリッシュAEMインスタンスで、 ストレージ設定コンソール AEMリポジトリを確認します。

  • JCR で、 /etc/socialconfig

    • 次を含まない srpc ノードの場合、ストレージプロバイダーが JSRP であることを意味します。
    • srpc ノードが存在し、ノードが含まれる場合 defaultconfigurationの場合、デフォルトの設定のプロパティでは、MSRP をデフォルトのプロバイダーとして定義する必要があります

アップグレード後に UGC が消える ugc-disappears-after-upgrade

既存のAEM Communities 6.0 サイトからアップグレードする場合は、既存の UGC を、 SRP AEM Communities 6.3 にアップグレードした後の API

この目的で、GitHub で利用できるオープンソースツールがあります。

移行ツールは、AEMソーシャルコミュニティの以前のバージョンから UGC を書き出し、AEM Communities 6.1 以降に読み込むようにカスタマイズできます。

エラー — 未定義のフィールド provider_id error-undefined-field-provider-id

ログに次のエラーが表示される場合は、Solr スキーマファイルが正しく設定されていないことを示します。

JsonMappingException:未定義のフィールド provider_id jsonmappingexception-undefined-field-provider-id

Caused by: com.fasterxml.jackson.databind.JsonMappingException: undefined field provider_id
at com.fasterxml.jackson.databind.ser.DefaultSerializerProvider.serializeValue(DefaultSerializerProvider.java:129)
at com.fasterxml.jackson.databind.ObjectMapper.writeValue(ObjectMapper.java:1819)
at com.adobe.cq.social.scf.core.BaseSocialComponent.toJSONString(BaseSocialComponent.java:196)
... 124 common frames omitted

エラーを解決するには、 標準の MLS のインストール,確実に

  • XML 設定ファイルが正しい Solr の場所にコピーされました
  • 新しい設定ファイルが既存の設定ファイルに置き換えられた後に Solr が再起動されました

MongoDB へのセキュア接続が失敗する secure-connection-to-mongodb-fails

MongoDB サーバーへのセキュア接続を試みても、クラス定義が見つからず、失敗した場合は、MongoDB ドライバーバンドルを更新する必要があります。 mongo-java-driver:パブリック maven リポジトリから入手できます。

  1. からドライバをダウンロードします。 https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar ( バージョン2.13.2以降 )
  2. バンドルをAEMインスタンスの「crx-quickstart/install」フォルダーにコピーします。
  3. AEMインスタンスを再起動します。

リソース resources

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6