MSRP - MongoDB儲存資源提供者 msrp-mongodb-storage-resource-provider

關於MSRP about-msrp

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

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

要求 requirements

MongoDB設定 mongodb-configuration

選取MSRP select-msrp

儲存設定主控台允許選取預設儲存設定，以識別要使用哪個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

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

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

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

如需組態詳細資訊，請參閱SRP🔗的Solr組態。

升級 upgrading

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

發佈設定 publishing-the-configuration

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

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

管理使用者資料 managing-user-data

如需​ 使用者、使用者設定檔 ​和​ 使用者群組 ​的相關資訊（通常已進入發佈環境），請造訪

MSRP重新索引工具 msrp-reindex-tool

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

使用此工具，MongoDB是MSRP的​ 真相 ​來源；僅需備份MongoDB。

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

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

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

合理的預設值為5000：

使用cURL命令執行MSRP重新索引工具 running-msrp-reindex-tool-using-curl-command

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

基本格式為：

cURL -u 登入 -d 資料 重新索引 — url

登入 =系統管理員ID：密碼
例如： admin：admin

資料 = "batchSize=size&path=path"

size =每個作業要重新索引的UGC專案數
/content/usergenerated/asi/mongo/

path =要重新索引的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

UGC在MongoDB中不可見 ugc-not-visible-in-mongodb

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

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

升級後UGC消失 ugc-disappears-after-upgrade

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

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

可自訂移轉工具，從舊版AEM Social Communities匯出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的指示時，請確定：

與MongoDB的安全連線失敗 secure-connection-to-mongodb-fails

如果嘗試建立與MongoDB伺服器的安全連線由於缺少類別定義而失敗，則必須更新可從公共maven存放庫取得的MongoDB驅動程式套件mongo-java-driver。

資源 resources