Implantação de comunidades

Pré-requisitos

Lista de verificação da instalação

Para a plataforma AEM

Para o recurso Comunidades

Versões mais recentes

AEM 6.4 Communities GA inclui o pacote Communities. Para saber mais sobre atualizações para AEM 6.4 Communities, consulte AEM Notas de versão 6.4.

Atualizações do AEM 6.4

A partir do AEM 6.3, as atualizações nas Comunidades são fornecidas como parte AEM Pacotes de correções cumulativas e Service Packs.

Para obter as atualizações mais recentes do AEM 6.4, verifique Adobe Experience Manager 6.4 Cumulative Fix Packs and Service Packs.

Histórico da versão

Como em AEM 6.4 e mais, os recursos e hotfixes do AEM Communities fazem parte dos fix packs cumulativos do AEM Communities e service packs. Portanto, não há pacotes de recursos separados.

Driver JDBC para MySQL

Dois recursos do Communities usam um banco de dados MySQL :

  • Para ativação: registrando atividades e aprendentes do SCORM
  • Para DSRP: armazenamento de conteúdo gerado pelo usuário (UGC)

O conector MySQL deve ser obtido e instalado separadamente.

As etapas necessárias são:

  1. Baixe o arquivo ZIP de https://dev.mysql.com/downloads/connector/j/

    • A versão deve ser >= 5.1.38
  2. Extraia mysql-connector-java-<version>-bin.jar (pacote) do arquivo

  3. Use o console da Web para instalar e iniciar o pacote:

    • Por exemplo, http://localhost:4502/system/console/bundles
    • Selecionar Install/Update
    • Navegue… para selecionar o pacote extraído do arquivo ZIP baixado
    • Verifique se Driver JDBC da Oracle Corporation para MySQLcom.mysql.jdbc está ativo e inicie-o se não estiver (ou verifique os logs)
  4. Se a instalação for feita em uma implantação existente depois que o JDBC tiver sido configurado, refaça o JDBC para o novo conector, salvando a configuração do JDBC no console da Web:

    • Por exemplo, http://localhost:4502/system/console/configMgr
    • Localizar configuração Day Commons JDBC Connections Pool
    • Selecione para abrir
    • Selecionar Save
  5. Repita as etapas 3 e 4 em todas as instâncias de autor e publicação

Mais informações sobre a instalação de pacotes podem ser encontradas na página Console da Web.

Exemplo: Pacote do Conector MySQL Instalado

chlimage_1-410

Pacote SCORM

O Shareable Content Object Reference Model (SCORM) é uma coleção de padrões e especificações para e-learning. O SCORM também define como o conteúdo pode ser empacotado em um arquivo ZIP transferível.

O mecanismo AEM Communities SCORM é necessário para o recurso enablement. Os pacotes de pontuação compatíveis com a versão do AEM Communities 6.4 são:

Para uma nova instalação do mecanismo SCORM, o pacote contendo SCORM 2017.1 (que é cq -social-scorm -package, versão 2.2.2) deve ser usado. Para que você possa reproduzir recursos de aprendizagem apoiados pelo SCORM 2017.

Para instalar um pacote SCORM pela primeira vez

  1. Instale o cq-social-scorm-package, versão 2.2.2.
  2. Baixe /libs/social/config/scorm/database_scormengine_data.sql da instância do cq e execute-a no servidor mysql para criar um esquema scormEngineDB atualizado.
  3. Adicione /content/communities/scorm/RecordResults na propriedade Caminhos excluídos no filtro CSRF de https://<hostname>;:<port>/system/console/configMgr em editores.

As instalações existentes do SCORM podem ser atualizadas para cq-social-scorm-package, versão 2.2.2 (que usa SCORM 2017.1), se o conteúdo do curso criado exigir o SCORM 2017.1.

OBSERVAÇÃO

A atualização para o pacote SCORM 2017.1 requer a migração do banco de dados existente (conforme explicado mais adiante).

Para atualizar a versão do seu mecanismo SCORM

  1. Faça um backup do esquema ScormEngineDB.

  2. Instale o cq-social-scorm-package, versão 2.2.2.

  3. Baixe o pacote de /libs/social/config/scorm/ScormEngine.zip e extraia o mesmo.

  4. Vá para a pasta Instalador do diretório extraído.

  5. Atualize SystemDatabaseConnectionString com seu scorm db connection url no arquivo EngineInstall.xml.

  6. Execute a ferramenta de atualização do esquema mysql na pasta Instalador com o comando:

    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml

  7. Monitore o arquivo engine_upgrade.log para qualquer tipo de erro e status de atualização do schema.

  8. Adicione /content/communities/scorm/RecordResults na propriedade Caminhos excluídos no filtro CSRF de https://<hostname>:<port>/system/console/configMgr em editores.

Registro de SCORM

Conforme instalado, todas as atividades de ativação são registradas no console do sistema.

Se desejar, o nível de log pode ser definido como AVISO para o pacote RusticiSoftware.*.

Para trabalhar com logs, consulte Trabalhar com registros de auditoria e arquivos de log.

AEM MLS avançado

Para que a coleção SRP (MSRP ou DSRP) ofereça suporte a pesquisa multilíngue avançada (MLS), são necessários novos plug-ins Solr além de um esquema personalizado e uma configuração Solr. Todos os itens necessários são empacotados em um arquivo zip que pode ser baixado.

O download MLS avançado (também conhecido como "phasetwo") está disponível no repositório do Adobe:

  • AEM-SOLR-MLS-phasetwo

    Para obter o pacote MLS avançado, consulte AEM MLS avançado na seção de implantação da documentação.

    • Versão 1.2.40, 6 de abril de 2016
    • Baixar AEM-SOLR-MLS-phasetwo-1.2.40.zip

Para obter detalhes e informações de instalação, visite Configuração Solr para SRP.

Pacotes visíveis no Adobe AEM Cloud

Os links para pacotes nesta página não exigem nenhuma instância em execução do AEM, pois são para compartilhar pacotes em adobeaemcloud.com. Embora os pacotes possam ser visualizados, o botão Installé para instalar os pacotes em um site Adobe hospedado. Se você quiser instalar em uma instância de AEM local, selecionar Installresultará em um erro.

Como instalar na instância de AEM local

Para instalar os pacotes visíveis em adobeaemcloud.com em uma instância de AEM local, o pacote deve ser baixado primeiro em um disco local:

  • Selecione a guia Assets
  • Selecione transferir para o disco

Na instância de AEM local, use o gerenciador de pacotes (por exemplo http://localhost:4502/crx/packmgr/), para fazer upload para o repositório de pacotes AEM local.

Como alternativa, acessando o pacote usando o compartilhamento de pacote da instância de AEM local (por exemplo, http://localhost:4502/crx/packageshare/), o botão Downloadserá baixado para o repositório de pacotes da instância de AEM local.

Uma vez no repositório de pacotes da instância de AEM local, use o gerenciador de pacotes para instalar o pacote.

Para obter mais informações, visite Como trabalhar com pacotes.

No AEM Communities, uma loja comum é usada para armazenar conteúdo gerado pelo usuário (UGC) e geralmente é chamada de storage resource provider (SRP). Os centros de implantação recomendados escolhem uma opção SRP para a loja comum.

A loja comum oferece suporte à moderação e ao analytics no UGC no ambiente de publicação, ao mesmo tempo em que elimina a necessidade de replicação do UGC.

  • Armazenamento de conteúdo da comunidade: discute as opções de armazenamento de SRP para comunidades AEM

  • Topologias recomendadas: discute a topologia a ser usada, dependendo do caso de uso e da escolha da SRP

Atualização

Ao atualizar para a plataforma do AEM 6.4 a partir de versões anteriores do AEM, é importante ler Atualização para o AEM 6.4.

Além de atualizar a plataforma, leia Atualização para o AEM Communities 6.4 para saber mais sobre as alterações do Communities.

Configurações

Editor principal

Quando a implantação escolhida é um publish farm, uma instância de publicação AEM deve ser identificada como o primary publisher para atividades que não devem ocorrer em todas as instâncias, como recursos que dependem de notificações ou Adobe Analytics.

Por padrão, a configuração AEM Communities Publisher Configuration OSGi é configurada com a caixa de seleção Primary Publisher marcada, de modo que todas as instâncias de publicação em um farm de publicação se autoidentifiquem como a primária.

Portanto, é necessário editar a configuração em todas as instâncias de publicação secundárias para desmarcar a caixa de seleção Primary Publisher.

chlimage_1-411

Para todas as outras instâncias de publicação (secundárias) em um farm de publicação:

Agentes de Replicação no Autor

A replicação é usada para o conteúdo do site criado no ambiente de publicação, como grupos da comunidade, bem como para gerenciar membros e grupos de membros do ambiente de criação usando o túnel service.

Para o editor principal, verifique se o Replication Agent Config identifica corretamente o servidor de publicação e o usuário autorizado. O usuário autorizado padrão, admin, já tem as permissões apropriadas (é membro de Communities Administrators).

Para que outro usuário tenha as permissões apropriadas, ele deve ser adicionado como membro ao grupo de usuários administrators (também membro de Communities Administrators).

Há dois agentes de replicação no ambiente de criação que precisam que a configuração de transporte seja configurada corretamente.

  • Acesse o console Replicação no autor

    • Na navegação global: Ferramentas > Implantação > Replicação > Agentes no autor
  • Siga o mesmo procedimento para ambos os agentes:

    • Agente padrão (publicar)

    • Agente de replicação inversa (publicar inverso)

      1. Selecione o agente
      2. Selecione editar
      3. Selecione a guia Transporte
      4. Se não a porta 4503, edite o URI para especificar a porta correta
      5. Se não for o usuário admin, edite as Usuário e Senha para especificar um membro do grupo de usuários administrators

As imagens a seguir mostram os resultados da alteração da porta de 4503 para 6103 por:

Agente padrão (publicar)

chlimage_1-412

Agente de replicação inversa (publicar inverso)

chlimage_1-413

Serviço de Túnel no Autor

Ao usar o ambiente de criação para criar sites, modificar propriedades do site ou gerenciar membros da comunidade, é necessário acessar membros (usuários) registrados no ambiente de publicação, não usuários registrados no autor.

O serviço de túnel fornece esse acesso usando o agente de replicação do autor.

Para habilitar o serviço de túnel:

chlimage_1-414

Replicar a chave de criptografia

Há dois recursos do AEM Communities que exigem que todas as instâncias do servidor AEM usem as mesmas chaves de criptografia. Esses são Analytics e ASRP.

A partir do AEM 6.3, o material principal é armazenado no sistema de arquivos e não mais no repositório.

Para copiar o material principal do autor para todas as outras instâncias, é necessário:

  • Acesse a instância do AEM, normalmente uma instância do autor, que contém o material principal a ser copiado

    • Localize o pacote com.adobe.granite.crypto.file no sistema de arquivos local

      Por exemplo,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • O arquivo bundle.info identificará o pacote
    • Navegar até a pasta de dados

      Por exemplo,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Copie os arquivos hmac e do nó primário

  • Para cada instância do AEM do target

    • Navegar até a pasta de dados

      Por exemplo,

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Cole os 2 arquivos copiados anteriormente

    • É necessário atualizar o pacote do Granite Crypto se a instância do AEM de destino estiver em execução no momento

ATENÇÃO

Se já tiver sido configurado outro recurso de segurança baseado nas chaves de criptografia, a replicação das chaves de criptografia poderá danificar a configuração. Para obter ajuda, entre em contato com o atendimento ao cliente.

Replicação de Repositório

Ter o material principal armazenado no repositório, como era o caso da AEM 6.2 e anterior, pode ser preservado especificando a seguinte propriedade do sistema na primeira inicialização de cada instância de AEM (que cria o repositório inicial):

  • -Dcom.adobe.granite.crypto.file.disable=true
OBSERVAÇÃO

É importante verificar se o agente de replicação no autor está configurado corretamente.

Com o material principal armazenado no repositório, a maneira de replicar a chave de criptografia do autor para outras instâncias é a seguinte:

Usando CRXDE Lite:

chlimage_1-415

Atualizar o pacote do Granite Crypto

chlimage_1-416

  • Após um momento, uma caixa de diálogo Sucesso deve aparecer:

    Operation completed successfully.

Servidor HTTP Apache

Se estiver usando o servidor HTTP Apache, certifique-se de usar o nome correto do servidor para todas as entradas relevantes.

Em particular, tenha cuidado para usar o nome correto do servidor, não localhost, no RedirectMatch.

exemplo de httpd.conf

<IfModule alias_module>
     # XAMPP does not have a favicon; this prevents any 404 errors which may arise.
     Redirect 404 /favicon.ico
     <Location /favicon.ico>
         ErrorDocument 404 "No favicon"
     </Location>

    # Return from "Sign Out" generates response header directing you to "/", generating a 404 error
    # The RedirectMatch resolves it correctly when modified for the target Community Site:
    RedirectMatch ^/$ https://[server name]/content/sites/engage/en.html
 ...
 </IfModule>

Dispatcher

Se estiver usando um Dispatcher, consulte:

Nesta página