Déploiement de Communities

Conditions préalables

Liste de contrôle d'installation

Pour la plateforme AEM

Pour la fonctionnalité Communautés

Latest Releases

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

AEM 6.4 Updates

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

Pour les dernières mises à jour de AEM 6.4, veillez à vérifier les Fix Packs et Service Packs Adobe Experience Manager 6.4 cumulatifs.

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 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 l'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 à partir de 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, 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 de Oracle Corporation pour MySQLcom.mysql.jdbc est principal et début-le s'il n'est pas utilisé (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, http://localhost:4502/system/console/configMgr
    • Localisation de la Day Commons JDBC Connections Pool configuration
    • 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 : Groupe MySQL Connector installé

chlimage_1-410

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 d’ activation . Les packages Scorm pris en charge sur AEM Communities 6.4 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é. Pour que vous puissiez lire les ressources d’apprentissage prises en charge par SCORM 2017.

Pour installer un pack SCORM pour la première fois

  1. Installez le package cq-social-scorm-package, version 2.2.2.
  2. Téléchargez /libs/social/config/scorm/database_scormengine_data.sql l'instance cq et exécutez-la dans mysql server pour créer un schéma scormEngineDB mis à niveau.
  3. Ajouter /content/communities/scorm/RecordResults dans la propriété Chemins exclus du filtre CSRF depuis https://<hostname>;:<port>/system/console/configMgr 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.

NOTE

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. Sauvegardez le schéma ScormEngineDB.

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

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

  4. Accédez au dossier Installer du répertoire extrait.

  5. Effectuez une mise à jour SystemDatabaseConnectionString à l’aide de votre scorm db connection url 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 engine_upgrade.log le fichier pour toute erreur et tout état de mise à niveau de schéma.

  8. Ajoute /content/communities/scorm/RecordResults dans la propriété Chemins ​exclus du filtre CSRF sur https://<hostname>:<port>/system/console/configMgr 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 RusticiSoftware.* package.

Pour utiliser les journaux, voir Utilisation des enregistrements d’audit et des fichiersjournaux.

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 Configuration Solr 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 Installbouton 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 Installprovoquera une erreur.

Installation sur une instance AEM locale

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

  • Select the Assets tab
  • Select download to disk

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

Vous pouvez également accéder au package à l’aide du partage de package depuis l’instance AEM locale (par exemple, http://localhost:4502/crx/packageshare/), le Downloadbouton est téléchargé vers 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 des packages.

En AEM Communities, un magasin commun est utilisé pour stocker le contenu généré par l’utilisateur et est souvent appelé 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 la nécessité de réplication de l’UGC.

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

  • Topologiesrecommandé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.4 à partir des versions précédentes d’AEM, il est important de lire Mise à niveau vers l’ 6.4.

Outre la mise à niveau de la plateforme, consultez 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 batterie depublication, une instance de publication AEM doit être identifiée comme la primary publisher pour les activités qui ne doivent pas se produire sur toutes les instances, telles que les fonctionnalités qui reposent sur des notifications ou un Adobe Analytics.

Par défaut, la configuration AEM Communities Publisher Configuration OSGi est configurée avec la Primary Publisher case 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 Primary Publisher case.

chlimage_1-411

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

  • Connexion avec droits d’administrateur

  • Access the web console

  • Localisez la variable AEM Communities Publisher Configuration

  • Sélectionner l’icône de modification

  • Décochez la case Editeur ​Principal

  • 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, 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, 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’ administrators utilisateurs (é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

    • A 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 (inversion de publication)

      1. Sélectionner l'agent
      2. Select edit
      3. Select the Transport tab
      4. Si ce n’est pas le port 4503, modifiez l’ URI pour spécifier le port correct.
      5. Si vous n’utilisez pas admin, modifiez l’ utilisateur et le mot de passe pour spécifier un membre du groupe administrators d’utilisateurs.

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

Agent par défaut (publication)

chlimage_1-412

Agent de réplication inverse (inversion de publication)

chlimage_1-413

Service de tunnel sur l’auteur

Lors de l’utilisation de l’environnement d’auteur pour créer des sites, modifier des propriétés du site ou gérer des membresde 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’ d’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 :

chlimage_1-414

Réplication de 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 d’ Analytics et d’ ASRP.

À partir de l'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.

    • Locate the com.adobe.granite.crypto.file bundle in the local file system

      Par exemple :

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Le bundle.info fichier 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

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

CAUTION

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
NOTE

Il est important de vérifier 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 à d'autres instances est la suivante :

Using CRXDE Lite:

chlimage_1-415

Actualiser l'offre groupée Granite Crypto

chlimage_1-416

  • Après un moment, une boîte de dialogue Réussite s’affiche :

    Operation completed successfully.

Apache HTTP Server

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 localhostle nom, 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.

  • Visit Developing Communities to learn about the social component framework (SCF) and customizing Communities components and features.

  • Visitez la page Composants Communautés de création pour découvrir comment créer et configurer des composants Communautés.

Sur cette page