MSRP - MongoDB 저장소 리소스 공급자 msrp-mongodb-storage-resource-provider

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

MSRP 정보 about-msrp

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

참조 - SRP 옵션 특성권장 토폴로지.

요구 사항 requirements

  • MongoDB:

    • 버전 2.6 이상
    • 관리 또는 공유를 구성할 필요가 없음
    • 을 적극 권장합니다 복제본 세트
    • AEM과 동일한 호스트에서 실행하거나 원격으로 실행할 수 있음
  • Apache 솔루션:

    • 버전 4.10 또는 버전 5

    • 솔루션이 Java 1.7 이상 필요

    • 서비스가 필요하지 않습니다

    • 실행 모드 선택:

    • 다국어 검색(MLS) 선택

MongoDB 구성 mongodb-configuration

MSRP 선택 select-msrp

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

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

  • 전역 탐색에서: 도구 > 커뮤니티 > 스토리지 구성

chlimage_1-28

  • 선택 MongoDB 저장소 리소스 공급자(MSRP)

  • mongoDB 구성

    • mongoDB URI

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

    • mongoDB 데이터베이스

      기본: 커뮤니티

    • mongoDB UGC 컬렉션

      기본: 콘텐츠

    • mongoDB 첨부 파일 컬렉션

      기본: 첨부 파일

  • SolrConfiguration

    • 🔗Zookeeper 호스트

      실행 시 SolrCloud 모드 외부 동물원은 이 값을 HOST:PORT 예를 들어 다음과 같은 동물원 관리자 my.server.com:2181
      동물원 관리자 Ensemble의 경우 쉼표로 구분되는 를 입력합니다 HOST:PORT 값과 같은 값 host1:2181,host2:2181
      내부 동물원 Keeper를 사용하여 독립 실행형 모드로 Solr을 실행하는 경우 비워 둡니다.
      기본값: <blank>

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

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

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

      기본값: collection1

  • 선택 제출

NOTE
MongoDB 데이터베이스(기본값은 이름) communities에 사용되는 데이터베이스 이름으로 설정하면 안 됩니다 노드 저장소 또는 데이터(이진) 저장소. 참조 - AEM 6의 저장소 요소.

MongoDB 복제본 세트 mongodb-replica-set

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

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

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

복제본 세트에 연결하는 예제 Url example-url-for-connecting-to-a-replica-set

# Example url for:

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/kr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ko).
#     servers "mongoserver1", "mongoserver2", "mongoserver3"

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/kr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ko).
#     replica set 'rs0'

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/kr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ko).
# port numbers only necessary if not default port 27017

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/kr/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ko).
mongodb://mongoserver1:<mongoport1>,mongoserver2:<mongoport2>,mongoserver3:<mongoport3>/?replicaSet=rs0&maxPoolSize=100&waitQueueMultiple=50&readPreference=secondaryPreferred

Solr 구성 solr-configuration

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

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

프로덕션 환경의 경우 SolrCloud 모드 독립형 모드보다 향상된 성능 제공(단일 로컬 솔루션 설치)

구성에 대한 자세한 내용은 SRP용 솔루션 구성.

업그레이드 upgrading

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

  1. 다음 작업을 수행합니다. AEM Communities으로 업그레이드

  2. 새 Solr 구성 파일 설치

  3. MSRP 다시 색인화 참조 섹션 MSRP 재색인 도구

구성 게시 publishing-the-configuration

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

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

  • 작성자의 경우:

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

사용자 데이터 관리 managing-user-data

관련 정보 사용자, 사용자 프로필사용자 그룹: 게시 환경에 자주 입력되는 방문입니다.

MSRP 재색인 도구 msrp-reindex-tool

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

이 도구를 사용하면 MongoDB가 진리 MSRP용 MongoDB에서만 백업을 수행할 수 있습니다.

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

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

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

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

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

cURL 명령을 사용하여 MSRP 재인덱스 도구 실행 running-msrp-reindex-tool-using-curl-command

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

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

cURL -u 서명 -d 데이터 reindex-url

서명 = administrator-id:password
예: admin:admin

데이터 = "batchSize=크기&path=path"

크기 = 작업당 재색인화할 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

NOTE
만약 DSRP Solr 재인덱싱이면 URL은 /services/social/datastore/rdb/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

MongoDB에 UGC가 표시되지 않음 ugc-not-visible-in-mongodb

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

모든 작성 및 게시 AEM 인스턴스에서 을 다시 방문하여 스토리지 구성 콘솔 또는 AEM 저장소를 확인합니다.

  • JCR에서 /etc/socialconfig

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

업그레이드 후 UGC가 사라짐 ugc-disappears-after-upgrade

기존 AEM Communities 6.0 사이트에서 업그레이드하는 경우 기존 UGC를 SRP AEM Communities 6.3으로 업그레이드한 후 API.

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

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

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

MongoDB에 대한 보안 연결이 실패했습니다. secure-connection-to-mongodb-fails

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

  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 인스턴스를 다시 시작합니다

리소스 resources

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6