Déploiement de Communities

Prérequis

Liste de contrôle d’installation

Pour la plateforme AEM

Pour la fonctionnalité Communities

Dernières versions

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

Mises à jour AEM 6.4

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

Pour connaître les dernières mises à jour d’AEM 6.4, veillez à vérifier Adobe Experience Manager 6.4 Cumulative Fix Packs et Service Packs.

Historique des versions

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

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

  • Pour enablement : enregistrement des activités SCORM et des apprenants
  • Pour DSRP : stockage du contenu généré 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 à partir de 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, http://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 d’Oracle Corporation pour MySQLcom.mysql.jdbc est principal 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, http://localhost:4502/system/console/configMgr
    • Localisation de 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.

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

Exemple : Bundle MySQL Connector installé

chlimage_1-410

Package SCORM

SCORM (Share Content Object Reference Model) est un ensemble de normes et de spécifications pour l’apprentissage en ligne. SCORM définit également la manière dont le contenu peut être compressé dans un fichier ZIP transférable.

Le moteur SCORM AEM Communities est requis pour la fonction activation . Les packages de notation pris en charge sur la version 6.4 d’AEM Communities sont les suivants :

Pour une nouvelle installation du moteur SCORM, le package contenant SCORM 2017.1 (qui est cq -social-scorm-package, version 2.2.2) doit être utilisé. Afin que vous puissiez lire les ressources d’apprentissage prises en charge par SCORM 2017.

Pour installer un package SCORM pour la première fois

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

Les installations SCORM existantes peuvent être mises à niveau vers cq-social-scorm-package, version 2.2.2 (qui utilise SCORM 2017.1), si le contenu du cours créé nécessite SCORM 2017.1.

REMARQUE

La mise à niveau vers le package SCORM 2017.1 nécessite la migration de la base de données existante (comme expliqué plus loin).

Pour mettre à niveau la version de votre moteur SCORM

  1. Effectuez une sauvegarde du schéma ScormEngineDB.

  2. Installez le cq-social-scorm-package, version 2.2.2.

  3. Téléchargez le package à partir de /libs/social/config/scorm/ScormEngine.zip et extrayez-le.

  4. Accédez au dossier Programme d’installation du répertoire extrait.

  5. Mettez à jour SystemDatabaseConnectionString avec votre scorm db connection url dans le fichier EngineInstall.xml.

  6. Exécutez l'outil de mise à niveau de schéma mysql dans le dossier Installer avec la commande :

    java -Dlogback.configurationFile=logback.xml -cp "lib/*" RusticiSoftware.ScormContentPlayer.Logic.Upgrade.ConsoleApp EngineInstall.xml

  7. Surveillez le fichier engine_upgrade.log à la recherche de tout type d’erreur et de statut de mise à niveau du schéma.

  8. 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

Lors de l’installation, toutes les activités d’activation sont généreusement consignées 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 Adobe :

Pour plus d’informations sur l’installation, voir Configuration Solr pour SRP.

Modules 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 à un partage de modules sur adobeaemcloud.com. Bien que les packages soient visibles, le bouton Installpermet d’installer les packages sur un site hébergé par Adobe. Si vous envisagez d’installer sur une instance d’AEM locale, la sélection de Installentraînera 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 Ressources
  • Sélectionnez télécharger sur le disque

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

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

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

Pour plus d’informations, voir Comment utiliser les packages.

Dans AEM Communities, un magasin commun est utilisé pour stocker le contenu généré par l’utilisateur et est souvent appelé fournisseur de ressources de stockage (SRP). Le déploiement recommandé consiste à choisir 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.

  • Community Content Store : présente les options de stockage SRP pour les communautés AEM

  • Topologies recommandées : aborde la topologie à utiliser en fonction du cas d’utilisation et du choix de la SRP.

Mise à niveau

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

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

Configurations

Éditeur Principal

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, telles que les fonctionnalités qui reposent sur les 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 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.

chlimage_1-411

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

  • Connexion avec droits d’administrateur

  • Accédez à la console web

  • Recherchez le AEM Communities Publisher Configuration

  • Sélectionner l’icône de modification

  • Décochez la case Principal Publisher

  • Sélectionnez Enregistrer

Agents de réplication sur l’auteur

La réplication est utilisée pour le contenu du site créé dans l’environnement de publication, comme les groupes de communautés, ainsi que pour 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

    • À partir de la navigation globale : 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 inversée)

      1. Sélectionner l’agent
      2. Sélectionnez edit
      3. Sélectionnez l’onglet Transport
      4. Si le port n’est pas 4503, modifiez l’URI pour spécifier le port approprié.
      5. Si l’utilisateur n’est 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 en :

Agent par défaut (publication)

chlimage_1-412

Agent de réplication inverse (publication inversée)

chlimage_1-413

Service Tunnel sur l’auteur

Lorsque vous utilisez 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 :

chlimage_1-414

Répliquer la clé de chiffrement

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.

À compter de la version 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 les documents clés de l’auteur vers toutes les autres instances, il est nécessaire de :

  • Accédez à l’instance d’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ès au dossier de données

      Par exemple,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Copiez les fichiers hmac et de noeud Principal.

  • Pour chaque instance AEM cible

    • Accès au dossier de données

      Par exemple,

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

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

ATTENTION

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

Le fait que le matériel clé soit stocké dans le référentiel, comme c’était le cas pour AEM version 6.2 et antérieure, 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 vers d’autres instances est la suivante :

Utilisation de CRXDE Lite :

chlimage_1-415

Actualisez le lot de chiffrement Granite

chlimage_1-416

  • Après un moment, une boîte de dialogue Succès doit s’afficher :

    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 pertinentes.

En particulier, veillez à utiliser le nom de serveur correct, et non localhost, dans la balise 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 Dispatcher, 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 Développement de communautés pour en savoir plus sur la structure de composants sociaux (SCF) et la personnalisation des composants et fonctionnalités de communautés.

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

Sur cette page