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
  • Gerenciando a publicação: Fornecer atualizações de conteúdo do autor para o dispositivo

Pré-requisitos

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

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

Esta funcionalidade do AEM Screens só estará disponível se você tiver instalado AEM 6.4 Screens 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 dispatcher.any arquivo no seu dispatcher. Consulte Ativando Sessões Aderentes para obter mais detalhes.

Configurando instâncias de autor e publicação

OBSERVAÇÃO

Para saber mais sobre o autor e publicar a visão geral da arquitetura e como o conteúdo é criado em uma instância do autor AEM e, em seguida, replicado para várias instâncias de publicação, consulte Visão geral da arquitetura do autor 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, no qual você hospeda um autor e duas instâncias de publicação:

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

Configuração de 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á 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. Screens Replication Agent
  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 AEM —> ícone de martelo —> Operações —> Configuração.

    screen_shot_2019-02-25at24621pm

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

    screen_shot_2019-02-25at24715pm

  3. Selecione Agentes no autor na pasta Replicação e clique em Novo para criar um novo agente de replicação padrão.

    screen_shot_2019-02-25at25400pm

  4. Insira Title 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 a caixa de diálogo Configurações do Agente para inserir os detalhes.

    OBSERVAÇÃO

    O usuário precisa marcar Enabled para habilitar 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é a guia Transporte e digite 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.

Criando Agentes de Replicação Padrão

  1. Criar agente de replicação padrão para pub1 (o agente padrão predefinido já deve estar configurado) (por exemplo, https://<nome do host>:4503/bin/receive?sling:authRequestLogin=1)
  2. Criar agente de replicação padrão para pub2. Você pode copiar o agente rep para pub1 e atualizar o transporte a ser usado para pub2 alterando a porta na configuração de transporte. (por exemplo, https://<nome do host>:4504/bin/receive?sling:authRequestLogin=1)

Criando Agentes de Replicação de Telas

  1. Criar agente de replicação AEM Screens para pub1. Completo, há um chamado Screens Replication Agent que aponta para a porta 4503. Isso precisa ser habilitado.
  2. Criar agente de replicação AEM Screens para pub2. Copie o agente de replicação Screens para pub1 e altere a porta para 4504 para pub2.

Criando Agentes de Replicação Inversa de Telas

  1. Criar agente de replicação reversa padrão para pub1.
  2. Criar agente de replicação reversa 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 Descoberta Baseada em Oak do Apache Sling

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. Selecione Configuração Apache Sling Oak-Based Discovery Service.
  3. Atualizar URLs do conector de topologia: adicionar 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 da 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 Parar 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 de Artemis do AtiveMQ

Esta etapa permite que você crie 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 string de senha criptografada. Em seguida, a senha criptografada será usada na configuração OSGi para AtiveMQ.

Em cada instância de publicação:

  1. No console OSGi, navegue até MAIN —> Suporte de criptografia (https://&lt;host&gt;:&lt;port&gt;/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 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 de pub e salvar a chave exclusiva para a próxima configuração.

OBSERVAÇÃO

A senha deve ser start e terminar com chaves. Por exemplo:
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

Etapa 4: Ativar o Cluster AtiveMQ Artemis

Em cada instância de publicação:

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

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

  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}

Verifique o cluster AtiveMQ Artemis

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 visualização 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. Digite as seguintes alterações nos campos:

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

Navegar no console OSGi pode levar alguns segundos depois de salvar a configuração na etapa anterior. Você também pode verificar 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, navegue até /system/console/mq e clique em Reiniciar para reiniciar o broker.

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

Remover requisito de cabeçalho de quem indicou

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

  1. Navegue até Console OSGi > Configuration Manager
  2. Selecione Filtro de Quem indicou Apache Sling
  3. Atualizar configuração e marcar Permitir vazio

Configurando a 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 visualização dos 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 criação de um local, exibição e canal no seu projeto. Adicione conteúdo ao seu canal e atribua o canal a uma exibição.

Etapa 1: Iniciar um AEM Screens Player (dispositivo)

  1. Inicialize uma janela de navegador separada.
  2. Vá 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 AEM Screens player usando o aplicativo AEM Screens baixado ou usando o navegador da Web.

Etapa 2: Registrando um dispositivo no autor

  1. Vá para https://localhost:4502/screens.html/content/screens/we-retail ou selecione seu projeto e navegue até Dispositivos > Gerenciador de dispositivos.
  2. Selecione Registrar dispositivo.
  3. Clique em Device Registration para visualização 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 seu dispositivo e clique em Register.

Etapa 3: Atribuindo o dispositivo à exibição

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

Verifique seu player e você verá o conteúdo que você adicionou ao seu canal.

Etapa 4: Configuração do dispositivo de publicação para publicar instâncias

Verificação do 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 pelo grupo screens-devices-principal
  3. Clique com o botão direito do mouse no grupo e clique em Ativar
CUIDADO

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

Você também pode ativar o dispositivo a partir do 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, conforme 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ção, 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 de verificação de publicação:

  • Screens Device User - é armazenado como um usuário AEM e deve ser ativado em Ferramentas > Segurança > Usuários. O usuário receberá o prefixo "telas" com uma string serializada longa.

  • Projeto - O projeto da AEM Screens.

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

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

  • Agendamento - se estiver usando um agendamento, verifique se isso foi publicado

  • Localização, Agendamentos e Pasta de Canais - se os recursos correspondentes estiverem dentro de uma pasta.

Siga as etapas abaixo para verificar o comportamento de autor/publicação:

  1. Atualizar algum conteúdo de 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. Pressione Ativar para ativar o dispositivo a partir de Gerenciador de dispositivos
  4. Editar o 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 AEM Screens player
  6. Repita essas etapas usando uma instância de publicação diferente

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

  1. Visualização a interface do usuário do administrador no player do Screens, mantenha pressionada a tecla no canto superior esquerdo para abrir o menu Admin, no AEM Screens player habilitado para toque ou usando um mouse.
  2. Clique na opção Configuração no painel lateral.
  3. Altere a instância do autor para publicar a instância em Server.

Visualização 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 selecione a pasta Dispositivos.
  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ção, conforme mostrado na figura abaixo, e suas alterações serão propagadas para o AEM Screens player.

screen_shot_2019-02-07at31028pm

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

Nesta página