Déploiement de Communities deploying-communities

Conditions préalables prerequisites

Liste de contrôle d’installation installation-checklist

Pour la plateforme AEM

Pour la fonctionnalité Communities

Dernières versions latest-releases

AEM 6.5 Communities GA inclut le package Communities. Pour en savoir plus sur les mises à jour d’AEM 6.5 Communities, consultez les Notes de mise à jour d’AEM 6.5.

Mises à jour AEM 6.5 aem-updates

À compter de la version 6.4 d’AEM, les mises à jour apportées aux communautés sont fournies dans le cadre d’AEM Cumulative Fix Packs et Service Packs.

Pour les dernières mises à jour d’AEM 6.5, voir Adobe Experience Manager 6.4 Cumulative Fix Packs and Service Packs.

Historique des versions version-history

Comme pour AEM 6.4 et versions ultérieures, les fonctionnalités et correctifs d’AEM Communities font partie des packs de correctifs cumulatifs et des Service Packs d’AEM Communities. Il n’existe donc aucun Feature Pack distinct.

Pilote JDBC pour MySQL jdbc-driver-for-mysql

Une fonctionnalité Communities utilise une base de données MySQL :

  • Pour DSRP : stockage du contenu créé par l’utilisateur

Le connecteur MySQL doit être obtenu et installé séparément.

Les étapes nécessaires sont les suivantes :

  1. Téléchargez l’archive ZIP depuis https://dev.mysql.com/downloads/connector/j/

    • La version doit être >= 5.1.38
  2. Extrayez mysql-connector-java-<version>-bin.jar (lot) de l’archive.

  3. Utilisez la console web pour installer et démarrer le lot :

    • Par exemple, https://localhost:4502/system/console/bundles
    • Sélectionnez Install/Update.
    • Parcourir… pour sélectionner le lot extrait de l’archive ZIP téléchargée
    • Vérifiez que Oracle Corporation's JDBC Driver for MySQLcom.mysql.jdbc est actif et démarrez-le dans le cas contraire (ou vérifiez les journaux).
  4. Si vous effectuez l’installation sur un déploiement existant après la configuration de JDBC, replacez JDBC sur le nouveau connecteur en réenregistrant la configuration JDBC à partir de la console web :

    • Par exemple, https://localhost:4502/system/console/configMgr
    • Localisation de la configuration Day Commons JDBC Connections Pool
    • Sélectionner pour ouvrir
    • Sélectionnez Save.
  5. Répétez les étapes 3 et 4 sur toutes les instances d’auteur et de publication.

Vous trouverez plus d’informations sur l’installation des lots sur la page Console web.

Exemple : offre groupée MySQL Connector installée example-installed-mysql-connector-bundle

connector-bundle

AEM MLS avancés aem-advanced-mls

Pour que la collection SRP (MSRP ou DSRP) prenne en charge la recherche multilingue avancée (MLS), de nouveaux modules externes Solr sont requis en plus d’un schéma personnalisé et d’une configuration Solr. Tous les éléments requis sont compressés dans un fichier ZIP téléchargeable.

Le téléchargement MLS avancé (également appelé phasetwo) est disponible à partir du référentiel d’Adobe :

  • AEM-SOLR-MLS-phasetwo

    Pour obtenir le package MLS avancé, reportez-vous à la section AEM MLS avancé dans la section déploiement de la documentation.

    • Version 1.2.40, 6 avril 2016
    • Téléchargez AEM-SOLR-MLS-phasetwo-1.2.40.zip

Pour plus d’informations sur l’installation, consultez la page Configuration Solr pour SRP.

Packages visibles dans Adobe AEM Cloud

Les liens vers les modules de cette page ne nécessitent aucune instance d’AEM en cours d’exécution, car ils sont destinés au partage de modules sur adobeaemcloud.com. Bien que les packages soient visibles, le bouton Install permet d’installer les packages sur un site hébergé par Adobe. Si vous envisagez d’effectuer l’installation sur une instance d’AEM locale, la sélection de Install entraîne une erreur.

Installation sur une instance d’AEM locale

Pour installer les packages visibles dans adobeaemcloud.com sur une instance d’AEM locale, le package doit d’abord être téléchargé sur un disque local :

  • Sélectionnez l’onglet Assets
  • Sélectionnez télécharger sur le disque

Sur l’instance d’AEM locale, utilisez le gestionnaire de modules (par exemple, https://localhost:4502/crx/packmgr/) pour charger vers le référentiel de modules AEM local.

Vous pouvez également accéder au module à l’aide du partage de modules à partir de l’instance d’AEM locale (par exemple, https://localhost:4502/crx/packageshare/). Le bouton Download est téléchargé vers le référentiel de modules de l’instance AEM locale.

Une fois que vous vous trouvez dans le référentiel de package de l’instance d’AEM locale, utilisez Package Manager pour installer le package.

Pour plus d’informations, consultez la page Utilisation de packages.

Déploiements recommandés recommended-deployments

Dans AEM Communities, un magasin commun est utilisé pour stocker le contenu créé par l’utilisateur et est souvent appelé fournisseur de ressources de stockage (SRP). Le déploiement recommandé se concentre sur le choix d’une option SRP pour le magasin commun.

Le magasin commun prend en charge la modération et l’analyse du contenu créé par l’utilisateur dans l’environnement de publication tout en éliminant la nécessité de réplication du contenu créé par l’utilisateur.

Mise à niveau upgrading

Lors de la mise à niveau vers la plateforme AEM 6.5 à partir des versions précédentes d’AEM, il est important de lire Mise à niveau vers la version 6.5.

Outre la mise à niveau de la plateforme, lisez Mise à niveau vers AEM Communities 6.5 pour en savoir plus sur les modifications apportées aux communautés.

Configurations configurations

Éditeur de Principal primary-publisher

Lorsque le déploiement choisi est une ferme de publication, une instance de publication AEM doit être identifiée comme primary publisher pour les activités qui ne doivent pas se produire sur toutes les instances. Par exemple, les fonctionnalités qui reposent sur notifications ou Adobe Analytics.

Par défaut, la configuration OSGi AEM Communities Publisher Configuration est configurée avec la case à cocher Primary Publisher cochée, de sorte que toutes les instances de publication dans une ferme de publication s’identifient elles-mêmes comme instance principale.

Par conséquent, il est nécessaire de modifier la configuration sur toutes les instances de publication secondaires pour décocher la case Primary Publisher .

primary-publisher

Pour toutes les autres instances de publication (secondaires) dans une ferme de publication :

Agents de réplication sur l’auteur replication-agents-on-author

La réplication est utilisée pour le contenu du site créé dans l’environnement de publication, comme les groupes de communautés, et la gestion des membres et des groupes de membres de l’environnement de création à l’aide du service tunnel.

Pour l’éditeur principal, assurez-vous que la configuration de l’agent de réplication identifie correctement le serveur de publication et l’utilisateur autorisé. L’utilisateur autorisé par défaut, admin,, dispose déjà des autorisations appropriées (est membre de Communities Administrators).

Pour que certains autres utilisateurs disposent des autorisations appropriées, ils doivent être ajoutés en tant que membres au groupe d’utilisateurs administrators (également membre de Communities Administrators).

Il existe deux agents de réplication dans l’environnement de création qui ont besoin que la configuration du transport soit correctement configurée.

  • Accès à la console de réplication sur l’auteur

    • Dans la navigation globale, accédez à Outils > Déploiement > Réplication > Agents sur l’auteur
  • Suivez la même procédure pour les deux agents :

    • Agent par défaut (publication)

    • Agent de réplication inverse (publication inverse)

      1. Sélectionner l’agent

      2. Sélectionnez edit

      3. Sélectionnez l’onglet Transport

      4. S'il ne s'agit pas du port 4503, modifiez l'URI pour spécifier le port correct.

      5. Si ce n'est pas l'utilisateur admin, modifiez les User et Password pour spécifier un membre du groupe d'utilisateurs administrators.

Les images suivantes montrent les résultats du changement de port de 4503 à 6103 en :

Agent par défaut (publication) default-agent-publish

default-agent-publish

Agent de réplication inverse (publication inversée) reverse-replication-agent-publish-reverse

reverse-replication-agent

Service Tunnel sur l’auteur tunnel-service-on-author

Lors de l’utilisation de l’environnement de création pour créer des sites, modifier les propriétés du site ou gérer les membres de la communauté, il est nécessaire d’accéder aux membres (utilisateurs) enregistrés dans l’environnement de publication, et non aux utilisateurs enregistrés dans l’environnement de création.

Le service tunnel fournit cet accès à l’aide de l’agent de réplication sur l’auteur.

Pour activer le service tunnel :

Réplication de la clé de chiffrement replicate-the-crypto-key

Il existe deux fonctionnalités d’AEM Communities qui nécessitent que toutes les instances AEM serveur utilisent les mêmes clés de chiffrement. Il s’agit de Analytics et ASRP.

À partir de la version 6.3 d’AEM, le matériel clé est stocké dans le système de fichiers et ne figure plus dans le référentiel.

Pour copier le matériel clé de l’auteur vers toutes les autres instances, il est nécessaire de :

  • Accédez à l’instance AEM (généralement une instance d’auteur) qui contient le matériel clé à copier.

    • Localisez le lot com.adobe.granite.crypto.file dans le système de fichiers local,
      par exemple,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Le fichier bundle.info identifie le lot
    • Naviguez dans le dossier data,
      par exemple,

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

      • Copiez les fichiers de noeud hmac et principal

  • Pour chaque instance AEM cible

    • Naviguez dans le dossier data,
      par exemple,

      • <publish-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Coller les deux fichiers précédemment copiés

    • Il est nécessaire d’ actualiser le lot Granite Cryptosi l’instance AEM cible est en cours d’exécution.

CAUTION
Si une autre fonctionnalité de sécurité a déjà été configurée basée sur les clés de cryptage, la réplication des clés de cryptage peut endommager la configuration. Pour obtenir de l’aide, contactez l’assistance clientèle.

Réplication du référentiel repository-replication

Il est possible de conserver le matériel clé stocké dans le référentiel, comme c’était le cas pour AEM version 6.2 et antérieure. Spécifiez la propriété système -Dcom.adobe.granite.crypto.file.disable=true au premier démarrage de chaque instance AEM (qui crée le référentiel initial).

NOTE
Vérifiez que l’agent de réplication sur l’auteur est correctement configuré.

Avec le matériel clé stocké dans le référentiel, la manière de répliquer la clé de chiffrement de l’auteur vers d’autres instances est la suivante :

Utilisation de CRXDE Lite :

Actualisation du lot de chiffrement Granite refresh-the-granite-crypto-bundle

  • Sur chaque instance de publication, accédez à la console web

  • Localisez le lot Adobe Granite Crypto Support (com.adobe.granite.crypto)

  • Sélectionnez Actualiser

    granite-crypto

  • Après un moment, une boîte de dialogue Success doit s’afficher :
    Operation completed successfully.

Apache HTTP Server apache-http-server

Si vous utilisez le serveur Apache HTTP, veillez à utiliser le nom de serveur correct pour toutes les entrées pertinentes.

En particulier, veillez à utiliser le nom de serveur correct, et non localhost, dans le RedirectMatch.

Exemple 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

Si vous utilisez un Dispatcher, voir :

Documentation sur les communautés connexes related-communities-documentation

  • Visitez Administration de sites de communautés pour en savoir plus sur la création d’un site de communauté, la configuration de modèles de site de communauté, la modération de contenu de communauté, la gestion des membres et la configuration de la messagerie.

  • Consultez Développement de communautés où vous pouvez en savoir plus sur la structure de composants sociaux (SCF) et la personnalisation des composants et fonctionnalités de communautés.

  • Visitez la page Création de composants de communautés où vous pouvez apprendre à créer et configurer des composants de communautés.

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