Déploiement de Communities

Conditions préalables

Liste de contrôle d'installation

Pour la plateforme AEM

Pour la fonctionnalité Communautés

Dernières versions

aem 6.5 Communities GA inclut le package Communities. Pour en savoir plus sur les mises à jour apportées à AEM 6.5 Communautés, consultez AEM Notes de mise à jour 6.5.

Mises à jour d’AEM 6.5

À partir de AEM 6.4, les mises à jour apportées aux communautés sont fournies dans le cadre des Fix Packs et Service Packs cumulatifs AEM.

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

Historique des versions

Comme pour AEM 6.4 et les versions ultérieures, les fonctionnalités et correctifs AEM Communities font partie des packs de correctifs et Service Packs AEM Communities cumulatifs. Il n'y a donc pas de fonctionnalités distinctes.

Pilote JDBC pour MySQL

Deux fonctionnalités Communities utilisent une base de données MySQL :

  • Pour activation : enregistrement des activités et des apprenants SCORM
  • Pour DSRP : stockage du contenu généré par l’utilisateur (UGC)

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 à l’adresse https://dev.mysql.com/downloads/connector/j/.

    • La version doit être >= 5.1.38

  2. Extraire mysql-connector-java-<version>-bin.jar (bundle) de l'archive

  3. Utilisez la console Web pour installer et début le lot :

    • Par exemple, https://localhost:4502/system/console/bundles
    • Sélectionner 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 principal et début-le s'il ne l'est pas (ou vérifiez les journaux).

  4. Si vous effectuez l’installation sur un déploiement existant après la configuration de JDBC, regroupez JDBC sur le nouveau connecteur en réenregistrant la configuration JDBC à partir de la console Web :

    • Par exemple, https://localhost:4502/system/console/configMgr
    • Localiser la configuration Day Commons JDBC Connections Pool
    • Sélectionner pour ouvrir
    • Sélectionner Save

  5. Répétez les étapes 3 et 4 sur toutes les instances d’auteur et de publication.

Pour plus d'informations sur l'installation des lots, consultez la page Console Web.

Exemple : Bundle MySQL Connectorinstallé

connecteur-lot

Package SCORM

SCORM (Shareable Content Object Reference Model) est un ensemble de normes et de spécifications pour l'apprentissage en ligne. SCORM définit également comment le contenu peut être inclus dans un fichier ZIP transférable.

Le moteur AEM Communities SCORM est requis pour la fonction activation. Packages Scorm pris en charge sur AEM 6.5 Communautés :

Pour installer un pack SCORM

  1. Installez le package cq-social-scorm-package, version 2.3.7 à partir du partage de package.
  2. Téléchargez /libs/social/config/scorm/database_scormengine_data.sql depuis l'instance cq et exécutez-la dans mysql server pour créer un schéma scormEngineDB mis à niveau.
  3. Ajoutez /content/communities/scorm/RecordResults dans la propriété Chemins exclus dans le filtre CSRF de https://<hostname>:<port>/system/console/configMgr sur les éditeurs.

Journalisation SCORM

Au fur et à mesure de l'installation, toute activité d'activation est généreusement consignée dans la console système.

Si vous le souhaitez, le niveau de journal peut être défini sur WARN pour le package RusticiSoftware.*.

Pour utiliser les journaux, voir Utilisation des enregistrements d'audit et des fichiers journaux.

aem MLS avancé

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

Pour plus d'informations sur l'installation et les détails, consultez la section Configuration du serveur pour SRP.

Packages visibles dans Adobe AEM Cloud

Les liens vers les packages sur cette page ne nécessitent aucune instance d’AEM en cours d’exécution, car ils sont destinés au partage de packages sur adobeaemcloud.com. Bien que les packages puissent être consultés, le bouton Install permet d'installer les packages sur un site hébergé par un Adobe. Si vous prévoyez d’installer sur une instance d’AEM locale, la sélection de Install provoquera une erreur.

Installation sur une instance 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 Ressources
  • Sélectionnez télécharger sur le disque

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

Vous pouvez également accéder au package à l’aide du partage de package à partir de l’instance AEM locale (par exemple, https://localhost:4502/crx/packageshare/). Le bouton Download sera 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 Package Manager pour installer le package.

Pour plus d'informations, consultez Comment utiliser les packages.

En AEM Communities, un magasin commun est utilisé pour stocker le contenu généré par l’utilisateur (UGC) et est souvent appelé le fournisseur de ressources d’enregistrement (SRP). Le déploiement recommandé se concentre sur le choix d’une option SRP pour la boutique commune.

Le magasin commun prend en charge la modération et l’analyse de l’UGC dans l’environnement de publication tout en éliminant le besoin de réplication de l’UGC.

  • Community Content Store : présente les options d'enregistrement du PSR pour les communautés AEM

  • Topologies recommandées : décrit la topologie à utiliser en fonction du cas d'utilisation et du choix SRP

Mise à niveau

Lors de la mise à niveau vers la plate-forme AEM 6.5 à partir des versions précédentes d'AEM, il est important de lire Mise à niveau vers l' 6.5.

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

Configurations

Éditeur Principal

Lorsque le déploiement choisi est une batterie 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, telles que les fonctionnalités qui reposent sur notifications ou Adobe Analytics.

Par défaut, la configuration AEM Communities Publisher Configuration OSGi est configurée avec la case à cocher Primary Publisher cochée, de sorte que toutes les instances de publication d’une batterie de publication s’identifient elles-mêmes comme 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.

éditeur Principal

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

Agents de réplication sur l'auteur

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

Pour l’éditeur Principal, vérifiez 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 d'auteur doivent être configurés correctement pour la configuration du transport.

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

    • Dans la navigation globale, accédez à Outils > Déploiement > Réplication > Agents sur auteur

  • Suivez la même procédure pour les deux agents :

    • Agent par défaut (publication)

    • Agent de réplication inverse (inversion de publication)

      1. Sélectionner l'agent

      2. Sélectionner modifier

      3. Sélectionnez l'onglet Transport

      4. Si le port n’est pas 4503, modifiez l’URI pour spécifier le port correct.

      5. Si vous n’utilisez pas admin, modifiez les Utilisateur et Mot de passe pour spécifier un membre du groupe d’utilisateurs administrators.

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

Agent par défaut (publication)

default-agent-publish

Agent de réplication inverse (inversion de publication)

rétro-réplication-agent

Service Tunnel sur l'auteur

Lorsque vous utilisez l'environnement d'auteur 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) inscrits dans l'environnement de publication, et non aux utilisateurs enregistrés dans l'auteur.

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

Pour activer le service de tunnel :

Répliquer la clé Crypto

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.

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

Pour copier la documentation 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

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

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

      • Copie des fichiers hmac et des Principaux noeuds

  • Pour chaque instance de cible AEM

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

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

    • Coller les 2 fichiers copiés précédemment

    • actualiser le lot Granite Crypto si l'instance d'AEM cible est en cours d'exécution

ATTENTION

Si une autre fonction 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 pourrait endommager la configuration. Pour obtenir de l'aide, contactez le service à la clientèle.

Réplication du référentiel

Le fait que la clé soit stockée dans le référentiel, comme c'était le cas pour AEM 6.2 et les versions antérieures, peut être conservé en spécifiant la propriété système suivante au premier démarrage de chaque instance AEM (qui crée le référentiel initial) :

  • -Dcom.adobe.granite.crypto.file.disable=true
REMARQUE

Il est important de vérifier que l'agent de réplication sur author 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 à d'autres instances est la suivante :

Utilisation de CRXDE Lite :

Actualiser l'offre groupée Granite Crypto

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

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

  • Sélectionner Actualiser

    crypto-granite

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

Serveur HTTP Apache

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

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

exemple 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

Si vous utilisez un répartiteur, voir :

  • Reportez-vous à la section Administration des sites de communauté pour en savoir plus sur la création d’un site de communauté, la configuration de modèles de sites de communauté, la modération du contenu de communauté, la gestion des membres et la configuration de la messagerie.

  • Visitez Communautés en développement pour en savoir plus sur le cadre des composants sociaux (SCF) et sur la personnalisation des composants et fonctionnalités des communautés.

  • Visitez Création de composants de communautés pour savoir comment créer et configurer des composants de communautés.

Sur cette page