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 d’AEM 6.5 aem-updates

À partir d’AEM 6.4, les mises à jour apportées aux communautés sont fournies dans le cadre des packs de correctifs cumulés et de services d’AEM.

Pour connaître les dernières mises à jour d’AEM 6.5, voir Packs de correctifs cumulés et packs de services Adobe Experience Manager 6.4.

Historique des versions version-history

Comme pour AEM 6.4 et les versions ultérieures, les fonctionnalités et correctifs AEM Communities font partie des packs de correctifs cumulatifs et de services d’AEM Communities. Il n’existe donc pas de pack de fonctionnalités distinct.

Pilote JDBC pour MySQL jdbc-driver-for-mysql

Une fonctionnalité de 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 🔗

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

    • Par exemple, :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 le pilote JDBC de Oracle Corporation pour 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, reliez JDBC au nouveau connecteur en réenregistrant la configuration JDBC à partir de la console web :

    • Par exemple, :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 de création et de publication

Pour plus d’informations sur l’installation des lots, consultez la page Console web.

Exemple : MySQL Connector Bundle installé example-installed-mysql-connector-bundle

lot-connecteur

MLS avancés d’AEM aem-advanced-mls

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

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

  • AEM-SOLR-MLS-phasetwo

    Pour obtenir le package MLS avancé, consultez MLS avancé ​ dans la section de déploiement de la documentation.

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

Pour plus d’informations et des informations d’installation, consultez Configuration Solr pour SRP.

Packages visibles dans Adobe AEM Cloud

Les liens vers les packages de cette page ne nécessitent aucune instance AEM en cours d’exécution, comme ils le font vers le partage de packages 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 de l’installer sur une instance AEM locale, la sélection de Install entraîne une erreur.

Installation sur une instance AEM locale

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

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

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

Sinon, pour accéder au package à l’aide du partage de packages à partir de l’instance AEM locale (par exemple, https://localhost:4502/crx/packageshare/), le bouton Download est téléchargé dans le référentiel de packages de l’instance AEM locale.

Une fois dans le référentiel de packages de l’instance AEM locale, utilisez le gestionnaire de packages pour installer le package.

Pour plus d’informations, consultez Utilisation de packages.

Dans AEM Communities, un magasin commun est utilisé pour stocker le contenu créé par l’utilisateur. Il est souvent appelé ​ fournisseur de ressources de stockage (SRP). Le déploiement recommandé est axé 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 de versions précédentes d’AEM, il est important de lire la section Mise à niveau vers AEM 6.5.

Outre la mise à niveau de la plateforme, lisez Mise à niveau vers AEM Communities 6.5 pour en savoir plus sur les modifications de Communities.

Configurations configurations

Principal Publisher 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 activée, de sorte que toutes les instances de publication d’une batterie de publication s’identifient comme étant les instances principales.

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.

principal-éditeur

Pour toutes les autres instances de publication (secondaires) d’une batterie de publication :

  • Connexion avec des droits d’administrateur

  • Accéder à la console web

  • Localiser le AEM Communities Publisher Configuration

  • Sélectionnez l’icône Modifier .

  • Décochez la case Éditeur de Principal

  • Sélectionnez Enregistrer.

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, tel que les groupes de communautés, et pour la gestion des membres et des groupes de membres à partir 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 qu’un autre utilisateur dispose des autorisations appropriées, il doit être ajouté en tant que membre du groupe d’utilisateurs administrators (également membre de Communities Administrators).

Deux agents de réplication de l’environnement de création nécessitent que la configuration du transfert soit correcte.

  • Accès à la console de réplication en mode de création

    • 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 modifier

      3. Sélectionnez l’onglet Transport

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

      5. S’il ne s’agit pas d’un admin utilisateur, modifiez les Utilisateur et Mot de passe pour spécifier un membre du groupe d’utilisateurs administrators

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

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

default-agent-publish

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

reverse-replication-agent

Service de tunnel en mode de création 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 de tunnel fournit cet accès à l’aide de l’agent de réplication sur l’auteur.

Pour activer le service de tunnel :

  • Connectez-vous avec des droits d’administrateur sur votre instance d’auteur.

  • Si l’éditeur n’est pas localhost:4503 ou si l’utilisateur de transfert n’est pas admin,
    puis configurez l’agent de réplication

  • Accédez à la console web

  • Localiser le AEM Communities Publish Tunnel Service

  • Sélectionnez l’icône Modifier .

  • Cochez la case activer

  • Sélectionnez Enregistrer.

    service-tunnel

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

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

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

Pour copier le contenu clé de l’instance de création 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 essentiel à 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
    • Accédez au dossier de données,
      par exemple,

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

      • Copiez les fichiers des nœuds principaux et hmac

  • Pour chaque instance AEM cible

    • Accédez au dossier de données,
      par exemple,

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

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

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

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

Le fait que le matériel de base soit stocké dans le référentiel, comme c’était le cas pour AEM 6.2 et les versions antérieures, peut être préservé. Spécifiez la propriété système -Dcom.adobe.granite.crypto.file.disable=true au premier démarrage de chaque instance AEM (ce 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 de 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 🔗 :

Actualisez le lot de chiffrement Granite refresh-the-granite-crypto-bundle

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

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

  • Sélectionnez Actualiser

    granite-crypto

  • Au bout d’un moment, une boîte de dialogue Succès s’affiche :
    Operation completed successfully.

Serveur HTTP Apache apache-http-server

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

Veillez en particulier à 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 :

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

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

  • Consultez Création de composants de communautés où vous pouvez apprendre à créer avec des composants de communautés et à les configurer.

recommendation-more-help
experience-manager-65-help-communities