Déploiement de Communities

Prérequis

Liste de contrôle d’installation

Pour le AEM plateforme

Pour le Fonctionnalités des communautés

Dernières versions

AEM 6.4 Communities GA inclut le package Communities. Pour en savoir plus sur les mises à jour d’AEM 6.4 Communautés, voir 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 Packs de correctifs cumulatifs et Service Packs Adobe Experience Manager 6.4.

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 activation: 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. Extraire mysql-connector-java-<version>-bin.jar (lot) à partir 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 Pilote JDBC d’Oracle Corporation pour MySQLcom.mysql.jdbc est principale et démarrez-la si ce n’est pas le cas (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
    • Localiser 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.

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

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 variable activation fonction . 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 module 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écharger /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. Ajouter /content/communities/scorm/RecordResults dans la propriété Chemins exclus du filtre CSRF de 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 module depuis /libs/social/config/scorm/ScormEngine.zip et extrayez le même.

  4. Accédez à Programme du répertoire extrait.

  5. Mettre à 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. Surveiller engine_upgrade.log pour tout type d’erreur et l’état de mise à niveau du schéma.

  8. Ajouter /content/communities/scorm/RecordResults in Chemins exclus propriété dans le filtre CSRF à partir 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 la variable RusticiSoftware.* module.

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

AEM MLS avancés

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 :

  • AEM-SOLR-MLS-phasetwo

    Pour obtenir le package MLS avancé, voir AEM MLS avancés dans la section deploy 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, voir Configuration de Solr pour la 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 doivent être partagés sur adobeaemcloud.com. Bien que les modules soient visibles, la variable Installest destiné à installer les packages sur un site hébergé par Adobe. Si vous envisagez d’installer sur une instance d’AEM locale, sélectionnez 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 la Ressources tab
  • Sélectionner 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 vers le référentiel de package d’AEM local.

Vous pouvez également accéder au module à l’aide du partage de module à partir de l’instance d’AEM locale (par exemple, http://localhost:4502/crx/packageshare/), la variable Downloadtélécharge 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 Utilisation de modules.

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 de contenu généré par l’utilisateur.

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.

En plus de la mise à niveau de la plateforme, lisez 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 sélectionné est un batterie de publication, une instance de publication AEM doit être identifiée en tant que primary publisher pour les activités qui ne doivent pas se produire sur toutes les instances, telles que les fonctionnalités qui dépendent de notifications ou Adobe Analytics.

Par défaut, la variable AEM Communities Publisher Configuration La configuration OSGi est configurée avec le Primary Publisher case à cocher cochée, de sorte que toutes les instances de publication d’une ferme 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 variable 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 au console web

  • Recherchez la variable AEM Communities Publisher Configuration

  • Sélectionner l’icône de modification

  • Décochez la case Éditeur Principal box

  • 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 la communauté, ainsi que pour la gestion des membres et des groupes de membres de l’environnement de création à l’aide de la fonction service tunnel.

Pour l’éditeur Principal, assurez-vous que la variable 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 à la variable administrators groupe d’utilisateurs (é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électionner edit
      3. Sélectionnez la Transport tab
      4. Si pas de port 4503, modifiez la variable URI pour spécifier le port correct
      5. Si l’utilisateur n’est pas admin, modifiez la variable Utilisateur et Mot de passe pour spécifier un membre de la fonction administrators groupe d’utilisateurs

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

Lors de l’utilisation de l’environnement de création dans créer des sites ;, modification des propriétés du site ou gestion des 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éplication de 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. Voici les 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.

    • Recherchez la variable com.adobe.granite.crypto.file lot dans le système de fichiers local

      Par exemple,

      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21
      • Le 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 de actualiser le lot Crypto Granite 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 la variable 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 CRXDE Lite:

chlimage_1-415

Actualisation du lot de chiffrement Granite

chlimage_1-416

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

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

En particulier, veillez à utiliser le nom de serveur correct, et non localhost, dans la variable 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.

  • Visite Développement de communautés pour en savoir plus sur la structure de composants sociaux (SCF) et la personnalisation des composants et fonctionnalités des communautés.

  • Visite Création de composants Communities pour savoir comment créer avec et configurer des composants Communities.

Sur cette page