DocumentaçãoAEMGuia do AEM Screens

Configurar instâncias de Autor e Publicação no AEM Screens configuring-author-and-publish-in-aem-screens

Last update: Tue Jun 17 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário

Esta página destaca os seguintes tópicos:

  • Configurando instâncias de Autor e Publicação
  • Configurando a Topologia de Publicação
  • Gerenciando a Publicação: Entregando Atualizações de Conteúdo de Autor para Publicar no Dispositivo

Pré-requisitos prerequisites

Antes de começar a usar servidores de Autor e Publicação, você deve ter conhecimento prévio sobre:

  • Topologia do AEM
  • Criando e gerenciando o projeto do AEM Screens
  • Processo de registro do dispositivo
NOTE
Essa funcionalidade do AEM Screens só estará disponível se você tiver instalado o AEM 6.4 Screens Feature Pack 2. Para obter acesso a este Feature Pack, entre em contato com o Suporte da Adobe e solicite acesso. Depois de obter permissão, você pode baixá-lo do Compartilhamento de pacotes.
IMPORTANT
Se quiser usar mais de uma instância de publicação com o Dispatcher, atualize o Dispatcher. Consulte Habilitando Sessões Fixas.

Configurar instâncias de Autor e Publicação configuring-author-and-publish-instances

NOTE
Para saber mais sobre a visão geral da arquitetura Autor e Publicação e como o conteúdo é criado em uma instância de Autor do AEM e, em seguida, replicado para várias instâncias Publicar, consulte Visão geral da arquitetura de Autor e Publicação.

A seção a seguir explica como configurar agentes de replicação na topologia Autor e Publicação.

Você pode configurar um exemplo simples, em que você hospeda uma instância de Autor e duas instâncias de Publicação:

  • Autor > localhost:4502
  • Publicar 1 (pub1) > localhost:4503
  • Publicar 2 (pub2) > localhost:4504

Configurar agentes de replicação no autor setting-replication-agents

Para criar agentes de replicação, saiba como criar um agente de replicação padrão.

Há três agentes de replicação necessários para o Screens:

  1. Agente de Replicação Padrão ​(especificado como​** Agente de Replicação Padrão**)
  2. Agente de replicação da Screens
  3. Agente de Replicação Reversa

Etapa 1: Criar um Agente de Replicação Padrão step-creating-a-default-replication-agent

Siga as etapas abaixo para criar um agente de replicação padrão:

  1. Navegue até sua instância do AEM > ícone de martelo > Operações > Configuração.

    screen_shot_2019-02-25at24621pm

  2. Clique em Replicação na árvore de navegação esquerda.

    screen_shot_2019-02-25at24715pm

  3. Clique nos Agentes no Autor da pasta Replicação e clique em Novo para criar um novo agente de replicação padrão.

    screen_shot_2019-02-25at25400pm

  4. Insira o Título e o Nome para criar o agente de replicação e clique em Criar.

    screen_shot_2019-02-25at25737pm

  5. Clique com o botão direito do mouse no agente de replicação e clique em Abrir para editar as configurações.

    screen_shot_2019-02-25at30018pm

  6. Clique em Editar.

  7. Na caixa de diálogo Configurações do Agente, insira os detalhes.

    note note
    NOTE
    O usuário deve marcar Habilitado para habilitar o agente de replicação. Marque esta opção nos agentes padrão, Screens e de replicação reversa.

    screen_shot_2019-02-25at30134pm

  8. Navegue até a guia Transporte e insira o URI, Usuário e Senha.

    screen_shot_2019-03-04at34955pm

    note note
    NOTE
    Você também pode copiar e renomear um agente de replicação padrão existente.

Criar agentes de replicação padrão creating-standard-replication-agents

  1. Crie um agente de replicação padrão para pub1 (um agente padrão pronto para uso já deve estar configurado). Por exemplo, https://<hostname>:4503/bin/receive?sling:authRequestLogin=1
  2. Crie um agente de replicação padrão para pub2. Você pode copiar o agente de replicação para pub1 e atualizar o transporte a ser usado para pub2 alterando a porta na configuração de transporte. Por exemplo, https://<hostname>:4504/bin/receive?sling:authRequestLogin=1.

Criar agentes de replicação do Screens creating-screens-replication-agents

  1. Crie um agente de replicação AEM Screens para pub1. Pronto para uso, há um agente de replicação Screens nomeado que aponta para a porta 4503. Ative-o.

  2. Crie um agente de replicação AEM Screens para pub2. Copie o agente de replicação do Screens para pub1 e altere a porta para apontar para 4504 para pub2.

    note note
    NOTE
    Para saber como configurar agentes de replicação Screens, consulte Configurando o Agente de Replicação Screens.

Criar agentes de replicação reversa do Screens creating-screens-reverse-replication-agents

  1. Crie um agente de replicação reversa para pub1.
  2. Crie um agente de replicação reversa para pub2. Você pode copiar o agente de replicação reversa para pub1 e atualizar o transporte a ser usado para pub2 alterando a porta na configuração de transporte.

Configurar Topologia de Publicação setting-up-publish-topology

Etapa 1: Configurar A Descoberta Baseada No Apache Sling Oak step-configure-apache-sling-oak-based-discovery

Configurar a descoberta baseada no Apache Sling Oak para todas as instâncias de publicação na topologia

Para cada instância de publicação:

  1. Navegue até https://<host>:<port>/system/console/configMgr

  2. Clique na Configuração do Apache Sling Oak-Based Discovery Service.

  3. Atualizar URLs do conector de Topologia: adicione URLs de todas as instâncias de Publicação participantes que sejam:

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

  4. Lista do conector de topologia Whitelist: Adaptar-se a IPs ou sub-redes que abrangem todas as instâncias de publicação. Certifique-se de whitelist o IP/nome de host de todas as instâncias Publish sem o número da porta.

  5. Habilitar Loops Locais de Interrupção Automática

A configuração deve ser idêntica para cada instância de publicação, e o loop local de interrupção automática impede um loop infinito.

Etapa 2: Verificar Topologia de Publicação step-verify-publish-topology

Para qualquer uma das instâncias de publicação, navegue até https://:/system/console/topology. Você deve ver cada instância de Publicação representada na topologia em Conectores de topologia de saída.

Etapa 3: Configurar Cluster AtiveMQ Artemis step-setup-activemq-artemis-cluster

Essa etapa permite criar uma senha criptografada para o cluster AtiveMQ Artemis.
O usuário do cluster e a senha de todas as instâncias de Publicação na topologia devem ser idênticos. A senha da configuração do AtiveMQ Artemis deve ser criptografada. Como cada instância tem sua própria chave de criptografia, é necessário usar o Suporte de criptografia para criar uma cadeia de caracteres de senha criptografada. Em seguida, a senha criptografada pode ser usada na configuração OSGi para AtiveMQ.

Em cada instância de publicação:

  1. No Console OSGi, navegue até PRINCIPAL > Suporte de criptografia (https://<host>:<port>/system/console/crypto).
  2. Digite a senha de texto sem formatação desejada (a mesma para todas as instâncias) em Texto sem formatação
  3. Clique em Proteger.
  4. Copie o valor Texto protegido para um bloco de notas ou editor de texto. Esse valor pode ser usado na configuração do OSGi para AtiveMQ.

Como cada instância de publicação, por padrão, tem chaves de criptografia exclusivas, execute essa etapa em cada instância do pub e salve a chave exclusiva para a próxima configuração.

NOTE
A senha deve começar e terminar com chaves. Por exemplo:
​>{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

Etapa 4: Ativar Cluster Artemis AtiveMQ step-activate-activemq-artemis-cluster

Em cada instância de publicação:

  1. Navegue até o gerenciador de configurações OSGi https://<host>:<port>/system/console/configMgr

  2. Clique na Configuração do Apache AtiveMQ Artemis JMS Provider

  3. Atualize o seguinte:

    • Senha do Cluster: usar o valor criptografado da etapa anterior por respectiva instância
    • Tópicos: {name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}

Verificar Cluster Artemis do AtiveMQ verify-activemq-artemis-cluster

Siga as etapas abaixo em cada instância de publicação:

  1. Navegue até o Console OSGi > Principal > AtiveMQ Artemis https://localhost:4505/system/console/mq.

  2. Verifique e marque para exibir as portas de outras instâncias em Informações de Cluster > Topologia > nós=2, membros=2.

  3. Enviar uma Mensagem de Teste (parte superior da tela em Informações do Agente)

  4. Informe as seguintes alterações nos campos:

    1. Destino: /com.adobe.cq.screens/devTestTopic
    2. Texto: Olá, Mundo
    3. Exiba o error.log de cada instância para que você possa ver se a mensagem foi enviada e recebida no cluster.
NOTE
A navegação para o Console OSGi pode levar alguns segundos após salvar a configuração na etapa anterior. Você também pode verificar o error.log para obter mais detalhes.

Como exemplo, a imagem a seguir é exibida na configuração bem-sucedida do Servidor AtiveMQ Artemis.

Se você não vir a seguinte configuração de /system/console/mq, navegue até /system/console/mq e clique em Reiniciar para reiniciar o agente.

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

Remover requisito de cabeçalho do referenciador remove-referrer-header-requirement

Siga as etapas em cada instância de publicação:

  1. Navegue até o Console OSGi > Gerenciador de Configurações
  2. Clique em Filtro de referenciador Apache Sling
  3. Atualizar configuração e marcar Permitir Vazio

Configurar Instância de Autor e Publicação configuring-author-and-publish-instance

Depois de configurar a topologia de publicação, configure as instâncias Autor e Publicar para exibir os resultados práticos da implementação:

NOTE
Pré-requisitos
Para começar a usar este exemplo, crie um projeto do AEM Screens e, em seguida, crie um local, exibição e canal em seu projeto. Adicione conteúdo ao canal e atribua o canal a uma exibição.

Etapa 1: iniciar um AEM Screens Player (dispositivo)

  1. Inicie uma janela separada do navegador.
  2. Vá para o Screens player usando o navegador da Web, ou seja,https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html ou inicie o aplicativo AEM Screens. Ao abrir o dispositivo, observe o estado do dispositivo como não registrado.
NOTE
É possível abrir um AEM Screens Player usando o aplicativo AEM Screens baixado ou o navegador da Web.

Etapa 2: Registrar um dispositivo no autor step-registering-a-device-on-author

  1. Vá para https://localhost:4502/screens.html/content/screens/we-retail ou clique no projeto e navegue até Dispositivos > Gerenciador de dispositivos.
  2. Clique em Registrar Dispositivo.
  3. Clique em Device Registration.
  4. Clique no dispositivo que você deseja registrar e em Registrar dispositivo.
  5. Verifique o código de registro e clique em Validar.
  6. Insira um título para o dispositivo e clique em Registrar.

Etapa 3: atribuir o dispositivo à exibição step-assigning-the-device-to-display

  1. Clique em Atribuir exibição na caixa de diálogo da etapa anterior.
  2. Clique no caminho de exibição do seu canal na pasta Locais.
  3. Clique em Atribuir.
  4. Clique em Concluir para concluir o processo e agora o dispositivo foi atribuído.

Verifique o reprodutor e observe o conteúdo que você adicionou ao canal.

Etapa 4: publicar a configuração do dispositivo nas instâncias de publicação step-publishing-device-configuration-to-publish-instances

Verificar o dispositivo

Siga as etapas abaixo para replicar o usuário do dispositivo:

  1. Navegue até a página de administrador do usuário. Por exemplo, https://localhost:4502/useradmin.
  2. Procure o grupo screens-devices-master.
  3. Clique com o botão direito no grupo e clique em Ativar.
CAUTION
Não ative o author-publish-screens-service, pois ele é um usuário do sistema usado pela Tarefa do Autor.

Você também pode ativar o dispositivo no Console de Gerenciamento de Dispositivos. Siga as etapas abaixo:

  1. Navegue até seu projeto do Screens > Dispositivos.
  2. Clique em Gerenciador de dispositivos na barra de ações.
  3. Clique no dispositivo e clique em Ativar na barra de ações, conforme mostrado na figura abaixo.

screen_shot_2019-02-21at11036am

NOTE
Como alternativa, após ativar o dispositivo, você também pode editar ou atualizar o URL do servidor. Na barra de ações, clique em Editar URL do servidor, conforme mostrado na figura abaixo. Suas alterações se propagam para o AEM Screens Player.

screen_shot_2019-02-21at105527am

Publicar lista de verificação publishing-check-list

Os pontos a seguir resumem a Lista de verificação de publicação:

  • Usuário de Dispositivo do Screens - Estas informações são armazenadas como um usuário do AEM e podem ser ativadas em Ferramentas > Segurança > Usuários. O usuário recebe o prefixo "screens" com uma longa sequência serializada.

  • Projeto - O projeto do AEM Screens.

  • Local - Local ao qual o dispositivo está conectado.

  • Canais - Um ou mais canais que estão sendo exibidos no local.

  • Agendar - Se estiver usando um agendamento, verifique se ele foi publicado.

  • Local, Agendamentos e Pasta de Canal - Se os recursos correspondentes estiverem dentro de uma pasta.

Siga as etapas abaixo para verificar o comportamento de criação e publicação:

  1. Atualize parte do conteúdo do canal na instância do Autor.
  2. Execute Gerenciar Publicação para publicar novas alterações em todas as instâncias de Publicação.
  3. Clique em Ativar para habilitar o dispositivo no Gerenciador de Dispositivos.
  4. Selecione Editar URL da URL da instância do autor para uma das URL das instâncias de publicação.
  5. Verifique se o conteúdo do canal atualizado é exibido no AEM Screens Player.
  6. Repita essas etapas usando uma instância de publicação diferente.

Etapa 5: apontar a instância do dispositivo para publicar no Painel de administração step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. Exiba a interface do administrador no Screens Player e pressione o canto superior esquerdo para abrir o menu Administrador no AEM Screens Player habilitado para toque ou usando o mouse.
  2. Clique na opção Configuração no painel lateral.
  3. Altere a instância do Autor para Instância de Publicação no Servidor.

Visualizar as alterações no AEM Screens Player.

Como alternativa, você também pode atualizar/editar o URL do servidor no console de gerenciamento de dispositivos usando as seguintes etapas:

  1. Navegue até o projeto do AEM Screens e clique na pasta Dispositivos.
  2. Clique em Gerenciador de dispositivos na barra de ações.
  3. Clique no dispositivo e, na barra de ações, clique em Editar URL do servidor, conforme mostrado na figura abaixo. Suas alterações se propagam para o AEM Screens Player.

screen_shot_2019-02-07at31028pm

O recurso Manage Publication permite que você forneça atualizações de conteúdo do Autor para a Publicação no dispositivo. Você pode publicar/desfazer a publicação de conteúdo para todo o projeto do AEM Screens ou apenas para um de seus canais, locais, dispositivos, aplicativos ou um agendamento. Para saber mais sobre este recurso, consulte Atualização de conteúdo sob demanda.

Dicas de solução de problemas troubleshoot-tips

Siga a seção abaixo para obter respostas a perguntas frequentes relacionadas à configuração do autor e da publicação.

Como adicionar um redirecionamento de https para http após o registro e a atribuição iniciais? add-redirect

Solução - Defina Proxy/Load Balancer Connection in the Jetty configuration como true.

Como atualizar conteúdo offline e problemas de download do player com ativos fora do /content/dam/projects/<project>? update-offline-content

Solução - Conceda permissões de leitura ao usuário bulk-offline-update-screens-service e ao grupo screens-devices-master para todos os /content/dam ou ativos específicos que deseja usar, caso deseje ser mais restritivo.

Como resolver erros do Screens Replication Agent? replication-agent

Solução - Verifique se você não marcou a opção Usar para replicação reversa na configuração do agente. O agente de replicação Screens não pode ser usado como um agente de replicação reversa e o escopo desse recurso é encaminhar comandos do dispositivo do Autor para a Publicação.

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