Implantação de comunidades

Pré-requisitos

Lista de verificação da instalação

Para a plataforma AEM

Capacidade das Comunidades

Latest Releases

AEM 6.5 Communities GA inclui o pacote Communities. Para saber mais sobre atualizações para AEM 6.5 Comunidades, consulte AEM Notasde versão 6.5.

AEM 6.5 Atualizações

A partir do AEM 6.4, as atualizações nas Comunidades são fornecidas como parte AEM Cumulative Fix Packs e Service Packs.

Para obter as atualizações mais recentes do AEM 6.5, consulte Pacotes de correções cumulativos e Service Packs doAdobe Experience Manager 6.4.

Histórico da versão

Como em AEM 6.4 e mais, os recursos e hotfixes da AEM Communities fazem parte dos pacotes de reparos cumulativos e service packs da AEM Communities. Por conseguinte, não existem pacotes de elementos separados.

Driver JDBC para MySQL

Dois recursos das Comunidades usam um banco de dados MySQL:

  • Para ativação: gravando atividades e alunos 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 em https://dev.mysql.com/downloads/connector/j/

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

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

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

    • Por exemplo, https://localhost:4502/system/console/configMgr
    • Localizar Day Commons JDBC Connections Pool configuração
    • 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 estão disponíveis na página Console da Web.

Exemplo: Pacote do Conector MySQL instalado

maços de produtos químicos

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 de ativação . Pacotes de pontuação compatíveis com AEM 6.5 Comunidades:

Para instalar um pacote SCORM

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

Registro SCORM

Conforme instalado, toda a atividade de ativação é perfeitamente conectada ao console do sistema.

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

Para trabalhar com registros, consulte Trabalhar com registros de auditoria e arquivosde registro.

AEM Advanced MLS

Para a coleção SRP (MSRP ou DSRP) suportar pesquisa multilíngue avançada (MLS), novos plug-ins Solr são necessários além de uma configuração personalizada de schema e Solr. Todos os itens necessários são empacotados em um arquivo zip baixável.

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

Para obter detalhes e informações sobre instalação, consulte Configuração solar para SRP.

Pacotes visíveis na Adobe AEM Cloud

Os links para pacotes nesta página não exigem nenhuma instância em execução de AEM, pois estão para compartilhamento de pacotes adobeaemcloud.com. Enquanto os pacotes estiverem visíveis, o Install botão é para instalar os pacotes em um site hospedado no Adobe. Se você pretende instalar em uma instância AEM local, selecionar Install resultará em um erro.

Como instalar na instância AEM local

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

  • Select the Assets tab
  • Selecionar download em disco

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

Como alternativa, ao acessar o pacote usando o compartilhamento de pacote da instância de AEM local (por exemplo, https://localhost:4502/crx/packageshare/), o Download botão baixará para o repositório de pacotes da instância AEM local.

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

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

No AEM Communities, uma loja comum é usada para armazenar conteúdo gerado pelo usuário (UGC) e é geralmente chamada de provedor de recursos do armazenamento (SRP). A implantação recomendada centra-se na escolha de uma opção SRP para a loja comum.

A loja comum oferece suporte à moderação e análise do UGC no ambiente de publicação, eliminando a necessidade de replicação do UGC.

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

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

Atualização

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

Além de atualizar a plataforma, leia Atualização para o AEM Communities 6.5 para saber mais sobre as mudanças nas Comunidades.

Configurações

Editor principal

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

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

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:

  • Fazer logon com privilégios de administrador

  • Acesse o console da Web

  • Localize a variável AEM Communities Publisher Configuration

  • Selecionar o ícone de edição

  • Desmarque a caixa Editor ​primário

  • Selecione Salvar

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 autor usando o serviço detúnel.

Para o editor principal, verifique se a Configuração do Agente de Replicação 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 administrators usuários (também como membro do Communities Administrators).

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

  • Acesse o console Replicação no autor

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

    • Agente padrão (publicar)

    • Agente de Replicação Reversa (publicar reverso)

      1. Selecione o agente

      2. Select edit

      3. Select the Transport tab

      4. Se não houver porta 4503, edite o URI para especificar a porta correta

      5. Se não for usuário admin, edite Usuário e Senha para especificar um membro do grupo de administrators usuários

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 Reversa (publicar reverso)

chlimage_1-413

Serviço de túnel no autor

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

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

Para ativar o serviço de túnel:

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 AEM, normalmente uma instância do autor, que contém o material principal a ser copiado

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

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

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data

      • Copiar os arquivos hmac e do nó primário

  • Para cada instância AEM público alvo

    • Navegue até a pasta de dados, por exemplo,

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

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

CUIDADO

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

Replicação do repositório

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

  • -Dcom.adobe.granite.crypto.file.disable=true
Observação

É importante verificar se o agente de replicação do 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 o CRXDE Lite:

Atualizar o pacote Cripto Granite

  • Em cada instância de publicação, acesse o Console da Web

  • Localizar Adobe Granite Crypto Support pacote (com.adobe.granite.crypto)

  • Selecionar Atualizar

    chlimage_1-416

  • Depois de um momento, uma caixa de diálogo Êxito deve ser exibida:
    Operation completed successfully.

Apache HTTP Server

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.

httpd.conf exemplo

<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:

  • Visite Administrando sites de comunidades para saber mais sobre como criar um site da comunidade, configurar modelos de site da comunidade, moderar o conteúdo da comunidade, gerenciar membros e configurar mensagens.

  • Visite Comunidades em desenvolvimento para saber mais sobre a estrutura de componentes sociais (SCF) e como personalizar componentes e recursos das Comunidades.

  • Visite Componentes de comunidades de criação para saber como criar e configurar componentes de Comunidades.

Nesta página