MSRP - MongoDB儲存資源提供者

關於MSRP

當AEM Communities設定為使用MSRP作為其通用存放區時，使用者產生的內容(UGC)可從所有製作和發佈執行個體存取，而不需要同步或復寫。

另請參閱 SRP選項的特性 和 建議的拓撲.

要求

  • MongoDB：

    • 2.6版或更新版本
    • 不需要設定蒙哥或分片
    • 強烈建議使用 復本集
    • 可在與AEM相同的主機上執行或遠端執行

  • Apache Solr：

MongoDB設定

選取MSRP

此 儲存設定主控台 允許選取預設儲存設定，以識別要使用的SRP實作。

在作者中，若要存取「儲存體設定」主控台：

  • 在全域導覽中選取 工具 > Communities > 儲存設定.

msrp

  • 選取 MongoDB儲存資源提供者(MSRP)

  • mongoDB 設定

    • mongoDB URI

      預設： mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred

    • mongoDB 資料庫

      預設：社群

    • mongoDB UGC 集合

      預設：內容

    • mongoDB 附件集合

      預設：附件

  • SolrConfiguration

    • 🔗Zookeeper Host

      在中執行時 SolrCloud模式 使用外部ZooKeeper，將此值設定為 HOST:PORT ，例如： my.server.com:2181

      對於ZooKeeper Ensemble，請輸入逗號分隔 HOST:PORT 值，例如 host1:2181，host2:2181

      如果使用內部ZooKeeper在獨立模式下執行Solr，請保留空白。
      預設： <blank>

      • Solr URL
        用於在獨立模式下與Solr通訊的URL。
        若以SolrCloud模式執行，則保留空白。

        預設： https://127.0.0.1:8983/solr/

      • Solr集合
        Solr集合名稱。

        預設：collection1

  • 選取 提交

注意

mongoDB資料庫，預設為名稱 communities，則不應設為正在使用的資料庫名稱 節點存放區或資料（二進位）存放區. 另請參閱 AEM 6.5中的儲存元素.

MongoDB復本集

對於生產環境，強烈建議設定復本集，即實施主要次要復寫和自動容錯移轉的MongoDB伺服器叢集。

若要進一步瞭解復本集，請造訪MongoDB的 復寫 說明檔案。

若要使用復本集並瞭解如何定義應用程式與MongoDB執行個體之間的連線，請造訪MongoDB的 連線字串URI格式 說明檔案。

連線至復本集的Url範例 

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

可以使用不同的集合，在節點存放區(Oak)和公用存放區(MSRP)之間共用Solr安裝。

如果同時大量使用Oak和MSRP集合，則可能會基於效能原因安裝第二個Solr。

對於生產環境， SolrCloud模式 比獨立模式（單一本機Solr設定）提供更優異的效能。

如需設定詳細資訊，請參閱 SRP的Solr設定.

升級

如果從以MSRP設定的舊版升級，則需要：

  1. 執行 升級至AEM Communities
  2. 安裝新的Solr組態檔
  3. 重新索引MSRP請參閱區段 MSRP重新索引工具

發佈設定

MSRP必須識別為所有製作和發佈執行個體上的通用存放區。

若要在發佈環境中使用相同的設定，請登入您的Author執行個體並依照以下步驟操作：

  • 從主要功能表瀏覽至 工具 > 作業 > 復寫.
  • 選取 啟動樹狀結構
  • 開始路徑:
    • 瀏覽至 /etc/socialconfig/srpc/
  • 選取 啟動

管理使用者資料

有關以下專案的資訊： 使用者， 使用者設定檔 和 使用者群組，通常輸入發佈環境中，請造訪

MSRP重新索引工具

在安裝新組態檔或修復損壞的Solr索引時，有HTTP端點可為MSRP重新索引Solr。

使用此工具，MongoDB是 truth 對於MSRP；僅需備份MongoDB。

您可以重新索引整個UGC樹狀結構，或只重新索引特定的子樹狀結構，如*path *data引數所指定。

此工具可從命令列使用cURL或任何其他HTTP工具執行。

重新索引時，會權衡由*batchSize *data引數控制的記憶體與效能，該引數指定每個批次重新索引的UGC記錄數。

合理的預設值為5000：

  • 如果記憶體有問題，請指定較小的數字
  • 如果速度有問題，請指定較大的數字以提高速度

使用cURL命令執行MSRP重新索引工具

以下cURL命令顯示HTTP要求重新索引儲存在MSRP中的UGC所需的專案。

基本格式為：

cURL -u 登入 -d 資料 reindex-url

登入 = administrator-id：password例如： admin：admin

資料 = "batchSize=大小​路徑(&P)=路徑」

大小 =每個作業要重新索引的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

注意

如果您是 重新索引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以進行示範.

疑難排解

UGC在MongoDB中不可見

檢查儲存選項的設定，確認MSRP已設定為預設提供者。 依預設，儲存資源提供者為JSRP。

在所有作者和發佈AEM執行個體上，重新造訪 儲存設定主控台 或檢查AEM存放庫：

  • 在JCR中，如果 /etc/socialconfig

    • 不包含 srpc 節點，這表示儲存提供者為JSRP。
    • 如果srpc節點存在且包含節點 default設定，defaultconfiguration的屬性應將MSRP定義為預設提供者。

升級後UGC消失

如果從現有的AEM Communities 6.0網站升級，任何預先存在的UGC都必須轉換，以符合 SRP 升級至AEM Communities 6.3後的API。

GitHub上有一個開放原始碼工具可用於此用途：

可自訂移轉工具，以便從舊版AEM Social Communities匯出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執行個體。

資源

本頁內容