MSRP - Provedor de Recurso de Armazenamento MongoDB msrp-mongodb-storage-resource-provider

Sobre o MSRP about-msrp

Quando o AEM Communities é configurado para usar o MSRP como seu armazenamento comum, o conteúdo gerado pelo usuário (UGC) pode ser acessado de todas as instâncias de criação e publicação sem a necessidade de sincronização ou replicação.

Consulte também Características das Opções SRP e Topologias Recomendadas.

Requisitos requirements

Configuração do MongoDB mongodb-configuration

Selecionar MSRP select-msrp

O console de Configuração de Armazenamento permite a seleção da configuração de armazenamento padrão, que identifica qual implementação de SRP usar.

Na criação, para acessar o console Configuração de armazenamento:

Conjunto de réplicas do MongoDB mongodb-replica-set

Para o ambiente de produção, é altamente recomendável configurar um conjunto de réplicas, um cluster de servidores MongoDB que implementa a replicação primária-secundária e o failover automatizado.

Para saber mais sobre conjuntos de réplicas, visite a documentação Replicação do MongoDB.

Para trabalhar com conjuntos de réplicas e saber como definir conexões entre aplicativos e instâncias MongoDB, visite a documentação Formato URI de cadeia de conexão do MongoDB.

Exemplo de Url para Conexão com um Conjunto de Réplicas 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

Configuração de Solr solr-configuration

Uma instalação Solr pode ser compartilhada entre o armazenamento de nós (Oak) e o armazenamento comum (MSRP) usando coleções diferentes.

Se as coleções do Oak e do MSRP forem usadas intensamente, um segundo Solr poderá ser instalado por motivos de desempenho.

Para ambientes de produção, o modo SolrCloud oferece melhor desempenho do que o modo autônomo (uma configuração Solr local única).

Para obter detalhes sobre a configuração, consulte Configuração Solr para SRP.

Atualizando upgrading

Se atualizar de uma versão anterior configurada com MSRP, será necessário:

Publicar a configuração publishing-the-configuration

O MSRP deve ser identificado como o armazenamento comum em todas as instâncias de autor e publicação.

Para disponibilizar a configuração idêntica no ambiente de publicação, faça logon na instância do autor e siga as etapas:

Gerenciamento de dados do usuário managing-user-data

Para obter informações sobre usuários, perfis de usuários e grupos de usuários, inseridos com frequência no ambiente de publicação, visite

Ferramenta Reindexação MSRP msrp-reindex-tool

Há um ponto de extremidade HTTP para reindexação de Solr para MSRP ao instalar novos arquivos de configuração ou reparar um índice Solr danificado.

Com esta ferramenta, o MongoDB é a origem da verdade para MSRP; os backups só precisam ser feitos do MongoDB.

A árvore UGC inteira pode ser reindexada ou apenas uma subárvore específica, conforme especificado pelo parâmetro de dados *path *.

Essa ferramenta pode ser executada a partir da linha de comando usando cURL ou qualquer outra ferramenta HTTP.

Ao reindexar, há uma compensação entre a memória e o desempenho controlado pelo parâmetro de dados *batchSize *, que especifica quantos registros UGC são reindexados por lote.

Um padrão razoável é 5000:

Executando a Ferramenta de Reindexação MSRP com o Comando cURL running-msrp-reindex-tool-using-curl-command

O comando cURL a seguir mostra o que é necessário para uma solicitação HTTP reindexar o UGC armazenado no MSRP.

O formato básico é:

cURL -u signin -d data reindex-url

entrada = administrator-id:password
Por exemplo: admin:admin

dados = "batchSize=size&path=path"

tamanho = quantas entradas de UGC devem ser reindexadas por operação
/content/usergenerated/asi/mongo/

caminho = o local raiz da árvore de UGC a ser reindexada

reindex-url = o ponto de extremidade para reindexação de SRP
http://localhost:4503/services/social/datastore/mongo/reindex

Exemplo de reindexação de 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

Como demonstrar o MSRP how-to-demo-msrp

Para configurar o MSRP para um ambiente de demonstração ou desenvolvimento, consulte Como configurar o MongoDB para demonstração.

Resolução de problemas troubleshooting

UGC não visível no MongoDB ugc-not-visible-in-mongodb

Verifique se o MSRP foi configurado como o provedor padrão verificando a configuração da opção de armazenamento. Por padrão, o provedor de recursos de armazenamento é JSRP.

Em todas as instâncias de AEM de autoria e publicação, revisite o console de Configuração de Armazenamento ou verifique o repositório AEM:

O UGC desaparece após a atualização ugc-disappears-after-upgrade

Se estiver atualizando de um site existente do AEM Communities 6.0, qualquer UGC pré-existente deverá ser convertido para se adequar à estrutura necessária para a API SRP após a atualização para o AEM Communities 6.3.

Há uma ferramenta de código aberto disponível no GitHub para esta finalidade:

A ferramenta de migração pode ser personalizada para exportar o UGC de versões anteriores de comunidades sociais do AEM para importação no AEM Communities 6.1 ou posterior.

Erro - campo indefinido provider_id error-undefined-field-provider-id

Se o erro a seguir for visto nos logs, isso indicará que o arquivo de esquema Solr não está configurado corretamente.

JsonMappingException: campo indefinido 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

Para resolver o erro, ao seguir as instruções para Instalando MLS Padrão, verifique se:

Falha na conexão segura com o MongoDB secure-connection-to-mongodb-fails

Se uma tentativa de fazer uma conexão segura com o servidor MongoDB falhar devido a uma definição de classe ausente, é necessário atualizar o pacote de drivers MongoDB, mongo-java-driver, disponível no repositório público do Maven.

Recursos resources