설명서AEM 6.5Communities 안내서

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자

MSRP 정보 about-msrp

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

SRP 옵션의 특성 및 권장 토폴로지도 참조하세요.

요구 사항 requirements

  • 몽고 DB:

    • 버전 2.6 이상
    • 몽고 또는 분할을 구성할 필요가 없음
    • 복제본 집합을(를) 사용하는 것이 좋습니다
    • AEM과 동일한 호스트에서 실행되거나 원격으로 실행될 수 있음

  • Apache Solr:

    • Solr 버전 7.0

    • Solr에는 Java 1.7 이상이 필요합니다.

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

    • 실행 모드 선택:

    • 다국어 검색(MLS) 선택:

MongoDB 구성 mongodb-configuration

MSRP 선택 select-msrp

저장소 구성 콘솔에서 사용할 SRP 구현을 식별하는 기본 저장소 구성을 선택할 수 있습니다.

작성자의 경우 스토리지 구성 콘솔에 액세스하려면 다음을 수행하십시오.

  • 전역 탐색에서 도구 > 커뮤니티 > 저장소 구성 ​을 선택합니다.

msrp

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

  • mongoDB 구성

    • mongoDB URI

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

    • mongoDB 데이터베이스

      기본값: 커뮤니티

    • mongoDB UGC 컬렉션

      기본값: 콘텐츠

    • mongoDB 첨부 파일 컬렉션

      기본: 첨부 파일

  • SolrConfiguration

    • Zookeeper Host

      외부 ZooKeeper로 SolrCloud 모드에서 실행하는 경우 이 값을 ZooKeeper에 대해 HOST:PORT(예: my.server.com:2181)로 설정하십시오.

      Zookeeper Ensemble의 경우 host1:2181,host2:2181 ​과 같이 쉼표로 구분된 HOST:PORT 값을 입력하십시오.

      내부 ZooKeeper를 사용하여 Solr을 독립 실행형 모드로 실행하는 경우 비워 둡니다.
      기본값: <공백>

      • Solr URL
        독립 실행형 모드에서 Solr과 통신하는 데 사용되는 URL입니다.
        SolrCloud 모드에서 실행하는 경우 비워 둡니다.
        기본값: https://127.0.0.1:8983/solr/

      • Solr 컬렉션
        Solr 컬렉션 이름입니다.
        기본값: collection1

  • 제출 선택

NOTE
기본적으로 communities 이름으로 설정되어 있는 mongoDB 데이터베이스는 노드 저장소 또는 데이터(이진) 저장소에 사용 중인 데이터베이스 이름으로 설정해서는 안 됩니다. AEM 6.5의 저장소 요소도 참조하세요.

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

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

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

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

구성에 대한 자세한 내용은 SRP에 대한 Solr 구성을 참조하십시오.

업그레이드 중 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에 대한 truth ​의 소스입니다. 백업은 MongoDB에서만 수행하면 됩니다.

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

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

리인덱싱할 때 일괄 처리당 얼마나 많은 UGC 레코드가 리인덱싱되는지를 지정하는 *batchSize *data 매개 변수에 의해 제어되는 성능과 메모리 간에 트레이드오프가 발생합니다.

적절한 기본값은 5000입니다.

  • 메모리에 문제가 있는 경우 더 작은 숫자를 지정하십시오
  • 속도가 문제인 경우 더 큰 숫자를 지정하여 속도를 높입니다.

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

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

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

cURL -u 로그인 -d 데이터 reindex-url

로그인 = administrator-id:password
예: admin:admin

데이터 = "batchSize=size&path=path"

size = 작업당 다시 인덱싱할 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

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

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

모든 작성자 및 게시 AEM 인스턴스에서 저장소 구성 콘솔을 다시 방문하거나 AEM 저장소를 확인하십시오.

  • JCR에서, /etc/socialconfig인 경우

    • srpc 노드를 포함하지 않습니다. 이는 저장소 공급자가 JSRP임을 의미합니다.
    • srpc 노드가 존재하고 defaultconfiguration 노드를 포함하는 경우 defaultconfiguration의 속성은 MSRP를 기본 공급자로 정의해야 합니다.

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

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

GitHub에는 이러한 목적으로 사용할 수 있는 오픈 소스 도구가 있습니다.

이전 버전의 AEM 소셜 커뮤니티에서 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 설치에 대한 지침을 따를 때 다음을 확인하십시오.

  • XML 구성 파일이 올바른 Solr 위치에 복사되었습니다.
  • 새 구성 파일이 기존 구성 파일을 대체한 후 Solr이 다시 시작되었습니다.

MongoDB에 대한 보안 연결 실패 secure-connection-to-mongodb-fails

클래스 정의가 누락되어 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 인스턴스를 다시 시작합니다.

리소스 resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791