MSRP - MongoDB儲存資源提供者 msrp-mongodb-storage-resource-provider
關於MSRP about-msrp
當AEM Communities設定為使用MSRP作為其通用存放區時,使用者產生的內容(UGC)可從所有製作和發佈執行個體存取,而不需要同步或復寫。
要求 requirements
-
- 2.6版或更新版本
- 不需要設定mongos或分片
- 強烈建議使用 復本集
- 可以在與AEM相同的主機上執行或遠端執行
-
-
Solr 7.0版
-
Solr需要Java 1.7或更高版本
-
不需要服務
-
選擇執行模式:
- 獨立模式
- SolrCloud模式 (建議用於生產環境)
-
多語言搜尋(MLS)選項:
-
MongoDB設定 mongodb-configuration
選取MSRP select-msrp
此 儲存設定主控台 允許選取預設儲存體設定,以識別要使用的SRP實作。
在作者中,若要存取「儲存設定」主控台:
- 在全域導覽中選取 工具 > Communities > 儲存設定.
-
選取 MongoDB儲存資源提供者(MSRP)
-
mongoDB設定
-
mongoDB URI
預設: mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred
-
mongoDB資料庫
預設:社群
-
mongoDB UGC集合
預設:內容
-
mongoDB附件集合
預設:附件
-
-
SolrConfiguration
-
Zookeeper 主機
在中執行時 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復本集 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設定的舊版升級,則需要:
-
安裝新的Solr組態檔
-
重新索引MSRP請參閱區段 MSRP重新索引工具
發佈設定 publishing-the-configuration
MSRP必須識別為所有製作和發佈執行個體上的通用存放區。
若要在發佈環境中使用相同的設定,請登入您的製作執行個體並依照下列步驟進行:
- 從主功能表導覽至 工具 > 作業 > 復寫.
- 選取 啟動樹狀結構
- 開始路徑:
- 瀏覽至
/etc/socialconfig/srpc/
- 瀏覽至
- 選取 啟動
管理使用者資料 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 資料 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
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存放庫:
-
在JCR中,如果 /etc/socialconfig
升級後UGC消失 ugc-disappears-after-upgrade
如果從現有的AEM Communities 6.0網站升級,任何預先存在的UGC都必須轉換,以符合 SRP 升級至AEM Communities 6.3之後的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,確認:
- XML組態檔已複製到正確的Solr位置。
- Solr在新的組態檔取代現有的組態檔之後重新啟動。
與MongoDB的安全連線失敗 secure-connection-to-mongodb-fails
如果嘗試與MongoDB伺服器建立安全連線失敗,因為缺少類別定義,則必須更新MongoDB驅動程式套件, mongo-java-driver
,可從公共maven存放庫取得。
- 從下載驅動程式 https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar (版本2.13.2或更新版本)。
- 將套件組合複製到AEM例項的「crx-quickstart/install」資料夾。
- 重新啟動AEM執行個體。