MSRP - MongoDB 저장소 리소스 공급자

MSRP 정보

AEM Communities이 MSRP를 일반 스토어로 사용하도록 구성된 경우, 동기화 또는 복제 없이 모든 작성자 및 게시 인스턴스에서 사용자 생성 컨텐츠(UGC)에 액세스할 수 있습니다.

SRP 옵션 및 권장 토폴로지도 참조하십시오.

요구 사항

  • MongoDB:

    • 버전 2.6 이상
    • 관리 또는 공유를 구성할 필요가 없음
    • 복제본 세트를 사용하는 것이 좋습니다.
    • AEM과 동일한 호스트에서 실행하거나 원격으로 실행할 수 있음

  • Apache 솔루션:

    • 버전 4.10 또는 버전 5
    • 솔루션이 Java 1.7 이상 필요
    • 서비스가 필요하지 않습니다
    • 실행 모드 선택:
    • 다국어 검색(MLS) 선택

MongoDB 구성

MSRP 선택

스토리지 구성 콘솔에서는 사용할 SRP 구현을 식별하는 기본 스토리지 구성을 선택할 수 있습니다.

작성자가 스토리지 구성 콘솔에 액세스하려면

  • 전역 탐색에서: 도구 > 커뮤니티 > 저장소 구성

chlimage_1-28

  • MongoDB Storage Resource Provider(MSRP) 선택

  • mongoDB 구성

    • mongoDB URI

      기본값: mongodb://localhost/?maxPoolSize=10&waitQueueMultiple=5&readPreference=secondaryPreferred

    • mongoDB 데이터베이스

      기본값: 커뮤니티

    • mongoDB UGC 컬렉션

      기본값: 콘텐츠

    • mongoDB 첨부 파일 컬렉션

      기본값: 첨부 파일

  • SolrConfiguration

    • 🔗Zookeeper 호스트

      외부 동물원 Keeper와 함께 SolrCloud 모드에서 실행할 때 이 값을 my.server.com:2181​와 같이 동물원은 Keeper에 대해 HOST:PORT로 설정합니다.
      동물원은 Ensemble의 경우 host1:2181,host2:2181​과 같이 쉼표로 구분된 HOST:PORT 값을 입력합니다.
      내부 동물원 Keeper를 사용하여 독립 실행형 모드로 Solr을 실행하는 경우 비워 둡니다.
      기본값: <blank>

    • 솔루션
      URL독립형 모드에서 Solr와 통신하는 데 사용되는 URL입니다.
      SolrCloud 모드에서 실행 중인 경우 비워 둡니다.

      기본값: https://127.0.0.1:8983/solr/

    • Solr
      CollectionSolr 컬렉션 이름입니다.

      기본값: collection1

  • 제출​을 선택합니다

노트

MongoDB 복제본 세트

운영 환경의 경우 운영-보조 복제 및 자동 페일오버를 구현하는 MongoDB 서버 클러스터인 복제본 세트를 설정하는 것이 좋습니다.

복제본 세트에 대한 자세한 내용은 MongoDB의 Replication 설명서를 참조하십시오.

복제본 세트로 작업하고 응용 프로그램과 MongoDB 인스턴스 간 연결을 정의하는 방법을 알아보려면 MongoDB의 연결 문자열 URI 형식 설명서를 참조하십시오.

복제본 세트에 연결하는 예제 Url 

# 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 구성

다른 컬렉션을 사용하여 노드 저장소(Oak)와 공용 저장소(MSRP) 간에 솔루션 설치를 공유할 수 있습니다.

Oak 및 MSRP 컬렉션을 모두 집중적으로 사용하는 경우 성능상의 이유로 두 번째 솔러를 설치할 수 있습니다.

프로덕션 환경의 경우 SolrCloud 모드는 독립 실행형 모드(단일 로컬 솔루션 설정)보다 향상된 성능을 제공합니다.

구성 세부 사항은 SRP용 솔루션 구성을 참조하십시오.

업그레이드

MSRP로 구성된 이전 버전에서 업그레이드하는 경우 다음을 수행해야 합니다

  1. AEM Communities으로 업그레이드 수행
  2. 새 Solr 구성 파일 설치
  3. MSRP 다시 색인화
    섹션 MSRP 재인덱스 도구를 참조하십시오.

구성 게시

MSRP는 모든 작성자 및 게시 인스턴스에서 공용 스토어로 식별되어야 합니다.

게시 환경에서 동일한 구성을 사용할 수 있도록 하려면 다음을 수행하십시오.

  • 작성자의 경우:
    • 기본 메뉴에서 도구 > 작업 > 복제​로 이동합니다.
    • 트리 활성화 선택
    • 시작 경로:
      • /etc/socialconfig/srpc/ 로 이동합니다.
    • 활성화 선택

사용자 데이터 관리

게시 환경에 자주 입력되는 사용자, 사용자 프로필 및 사용자 그룹​에 대한 자세한 내용은 를 참조하십시오.

MSRP 재색인 도구

새 구성 파일을 설치하거나 손상된 Solr 인덱스를 복구할 때 MSRP용 Solr를 다시 인덱싱하기 위한 HTTP 끝점이 있습니다.

이 도구를 사용하는 MongoDB는 MSRP용 truth​의 소스입니다. MongoDB에서만 백업을 수행할 수 있습니다.

전체 UGC 트리는 *path *data 매개 변수에 의해 지정된 대로 다시 인덱싱되거나 지정된 하위 트리만 재인덱싱될 수 있습니다.

이 도구는 cURL 또는 다른 HTTP 도구를 사용하여 명령줄에서 실행할 수 있습니다.

재색인화할 때 배치당 재색인화되는 UGC 레코드 수를 지정하는 *batchSize *데이터 매개 변수에 의해 제어되는 메모리와 성능 간의 트레이드오프가 있습니다.

합리적인 기본값은 5000입니다.

  • 메모리가 문제가 되는 경우 더 작은 숫자를 지정합니다
  • 속도가 문제가 되는 경우 더 큰 숫자를 지정하여 속도를 늘리십시오

cURL 명령을 사용하여 MSRP 재인덱스 도구 실행

다음 cURL 명령은 MSRP에 저장된 UGC를 다시 색인화하는 HTTP 요청에 필요한 사항을 보여줍니다.

기본 형식은 다음과 같습니다.

cURL -u signin -d data reindex-url

signin = administrator-id:password
예: admin:admin

data = "batchSize=size&path=path"

size = 작업당 다시 색인화할 UGC 항목 수
/content/usergenerated/asi/mongo/

path = 다시 색인화할 UGC 트리의 루트 위치

  • 모든 UGC를 다시 색인화하려면asipath
    /etc/socialconfig/srpc/defaultconfiguration
  • 인덱스를 일부 UGC로 제한하려면 asipath 하위 트리를 지정합니다.

reindex url = SRP의 재색인화를 위한 끝점입니다.
http://localhost:4503/services/social/datastore/mongo/reindex

노트

DSRP Solr🔗을(를) 다시 인덱싱하는 경우 URL은 /services/social/datastore/rdb/reindex​입니다.

MSRP 재인덱스 예

curl -s -u admin:admin -d 'batchSize=10000&path=/content/usergenerated/asi/mongo/' http://localhost:4503/services/social/datastore/mongo/reindex

MSRP 데모 방법

데모 또는 개발 환경에 대한 MSRP를 설정하려면 HowTo Setup MongoDB for Demo을 참조하십시오.

문제 해결

MongoDB에 UGC가 표시되지 않음

저장소 옵션의 구성을 확인하여 MSRP가 기본 공급자로 구성되었는지 확인하십시오. 기본적으로 저장소 리소스 공급자는 JSRP입니다.

모든 작성자 및 게시 AEM 인스턴스에서 스토리지 구성 콘솔을 다시 방문하거나 AEM 리포지토리를 확인합니다.

  • JCR에서 /etc/socialconfig인 경우

    • srpc 노드를 포함하지 않습니다. 즉, 스토리지 공급자가 JSRP임을 의미합니다
    • srpc 노드가 있고 defaultconfiguration 노드가 포함된 경우 기본 구성의 속성은 MSRP를 기본 공급자로 정의해야 합니다

업그레이드 후 UGC가 사라짐

기존 AEM Communities 6.0 사이트에서 업그레이드하는 경우 AEM Communities 6.3으로 업그레이드한 후 기존 UGC를 SRP API에 필요한 구조를 준수하도록 변환해야 합니다.

GitHub에서 사용할 수 있는 개방형 소스 도구는 다음과 같습니다.

AEM Communities 6.1 이상으로 가져오기 위해 이전 버전의 AEM 소셜 커뮤니티에서 UGC를 내보내도록 마이그레이션 도구를 사용자 지정할 수 있습니다.

오류 - 정의되지 않은 필드 provider_id

로그에 다음 오류가 표시되면 Solr 스키마 파일이 제대로 구성되지 않은 것입니다.

JsonMappingException: 정의되지 않은 필드 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 구성 파일이 올바른 솔루션 위치에 복사되었습니다.
  • 새 구성 파일이 기존 구성 파일을 교체한 후 솔러가 다시 시작되었습니다.

MongoDB에 대한 보안 연결이 실패했습니다.

클래스 정의가 누락되어 MongoDB 서버에 보안 연결을 시도하지 못한 경우 공용 maven 저장소에서 사용할 수 있는 MongoDB 드라이버 번들 mongo-java-driver을 업데이트해야 합니다.

  1. https://search.maven.org/#artifactdetails%7Corg.mongodb%7Cmongo-java-driver%7C2.13.2%7Cjar에서 드라이버를 다운로드합니다(버전 2.13.2 이상).
  2. AEM 인스턴스에 대한 "crx-quickstart/install" 폴더에 번들을 복사합니다.
  3. AEM 인스턴스를 다시 시작합니다

리소스

이 페이지에서는