MSRP - MongoDB存储资源提供程序 msrp-mongodb-storage-resource-provider

关于MSRP about-msrp

当AEM Communities配置为使用MSRP作为其公用存储时，用户生成的内容(UGC)可从所有创作和发布实例访问，而无需同步或复制。

另请参阅SRP选项的特性和推荐的拓扑。

要求 requirements

MongoDB配置 mongodb-configuration

选择MSRP select-msrp

存储配置控制台允许选择默认存储配置，该配置标识要使用的SRP实现。

在创作时，要访问Storage Configuration控制台，请执行以下操作：

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的​ truth ​的源；只需备份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

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

数据 = "batchSize=大小&path=路径"

大小 =每个操作要重新索引的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早期版本的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