설명서AEMAEM Screens 안내서

AEM Screens에서 작성자 및 Publish 인스턴스 구성 configuring-author-and-publish-in-aem-screens

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

작성 대상:

  • 사용자

이 페이지에서는 다음 항목을 강조합니다.

  • 작성자 및 Publish 인스턴스 구성
  • Publish 토폴로지 설정
  • 게시 관리: 작성자에서 Publish으로 콘텐츠 업데이트를 장치로 전달

사전 요구 사항 prerequisites

작성자 및 Publish 서버를 시작하기 전에 다음 사항에 대한 사전 지식이 있어야 합니다.

  • AEM 토폴로지
  • AEM Screens 프로젝트 만들기 및 관리
  • 장치 등록 프로세스
NOTE
이 AEM Screens 기능은 AEM 6.4 Screens 기능 팩 2를 설치한 경우에만 사용할 수 있습니다. 이 기능 팩에 액세스하려면 Adobe 지원에 문의하고 액세스를 요청하십시오. 권한이 있으면 패키지 공유에서 다운로드할 수 있습니다.
IMPORTANT
Dispatcher과 함께 Publish 인스턴스를 두 개 이상 사용하려면 Dispatcher을 업데이트하십시오. 고정 세션 사용을 참조하세요.

작성자 및 Publish 인스턴스 구성 configuring-author-and-publish-instances

NOTE
작성자 및 Publish 아키텍처 개요 및 AEM 작성자 인스턴스에서 콘텐츠를 작성한 후 여러 Publish 인스턴스로 앞으로 복제하는 방법에 대한 자세한 내용은 작성자 및 Publish 아키텍처 개요를 참조하십시오.

다음 섹션에서는 작성자 및 Publish 토폴로지에서 복제 에이전트를 설정하는 방법에 대해 설명합니다.

작성자 및 두 개의 Publish 인스턴스를 호스팅하는 간단한 예를 설정할 수 있습니다.

  • 작성자 > localhost:4502
  • Publish 1 (pub1) > localhost:4503
  • Publish 2 (pub2) > localhost:4504

작성자에 대한 복제 에이전트 설정 setting-replication-agents

복제 에이전트를 만들려면 표준 복제 에이전트를 만드는 방법을 알아봅니다.

Screens에 필요한 세 가지 복제 에이전트가 있습니다.

  1. 기본 복제 에이전트 ​(** 표준 복제 에이전트로 지정됨**)
  2. Screens 복제 에이전트
  3. 역방향 복제 에이전트

1단계: 기본 복제 에이전트 생성 step-creating-a-default-replication-agent

기본 복제 에이전트를 만들려면 아래 단계를 따르십시오.

  1. AEM 인스턴스 > hammer 아이콘 > 작업 > 구성 ​으로 이동합니다.

    screen_shot_2019-02-25at24621pm

  2. 왼쪽 탐색 트리에서 복제 ​를 클릭합니다.

    screen_shot_2019-02-25at24715pm

  3. 복제 폴더에서 작성자의 에이전트 ​를 클릭하고 새로 만들기 ​를 클릭하여 새 표준 복제 에이전트를 만듭니다.

    screen_shot_2019-02-25at25400pm

  4. 복제 에이전트를 만들 수 있도록 제목 및 이름 ​을 입력한 다음 만들기 ​를 클릭합니다.

    screen_shot_2019-02-25at25737pm

  5. 복제 에이전트를 마우스 오른쪽 단추로 클릭하고 열기 ​를 클릭하여 설정을 편집합니다.

    screen_shot_2019-02-25at30018pm

  6. 편집 ​을 클릭합니다.

  7. 에이전트 설정 대화 상자에 세부 정보를 입력합니다.

    note note
    NOTE
    사용자가 복제 에이전트를 사용하려면 사용 ​을 확인해야 합니다. 기본, Screens 및 역방향 복제 에이전트에서 이 옵션을 선택합니다.

    screen_shot_2019-02-25at30134pm

  8. 전송 탭으로 이동하여 URI, 사용자 및 암호 ​를 입력하십시오.

    screen_shot_2019-03-04at34955pm

    note note
    NOTE
    기존 기본 복제 에이전트를 복사하고 이름을 변경할 수도 있습니다.

표준 복제 에이전트 생성 creating-standard-replication-agents

  1. pub1용 표준 복제 에이전트를 만듭니다(기본 에이전트가 이미 구성되어 있어야 함). 예, https://<hostname>:4503/bin/receive?sling:authRequestLogin=1
  2. pub2용 표준 복제 에이전트를 만듭니다. pub1용 복제 에이전트를 복사하고 전송 구성에서 포트를 변경하여 pub2에 사용할 전송을 업데이트할 수 있습니다. 예: https://<hostname>:4504/bin/receive?sling:authRequestLogin=1

Screens 복제 에이전트 생성 creating-screens-replication-agents

  1. pub1용 AEM Screens 복제 에이전트를 만듭니다. 기본적으로 포트 4503을 가리키는 이름이 Screens 복제 에이전트입니다. 활성화하십시오.

  2. pub2용 AEM Screens 복제 에이전트를 만듭니다. pub1용 Screens 복제 에이전트를 복사하고 pub2용 4504로 포트를 변경합니다.

    note note
    NOTE
    Screens 복제 에이전트를 구성하는 방법은 Screens 복제 에이전트 구성을 참조하십시오.

Screens 역방향 복제 에이전트 생성 creating-screens-reverse-replication-agents

  1. pub1에 대한 역방향 복제 에이전트를 만듭니다.
  2. pub2에 대한 역방향 복제 에이전트를 만듭니다. 전송 구성에서 포트를 변경하여 pub1에 대한 역방향 복제 에이전트를 복사하고 pub2에 사용할 전송을 업데이트할 수 있습니다.

Publish 토폴로지 설정 setting-up-publish-topology

1단계: Apache Sling Oak 기반 검색 구성 step-configure-apache-sling-oak-based-discovery

토폴로지의 모든 Publish 인스턴스에 대해 Apache Sling Oak 기반 검색 설정

각 Publish 인스턴스의 경우:

  1. https://<host>:<port>/system/console/configMgr(으)로 이동

  2. Apache Sling Oak 기반 검색 서비스 구성을 클릭합니다.

  3. 토폴로지 커넥터 URL 업데이트: 다음과 같은 모든 partaking Publish 인스턴스의 URL을 추가합니다.

    • https://publish:4503/libs/sling/topology/connector
    • https://publish:4504/libs/sling/topology/connector

  4. 토폴로지 커넥터 Whitelist 목록: 모든 Publish 인스턴스를 포함하는 IP 또는 서브넷에 적용하십시오. 포트 번호 없이 모든 Publish 인스턴스의 IP/호스트 이름을 whitelist합니다.

  5. 로컬 루프 자동 중지 사용

구성은 각 Publish 인스턴스에 대해 동일해야 하며 자동 중지 로컬 루프는 무한 루프를 방지합니다.

2단계: Publish 토폴로지 확인 step-verify-publish-topology

Publish 인스턴스의 경우 https://:/system/console/topology(으)로 이동합니다. 나가는 토폴로지 커넥터 아래의 토폴로지에 각 Publish 인스턴스가 표시됩니다.

3단계: ActiveMQ Artemis 클러스터 설정 step-setup-activemq-artemis-cluster

이 단계에서는 ActiveMQ Artemis 클러스터에 대해 암호화된 암호를 만들 수 있습니다.
토폴로지에 있는 모든 Publish 인스턴스의 클러스터 사용자와 암호가 동일해야 합니다. ActiveMQ Artemis 구성의 암호를 암호화해야 합니다. 각 인스턴스에는 자체 암호화 키가 있으므로 암호화 지원을 사용하여 암호화된 암호 문자열을 만들어야 합니다. 그런 다음 ActiveMQ에 대한 OSGi 구성에서 암호화된 암호를 사용할 수 있습니다.

각 Publish 인스턴스에서 다음을 수행합니다.

  1. OSGi 콘솔에서 기본 > 암호화 지원(https://<host>:<port>/system/console/crypto)으로 이동합니다.
  2. 일반 텍스트 ​에 원하는 일반 텍스트 암호(모든 인스턴스에 대해 동일)를 입력합니다.
  3. Protect ​을(를) 클릭합니다.
  4. 보호된 텍스트 값을 메모장이나 텍스트 편집기에 복사합니다. 이 값은 ActiveMQ에 대한 OSGi 구성에서 사용할 수 있습니다.

각 Publish 인스턴스에는 기본적으로 고유한 암호 키가 있으므로 각 pub 인스턴스에서 이 단계를 수행하고 다음 구성을 위해 고유한 키를 저장합니다.

NOTE
암호는 중괄호로 시작하고 끝나야 합니다. 예:
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

4단계: ActiveMQ Artemis 클러스터 활성화 step-activate-activemq-artemis-cluster

각 게시 인스턴스에서 다음을 수행합니다.

  1. OSGi 구성 관리자 https://<host>:<port>/system/console/configMgr(으)로 이동

  2. Apache ActiveMQ Artemis JMS 공급자 구성을 클릭합니다.

  3. 다음 내용을 업데이트합니다.

    • 클러스터 암호: 각 인스턴스당 이전 단계의 암호화된 값을 사용합니다.
    • 주제: {name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}

ActiveMQ Artemis 클러스터 확인 verify-activemq-artemis-cluster

각 Publish 인스턴스에서 아래 단계를 수행합니다.

  1. OSGi 콘솔 > 주 > ActiveMQ Artemis https://localhost:4505/system/console/mq(으)로 이동합니다.

  2. 클러스터 정보 > 토폴로지 > 노드=2, 멤버=2에서 다른 인스턴스의 포트를 확인하고 확인합니다.

  3. 테스트 메시지 보내기(Broker Information 아래 화면 상단)

  4. 필드에 다음 변경 사항을 입력합니다.

    1. 대상: /com.adobe.cq.screens/devTestTopic
    2. 텍스트: 안녕하세요.
    3. 클러스터 전체에서 메시지가 전송되고 수신되었는지 확인할 수 있도록 각 인스턴스의 error.log을(를) 봅니다.
NOTE
이전 단계에서 구성을 저장한 후 OSGi 콘솔로 이동하는 데 몇 초 정도 걸릴 수 있습니다. 자세한 내용은 error.log를 참조하십시오.

예를 들어 다음 이미지는 ActiveMQ Artemis Server의 성공적인 구성 시 표시됩니다.

/system/console/mq ​에서 다음 구성이 표시되지 않으면 /system/console/mq(으)로 이동한 다음 다시 시작 ​을 클릭하여 브로커를 다시 시작합니다.

image-2018-06-18-18-14-55-449

레퍼러 헤더 요구 사항 제거 remove-referrer-header-requirement

각 Publish 인스턴스의 단계를 따릅니다.

  1. OSGi 콘솔 > 구성 관리자(으)로 이동
  2. Apache Sling 레퍼러 필터 ​를 클릭합니다.
  3. 구성을 업데이트하고 비우기 허용 확인

작성자 및 Publish 인스턴스 구성 configuring-author-and-publish-instance

게시 토폴로지를 설정한 후 작성자 및 Publish 인스턴스를 구성하여 구현의 실제 결과를 확인합니다.

NOTE
전제 조건
이 예제를 시작하려면 AEM Screens 프로젝트 만들기 후 프로젝트에서 위치, 표시 및 채널을 만듭니다. 채널에 콘텐츠를 추가하고 디스플레이에 채널을 할당합니다.

1단계: AEM Screens 플레이어 시작(장치)

  1. 별도의 브라우저 창을 시작합니다.
  2. 웹 브라우저, 즉 https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html을(를) 사용하여 Screens 플레이어로 이동하거나 AEM Screens 앱을 시작합니다. 장치를 열면 장치의 상태가 등록되지 않은 것으로 표시됩니다.
NOTE
다운로드한 AEM Screens 앱 또는 웹 브라우저를 사용하여 AEM Screens Player를 열 수 있습니다.

2단계: 작성자에 장치 등록 step-registering-a-device-on-author

  1. https://localhost:4502/screens.html/content/screens/we-retail(으)로 이동하거나 프로젝트를 클릭하고 장치 > 장치 관리자로 이동합니다.
  2. 장치 등록 ​을 클릭합니다.
  3. 장치 등록 ​을 클릭합니다.
  4. 등록할 장치를 클릭한 다음 장치 등록 ​을 클릭합니다.
  5. 등록 코드를 확인한 다음 유효성 검사 ​를 클릭합니다.
  6. 장치의 제목을 입력한 다음 등록 ​을 클릭하세요.

3단계: 표시할 장치 할당 step-assigning-the-device-to-display

  1. 이전 단계의 대화 상자에서 디스플레이 할당 ​을 클릭합니다.
  2. 위치 폴더에서 채널의 표시 경로를 클릭합니다.
  3. 할당 ​을 클릭합니다.
  4. 완료 ​를 클릭하여 프로세스를 완료하면 장치가 할당됩니다.

플레이어를 확인하고 채널에 추가한 콘텐츠를 확인합니다.

4단계: Publish 인스턴스에 장치 구성 게시 step-publishing-device-configuration-to-publish-instances

장치 확인

장치 사용자를 복제하려면 아래 단계를 따르십시오.

  1. 사용자 관리 페이지로 이동합니다. 예: https://localhost:4502/useradmin
  2. screens-devices-master 그룹을 검색합니다.
  3. 그룹을 마우스 오른쪽 단추로 클릭하고 활성화 ​를 클릭합니다.
CAUTION
author-publish-screens-service는 작성자 작업에 사용되는 시스템 사용자이므로 활성화하지 마십시오.

장치 관리 콘솔에서 장치를 활성화할 수도 있습니다. 아래 단계를 따르십시오.

  1. Screens 프로젝트 > 장치(으)로 이동합니다.
  2. 작업 표시줄에서 장치 관리자 ​를 클릭합니다.
  3. 아래 그림과 같이 장치를 클릭하고 작업 표시줄에서 활성화 ​를 클릭합니다.

screen_shot_2019-02-21at111036am

NOTE
또는 장치를 활성화한 후 서버 URL을 편집하거나 업데이트할 수도 있습니다. 아래 그림과 같이 작업 표시줄에서 서버 URL 편집 ​을 클릭합니다. 변경 사항이 AEM Screens 플레이어에 전파됩니다.

screen_shot_2019-02-21at105527am

게시 확인 목록 publishing-check-list

다음은 게시 검사 목록을 요약한 것입니다.

  • Screens 장치 사용자 - 이 정보는 AEM 사용자로 저장되며 도구 > 보안 > 사용자 ​에서 활성화할 수 있습니다. 사용자에게 "screens" 접두사에 긴 직렬화된 문자열이 붙습니다.

  • 프로젝트 - AEM Screens 프로젝트.

  • 위치 - 장치가 연결된 위치입니다.

  • 채널 - 위치에 표시되는 하나 이상의 채널.

  • 일정 - 일정을 사용하는 경우 이 일정이 게시되었는지 확인하십시오.

  • 위치, 일정 및 채널 폴더 - 해당 리소스가 폴더 내에 있는 경우.

작성 및 게시 동작을 확인하려면 아래 단계를 따르십시오.

  1. 작성자 인스턴스에서 일부 채널 콘텐츠를 업데이트합니다.
  2. 모든 Publish 인스턴스에 새 변경 내용을 게시하려면 게시 관리 ​를 수행하십시오.
  3. 장치 관리자 ​에서 장치를 활성화하려면 활성화 ​를 누르십시오.
  4. 작성자 인스턴스 URL에서 게시 인스턴스 URL 중 하나로 URL 편집 ​을 선택합니다.
  5. 업데이트된 채널 콘텐츠가 AEM Screens 플레이어에 표시되는지 확인합니다.
  6. 다른 Publish 인스턴스를 사용하여 이 단계를 반복합니다.

5단계: 관리 패널에서 장치를 Publish 인스턴스로 지정 step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. Screens 플레이어에서 관리자 UI를 보고 왼쪽 상단 모서리를 길게 누르면 터치가 활성화된 AEM Screens 플레이어에서 또는 마우스를 사용하여 관리자 메뉴를 열 수 있습니다.
  2. 사이드 패널에서 구성 옵션을 클릭합니다.
  3. 작성자 인스턴스를 Server ​의 Publish 인스턴스로 변경합니다.

AEM Screens 플레이어에서 변경 사항을 봅니다.

또는 다음 단계를 사용하여 장치 관리 콘솔에서 서버 URL을 업데이트/편집할 수도 있습니다.

  1. AEM Screens 프로젝트로 이동한 다음 장치 폴더를 클릭합니다.
  2. 작업 표시줄에서 장치 관리자 ​를 클릭합니다.
  3. 장치를 클릭한 다음 작업 표시줄에서 아래 그림과 같이 서버 URL 편집 ​을 클릭합니다. 변경 사항이 AEM Screens 플레이어에 전파됩니다.

screen_shot_2019-02-07at31028pm

게시 관리 기능을 사용하면 작성자에서 Publish으로 콘텐츠 업데이트를 장치로 전달할 수 있습니다. 전체 AEM Screens 프로젝트에 대한 콘텐츠 또는 채널, 위치, 장치, 애플리케이션 또는 일정 중 하나에 대한 콘텐츠만 게시/게시 취소할 수 있습니다. 이 기능에 대한 자세한 내용은 주문형 콘텐츠 업데이트를 참조하세요.

문제 해결 팁 troubleshoot-tips

작성자/Publish 설정과 관련된 FAQ에 대한 답변을 보려면 아래 섹션을 따르십시오.

초기 등록 및 할당 후에 https에서 http로 리디렉션을 추가하는 방법 add-redirect

솔루션
Proxy/Load Balancer Connection in the Jetty configuration 사용을 true(으)로 설정합니다.

/content/dam/projects/<project> 외부 에셋의 오프라인 콘텐츠 및 플레이어 다운로드 문제를 업데이트하는 방법 update-offline-content

솔루션
더 제한적으로 사용하려면 모든 /content/dam 또는 사용할 특정 자산에 대해 bulk-offline-update-screens-service 사용자 및 screens-devices-master 그룹에 대한 읽기 권한을 부여하십시오.

Screens 복제 에이전트 오류를 해결하는 방법 replication-agent

솔루션
에이전트 구성에서 역방향 복제에 사용 옵션을 선택하지 않았는지 확인합니다. Screens 복제 에이전트는 역방향 복제 에이전트로 사용할 수 없으며, 이 기능의 범위는 장치 명령을 작성자에서 Publish으로 전달하는 것입니다.

recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053