Configuração do autor e publicação no AEM Screens

Esta página destaca os seguintes tópicos:

  • Configuração de instâncias de autor e publicação
  • Configuração da topologia de publicação
  • Gerenciar publicação: Fornecer atualizações de conteúdo do autor para publicar no dispositivo

Pré-requisitos

Antes de começar a usar os servidores de criação e publicação, você deve ter conhecimento prévio de:

  • Topologia de AEM
  • Criação e gerenciamento de projeto do AEM Screens
  • Processo de registro do dispositivo
OBSERVAÇÃO

Essa funcionalidade do AEM Screens só estará disponível se você tiver instalado AEM 6.4 Screens Feature Pack 2. Para obter acesso a esse Feature Pack, você deve entrar em contato com o Suporte da Adobe e solicitar acesso. Com as devidas permissões, você pode baixá-lo em Compartilhamento de pacotes.

IMPORTANTE

Se quiser usar mais de uma instância de publicação com o dispatcher, atualize o arquivo dispatcher.any no dispatcher. Consulte Ativar sessões adesivas para obter mais detalhes.

Configuração de instâncias de autor e publicação

OBSERVAÇÃO

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

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

Você pode configurar um exemplo simples, em que hospeda um autor e duas instâncias de publicação:

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

Configurando agentes de replicação no autor

Para criar agentes de replicação, você deve aprender a criar um agente de replicação padrão.

Há 3 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 do Screens
  3. Reverter agente de replicação

Etapa 1: Criando um Agente de Replicação Padrão

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

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

    screen_shot_2019-02-25at24621pm

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

    screen_shot_2019-02-25at24715pm

  3. Selecione o Agentes do autor do 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 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 para abrir o Configurações do agente para inserir os detalhes.

    OBSERVAÇÃO

    O usuário precisa verificar Ativado para ativar o agente de replicação. Você deve marcar essa opção em Default, Screens e Reverse Replication Agents.

    screen_shot_2019-02-25at30134pm

  7. Navegue até o Transportes e insira a URI, Usuário e Senha.

    screen_shot_2019-03-04at34955pm

    OBSERVAÇÃO

    Também é possível copiar e renomear um agente de replicação padrão existente.

Criação de agentes de replicação padrão

  1. Criar agente de replicação padrão para pub1 (o 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 representante 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)

Criação de agentes de replicação do Screens

  1. Crie o agente de replicação do AEM Screens para pub1. Pronto para uso, há um chamado Screens Replication Agent que aponta para a porta 4503. Isso precisa ser ativado.

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

    OBSERVAÇÃO

    Para saber como configurar os agentes de replicação do Screens, consulte Configurando o agente de replicação do Screens.

Criando agentes de replicação inversa do Screens

  1. Criar agente de replicação inversa padrão para pub1.
  2. Criar agente de replicação inversa padrão para pub2. Você pode copiar o agente de representante reverso para pub1 e atualizar o transporte a ser usado para pub2 alterando a porta na configuração de transporte.

Configuração da topologia de publicação

Etapa 1: Configurar a descoberta baseada no Apache Sling Oak

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. Vá até https://<host>:<port>/system/console/configMgr
  2. Selecionar Serviço de Descoberta Baseado em Oak do Apache Sling Configuração.
  3. Atualizar URLs do conector de Topologia: adicione URLs de todas as instâncias de publicação de participação que sejam:
    • https://localhost:4503/libs/sling/topology/connector
    • https://localhost:4504/libs/sling/topology/connector
  4. Lista de permissões do conector de topologia: adaptar a IPs ou sub-redes que abrangem instâncias de publicação de participação
  5. Habilitar Interromper automaticamente loops locais

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

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 do AtiveMQ Artemis

Esta 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 precisam ser idênticos. A senha da configuração do AtiveMQ Artemis precisa 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. A senha criptografada 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://&lt;host&gt;:&lt;port&gt;/system/console/crypto).
  2. Digite a senha de texto simples desejada (mesma para todas as instâncias) em Texto sem formatação
  3. Clique em Protect.
  4. Copie o valor Texto protegido para o bloco de notas ou editor de texto. Esse valor será usado na configuração OSGi para AtiveMQ.

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

OBSERVAÇÃO

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

Etapa 4: Ativar Cluster de Artemis AtiveMQ

Em cada instância de publicação:

  1. Navegue até o Gerenciador de configuração do OSGi https://&lt;host&gt;:&lt;port&gt;/system/console/configMgr

  2. Selecionar Provedor JMS do Apache AtiveMQ Artemis Configuração

  3. Atualize o seguinte:

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

Verificar Cluster de Artemis do AtiveMQ

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

  1. Navegue até Console OSGi -> Principal > Áreas AtiveMQ https://localhost:4505/system/console/mq.

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

  3. Enviar uma mensagem de teste (parte superior da tela, em Informações do agente)

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

    1. Destino: /com.adobe.cq.screens/devTestTopic
    2. Texto: Hello World
    3. Visualize o error.log de cada instância para ver se a mensagem foi enviada e recebida no cluster
OBSERVAÇÃO

Navegar até 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 AtiveMQ Artemis Server.

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

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

Remover requisito de cabeçalho do referenciador

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

  1. Navegue até o Console OSGi > Gerenciador de configuração
  2. Selecionar Filtro de referenciador do Apache Sling
  3. Atualizar a configuração e marcar Permitir vazio

Configuração da instância de autor e publicação

Depois de configurar a topologia de publicação, é necessário configurar as instâncias de autor e publicação para exibir os resultados práticos da implementação:

OBSERVAÇÃO

Pré-requisitos

Para começar a usar este exemplo, crie um novo projeto do AEM Screens seguido de criar um local, exibição e canal no seu projeto. Adicione conteúdo ao canal e atribua o canal a uma exibição.

Etapa 1: Iniciar um reprodutor do AEM Screens (dispositivo)

  1. Inicialize uma janela de navegador separada.
  2. Ir para o player do Screens 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, você perceberá o estado do dispositivo como não registrado.
OBSERVAÇÃO

Você pode abrir um reprodutor do AEM Screens usando o aplicativo AEM Screens baixado ou usando o navegador da Web.

Etapa 2: Registrando um dispositivo no autor

  1. Ir para https://localhost:4502/screens.html/content/screens/we-retail ou selecione o projeto e navegue até Dispositivos > Gerenciador de dispositivos.
  2. Selecionar Registrar dispositivo.
  3. Clique em Registro do dispositivo para exibir o dispositivo.
  4. Selecione o dispositivo que deseja registrar e clique em Registrar dispositivo.
  5. Verifique o código de registro e clique em Validar.
  6. Insira um título para o seu dispositivo e clique em Registrar.

Etapa 3: Atribuição do dispositivo à exibição

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

Verifique o player e você verá o conteúdo adicionado no canal.

Etapa 4: Publicação da configuração do dispositivo para publicar instâncias

Verificando o dispositivo

Antes, execute as etapas abaixo para verificar a ID do dispositivo. Para verificar, procure a ID do dispositivo no CRXDE Lite, com o caminho como /home/users/screens/we-retail/devices.

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

  1. Navegue até a página de administração do usuário (por exemplo: https://localhost:4502/useradmin
  2. Procure a variável screens-devices-principal grupo
  3. Clique com o botão direito no grupo e clique em Ativar
ATENÇÃO

Não ative o author-publish-screens-service, pois ele é um usuário do sistema, usado pelo Trabalho de Autor.

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

  1. Navegue até o projeto do Screens —> Dispositivos.
  2. Clique em Gerenciador de dispositivos na barra de ações.
  3. Selecione o dispositivo e clique em Ativar na barra de ação, como mostrado na figura abaixo.

screen_shot_2019-02-21at11036am

OBSERVAÇÃO

Como alternativa, depois de ativar o dispositivo, você também pode editar ou atualizar o URL do servidor clicando em Editar URL do servidor na barra de ações, como mostrado na figura abaixo, e suas alterações serão propagadas para o player do AEM Screens.

screen_shot_2019-02-21at105527am

Lista de verificação de publicação

Os pontos a seguir resumem a lista Verificação de publicação :

  • Usuário do dispositivo do Screens - Isso é armazenado como um usuário AEM e pode ser ativado de Ferramentas > Segurança > Usuários. O usuário terá o prefixo "telas" com uma sequência de caracteres serializada longa.

  • Projeto - O projeto AEM Screens.

  • Localização - Local ao qual o dispositivo está conectado.

  • Canal(s) - um ou mais canais exibidos no local

  • Agendar - se estiver usando um agendamento, certifique-se de que isso seja publicado

  • Localização, 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/publicação:

  1. Atualizar algum conteúdo de canal na instância do autor
  2. Executar Gerenciar publicação para publicar novas alterações em todas as instâncias de publicação
  3. Press Ativar para ativar o dispositivo de Gerenciador de dispositivos
  4. Editar URL do URL da instância do autor para um dos URL de instâncias de publicação
  5. Verifique se o conteúdo atualizado do canal é exibido no reprodutor do AEM Screens
  6. Repita essas etapas usando uma instância de publicação diferente

Etapa 5: Apontar o dispositivo para publicar a instância no painel de administração

  1. Visualize a interface do usuário do administrador no player do Screens, pressione e segure no canto superior esquerdo para abrir o menu Admin, no player do AEM Screens habilitado para toque ou usando um mouse.
  2. Clique no botão Configuração no painel lateral.
  3. Altere a instância do autor para publicar em Servidor.

Exiba as alterações no seu reprodutor AEM Screens.

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 selecione o Dispositivos pasta.
  2. Clique em Gerenciador de dispositivos na barra de ações.
  3. Selecione o dispositivo e clique em Editar URL do servidor na barra de ações, como mostrado na figura abaixo, e suas alterações serão propagadas para o player do AEM Screens.

screen_shot_2019-02-07at31028pm

O Gerenciar publicação permite que você forneça atualizações de conteúdo do autor para publicar no dispositivo. Você pode publicar/cancelar a publicação de conteúdo para todo o projeto do AEM Screens ou somente para um de seus canais, locais, dispositivos, aplicativos ou agendamentos. Para saber mais sobre esse recurso, consulte Atualização de conteúdo sob demanda.

Dicas de solução de problemas

Siga a seção abaixo para obter respostas para perguntas frequentes relacionadas à configuração de criação/publicação.

Como adicionar um Redirecionamento de https para http após o registro e a atribuição iniciais?

Solução
Definir Ativar Proxy/Load Balancer Connection in the Jetty configuration para true.

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

Solução
Fornecer permissões de leitura para o grupo de serviço em massa offline-update-screens-service e screens-devices-principal para todos /content/dam ou os ativos específicos que deseja usar, se desejar ser mais restritivo.

Como resolver erros do Screens Replication Agent?

Solução
Certifique-se de não ter marcado a opção Use for reverse replication na configuração do agente. O Screens Replication Agent não pode ser usado como um agente de replicação inversa e o escopo desse recurso é encaminhar comandos de dispositivo do autor para publicação.

Nesta página