ドキュメントAEM 6.4Communities ガイド

MSRP - MongoDB ストレージリソースプロバイダー

最終更新日: 2023年5月4日
  • トピック:
  • Communities

作成対象:

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

MSRP について

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

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

要件

  • MongoDB:

    • バージョン 2.6 以降
    • モンゴや共有を設定する必要がない
    • の使用を強くお勧めします レプリカセット
    • AEMと同じホスト上で実行するか、リモートで実行できます
  • Apache Solr:

    • バージョン 4.10 またはバージョン 5

    • Solr には Java 1.7 以降が必要です

    • サービスは不要

    • 実行モードの選択:

      • スタンドアロンモード
      • SolrCloud モード (実稼動環境に推奨)
    • 多言語検索 (MLS) の選択

      • 標準の MLS のインストール
      • 高度な MLS のインストール

MongoDB 設定

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 サーバーのクラスターであるレプリカセットをセットアップすることを強くお勧めします。

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

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

レプリカセットに接続するための URL の例

# 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 設定

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

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

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

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

アップグレード

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

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

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

    • の場合 標準の MLS
    • の場合 高度な MLS
  3. MSRP のインデックス再作成の節を参照 MSRP インデックス再作成ツール

設定の公開

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

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

  • 作成者:

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

ユーザーデータの管理

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

  • ユーザー同期
  • ユーザーとユーザーグループの管理

MSRP インデックス再作成ツール

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

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

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

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

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

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

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

cURL コマンドを使用した MSRP インデックス再作成ツールの実行

次の 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 インデックス再作成の例

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

MSRP のデモ方法

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

トラブルシューティング

MongoDB で UGC が表示されない

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

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

  • JCR で、 /etc/socialconfig

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

アップグレード後に UGC が消える

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

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

  • AEM Communities UGC 移行ツール

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

エラー — 未定義のフィールド provider_id

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

JsonMappingException:未定義のフィールド 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 へのセキュア接続が失敗する

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インスタンスを再起動します。

リソース

  • MongoDB を備えた AEM
  • MongoDB ドキュメント
recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6