MSRP - Provedor de recursos do Armazenamento MongoDB

Sobre o MSRP

Quando a AEM Communities está configurada para usar o MSRP como sua loja comum, o conteúdo gerado pelo usuário (UGC) é acessível de todas as instâncias de autor e publicação sem a necessidade de sincronização nem replicação.

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

Requisitos

• MongoDB:

  • Versão 2.6 ou superior
  • Não há necessidade de configurar mongos ou compartilhamento
  • Recomenda-se usar um conjunto de réplicas
  • Pode ser executado no mesmo host que AEM ou executado remotamente

• Apache Solr:

  • Versão 4.10 ou 5
  • A Solr requer Java 1.7 ou superior
  • Nenhum serviço é necessário
  • Escolha dos modos de execução:
    • Modo autônomo
    • Modo SolrCloud (recomendado para ambientes de produção)
  • Escolha da pesquisa multilíngue (MLS)
    • Instalação do MLS padrão
    • Instalação do Advanced MLS

Configuração do MongoDB

Selecionar MSRP

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

Em autor, para acessar o console Configuração do Armazenamento:

• Da navegação global: Ferramentas > Comunidades > Configuração de Armazenamentos

• Selecione Fornecedor de Recursos de Armazenamento MongoDB (MSRP)

• Configuração do mongoDB

  • URI do mongoDB

    padrão: mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred

  • Base de dados do mongoDB

    padrão: comunidades

  • Coleção de UGC do mongoDB

    padrão: conteúdo

  • Coleção de anexos do mongoDB

    padrão: anexos

• SolrConfiguration

  • Host do Zookeeper

    Ao executar no modo SolrCloud com um ZooKeeper externo, defina este valor para HOST:PORT para o ZooKeeper, tal como my.server.com:2181
    Para um conjunto ZooKeeper, insira valores separados por vírgulas HOST:PORT, como host1:2181,host2:2181
    Deixe em branco se estiver executando Solr no modo independente usando o ZooKeeper interno.
    Padrão: <blank>

  • URLT
    SolrO URL usado para se comunicar com o Solr no modo independente.
    Deixe em branco se estiver sendo executado no modo SolrCloud.
    
    Padrão: https://127.0.0.1:8983/solr/

  • Coleção
    SolrO nome da coleção Solr.
    
    Padrão: coleção1

• Selecione Enviar

Conjunto de Réplicas MongoDB

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 aprender a definir conexões entre aplicativos e instâncias MongoDB, visite a documentação Connection String URI Format do MongoDB.

Exemplo de URL para conexão com um conjunto de réplicas

# 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

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

Se as coleções Oak e MSRP forem usadas intensamente, uma segunda Solr poderá ser instalada por motivos de desempenho.

Para ambientes de produção, o modo SolrCloud proporciona um desempenho melhorado em relação ao modo independente (uma configuração única local de Solr).

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

Atualização

Se a atualização de uma versão anterior configurada com MSRP, será necessário

1. Execute a atualização para AEM Communities
2. Instalar novos arquivos de configuração do Solr
   • Para MLS padrão
   • Para MLS avançado
3. Reindexar MSRP
   Consulte a seção Ferramenta MSRP Reindex

Publicar a Configuração

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 publish:

• Autor:
  • Navegue do menu principal para Ferramentas > Operações > Replicação
  • Selecione Ativar árvore
  • Caminho de início:
    • Navegue até /etc/socialconfig/srpc/
  • Selecione Ativar

Gerenciando Dados do Usuário

Para obter informações sobre usuários, perfis de usuário e grupos de usuários, frequentemente inseridos no ambiente de publicação, visite

• Sincronização do usuário
• Gerenciamento de usuários e grupos de usuários

Ferramenta MSRP Reindex

Há um terminal HTTP para reindexar o Solr for MSRP ao instalar novos arquivos de configuração ou reparar um índice de Solr danificado.

Com essa ferramenta, o MongoDB é a fonte de true para o MSRP; os backups só precisam ser feitos do MongoDB.

Toda a árvore UGC pode ser indexada novamente, ou apenas uma subárvore específica, conforme especificado pelo parâmetro *path *data.

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 indexados por lote.

Um padrão razoável é 5000:

• Se a memória for um problema, especifique um número menor
• Se a velocidade for um problema, especifique um número maior para aumentar a velocidade

Execução da ferramenta de reindexação MSRP usando o comando cURL

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

O formato básico é:

cURL -u logon -d data reindex-url

sign = administrative-id:password
Por exemplo: admin:admin

data = "batchSize=size&path=path"

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

path = o local raiz da árvore do UGC a ser reindexada

• Para reindexar todo o UGC, especifique o valor da propriedade asipathde
  /etc/socialconfig/srpc/defaultconfiguration
• Para limitar o índice a algum UGC, especifique uma subárvore de asipath

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

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

Para configurar o MSRP para um ambiente de demonstração ou desenvolvimento, consulte HowTo Setup MongoDB for Demo.

Resolução de problemas

UGC não visível no MongoDB

Verifique se o MSRP foi configurado para ser o provedor padrão ao verificar a configuração da opção armazenamento. Por padrão, o provedor de recursos do armazenamento é JSRP.

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

• No JCR, se /etc/socialconfig

  • Não contém um nó srpc, significa que o provedor de armazenamentos é JSRP
  • Se o nó srpc existir e contiver o nó defaultconfiguration, as propriedades da configuração default deverão definir MSRP como o provedor padrão

O UGC desaparece após a atualização

Se você estiver atualizando de um site AEM Communities 6.0 existente, qualquer UGC pré-existente deverá ser convertido de acordo com a 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 esse fim:

• Ferramenta de migração AEM Communities UGC

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

Erro - id_do_provedor de campo indefinido

Se o seguinte erro for exibido nos registros, isso indica que o arquivo Solr schema não está configurado corretamente.

JsonMappingException: device_id de campo não definido

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 de Instalação do MLS padrão, verifique se

• Os arquivos de configuração XML foram copiados para o local correto do Solr
• A Solr foi reiniciada após os novos arquivos de configuração substituírem os existentes

Falha na conexão segura com MongoDB

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

1. Baixe o driver de https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar (versão 2.13.2 ou posterior)
2. Copie o pacote na pasta "crx-quickstart/install" para uma instância AEM
3. Reinicie a instância AEM

Recursos

• AEM com MongoDB
• Documentação do MongoDB