Implantação de comunidades deploying-communities

Pré-requisitos prerequisites

Lista de verificação de instalação installation-checklist

Para a plataforma AEM

Para o recurso Comunidades

Versões mais recentes latest-releases

O AEM 6.5 Communities GA inclui o pacote Communities. Para saber mais sobre atualizações no AEM 6.5 Comunidades, consulte as Notas de versão do AEM 6.5.

Atualizações do AEM 6.5 aem-updates

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

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

Histórico da versão version-history

Assim como no AEM 6.4 e posteriores, os recursos e hotfixes do AEM Communities fazem parte dos cumulative fix packs e service packs da AEM Communities. Portanto, não há pacotes de recursos separados.

Driver JDBC para MySQL jdbc-driver-for-mysql

O recurso One Communities usa um banco de dados MySQL:

  • Para DSRP: armazenando 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, 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, caso contrário, inicie-o (ou verifique os logs)
  4. Se estiver instalando em uma implantação existente após a configuração do JDBC, vincule novamente o JDBC ao novo conector, salvando novamente a configuração do JDBC no console da Web:

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

Exemplo: conjunto de conectores MySQL instalado example-installed-mysql-connector-bundle

conjunto de conectores

MLS avançado para AEM aem-advanced-mls

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

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

  • AEM-SOLR-MLS-phasetwo

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

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

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

Pacotes Visíveis na Nuvem do Adobe AEM

Os links para pacotes nesta página não exigem instância em execução do AEM, pois são necessários para o Compartilhamento de Pacotes em adobeaemcloud.com. Enquanto os pacotes estiverem visíveis, o botão Install será usado para instalar os pacotes em um site hospedado em Adobe. Se você pretende instalar o em uma instância de AEM local, selecionar Install resultará em um erro.

Como instalar em uma instância de AEM local

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

  • Selecione a guia Assets
  • Selecione baixar para disco

Na instância local do AEM, use o Gerenciador de Pacotes (por exemplo, https://localhost:4502/crx/packmgr/) para carregar no repositório de pacotes locais do AEM.

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

Quando estiver no repositório de pacotes da instância local do AEM, use o Gerenciador de pacotes para instalar o pacote.

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

Implantações recomendadas recommended-deployments

No AEM Communities, um armazenamento comum é usado para armazenar UGC e geralmente é chamado de provedor de recursos de armazenamento (SRP). A implantação recomendada se concentra na escolha de uma opção SRP para o armazenamento comum.

O repositório comum oferece suporte à moderação e análise de UGC no ambiente de publicação, eliminando a necessidade de replicação de UGC.

Atualizando upgrading

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

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

Configurações configurations

Editor primário primary-publisher

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

Por padrão, a configuração OSGi AEM Communities Publisher Configuration é 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 primárias.

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.

editor-primário

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

Agentes de replicação no autor replication-agents-on-author

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

Para o publicador 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 do grupo de usuários administrators (também como membro de Communities Administrators).

Há dois agentes de replicação no ambiente de autor que precisam da configuração de transporte para serem configurados corretamente.

  • Acessar 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 (publicação)

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

      1. Selecione o agente

      2. Selecionar editar

      3. Selecione a guia Transporte

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

      5. Se não for usuário admin, edite o Usuário e a 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 (publicação) default-agent-publish

default-agent-publish

Reverter agente de replicação (publicar reverso) reverse-replication-agent-publish-reverse

agente-replicação-reversa

Serviço de Túnel no Autor tunnel-service-on-author

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 no autor.

Para habilitar o serviço de túnel:

Replicar a chave de criptografia replicate-the-crypto-key

Há dois recursos do AEM Communities que exigem que todas as instâncias do servidor AEM usem as mesmas chaves de criptografia. Estes 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

    • Localizar 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 identifica o pacote
    • Navegue 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 de AEM de destino

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

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

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

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

Replicação do repositório repository-replication

Ter o material principal armazenado no repositório, como foi o caso do AEM 6.2 e anterior, pode ser preservado. Especifique a propriedade do sistema -Dcom.adobe.granite.crypto.file.disable=true na primeira inicialização de cada instância do AEM (que cria o repositório inicial).

NOTE
Verifique 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 criptográfica do autor para outras instâncias é a seguinte:

Usando CRXDE Lite:

Atualizar o pacote de criptografia do Granite refresh-the-granite-crypto-bundle

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

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

  • Selecionar Atualizar

    granite-crypto

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

Apache HTTP Server 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 de servidor correto, não localhost, no RedirectMatch.

exemplo de httpd.conf httpd-conf-sample

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

Se estiver usando uma Dispatcher, consulte:

Documentação de comunidades relacionadas related-communities-documentation

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791