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

MSRP について about-msrp

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

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

要件 requirements

MongoDB 設定 mongodb-configuration

MSRP を選択 select-msrp

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

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

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

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

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

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

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

# Example url for:
# servers "mongoserver1", "mongoserver2", "mongoserver3"
# replica set 'rs0'
# port numbers only necessary if not default port 27017
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 で設定された以前のバージョンからアップグレードする場合は、次の操作が必要です。

設定の公開 publishing-the-configuration

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

パブリッシュ環境で同じ設定を使用できるようにするには、オーサーインスタンスにログインして、次の手順に従います。

ユーザーデータの管理 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 のツリーのルート位置

reindex-url = SRP のインデックス再作成のエンドポイント
http://localhost:4503/services/social/datastore/mongo/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リポジトリを確認します。

アップグレード後に 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: undefined field 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 のインストール、次の点を確認します。

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

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

リソース resources