Show Menu
SUJETS×

Déploiement de Communities

Liste de contrôle d'installation

Pour la plateforme AEM
Pour la fonctionnalité Communautés

Dernières versions

AEM 6.4 Communities GA fournit un package Communities. Pour en savoir plus sur les mises à jour des communautés AEM 6.4, consultez les Notes de mise à jour d’ AEM 6.4.

Mises à jour d’AEM 6.4

À partir d’AEM 6.3, les mises à jour apportées aux communautés sont fournies dans le cadre des Fix Packs et Service Packs cumulatifs d’AEM.
Pour les dernières mises à jour d’AEM 6.4, veillez à vérifier les packs de correctifs cumulés et les Service Packs Adobe Experience Manager 6.4 .

Version History

Comme pour AEM 6.4 et les versions ultérieures, les fonctionnalités et correctifs des communautés AEM font partie des packs de correctifs et des Service Packs cumulatifs des communautés AEM. Il n’existe donc pas de Feature Packs distincts.

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 (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 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, redémarrez 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 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 Lots Web.

Exemple : Bundle MySQL Connector installé

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 la manière dont le contenu peut être compressé dans un fichier ZIP transférable.
Le moteur SCORM des communautés AEM est requis pour la fonctionnalité d’activation . Les packages Scorm pris en charge sur la version 6.4 d’AEM Communities sont :
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 jouer aux ressources d’apprentissage prises en charge par SCORM 2017.

Pour installer un pack SCORM pour la première fois

  1. Téléchargez /libs/social/config/scorm/database_scormengine_data.sql à partir de l’instance cq et exécutez-la dans mysql server pour créer un schéma scormEngineDB mis à niveau.
  2. Ajoutez /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.
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. Téléchargez le package depuis /libs/social/config/scorm/ScormEngine.zip et extrayez le même.
  3. Accédez au dossier Installer du répertoire extrait.
  4. Effectuez une mise à jour SystemDatabaseConnectionString avec votre scorm db connection url fichier EngineInstall.xml .
  5. 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
  6. Surveillez engine_upgrade.log le fichier pour connaître les erreurs et l’état de mise à niveau du schéma.
  7. Ajoutez /content/communities/scorm/RecordResults dans la propriété Chemins exclus du filtre CSRF depuis 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 du journal peut être défini sur WARN pour le RusticiSoftware.* package.
Pour utiliser des journaux, voir Utilisation des enregistrements d’audit et des fichiers journaux.

MLS AEM Advanced

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 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 et les détails, consultez Configuration du Solr pour 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 AEM 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 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 reposant sur des notifications ou Adobe Analytics .
Par défaut, la configuration AEM Communities Publisher Configuration OSGi est configurée avec la Primary Publisher case à cocher cochée, de sorte que toutes les instances de publication dans une batterie de publication s’identifient elles-mêmes comme étant le principal.
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.
Pour toutes les autres instances de publication (secondaires) dans 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 Service Tunnel sur l’auteur 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 administrators d’utilisateurs (également membre de Communities Administrators ).
Il existe deux agents de réplication dans l’environnement d’auteur qui doivent configurer correctement 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 de la modification du port de 4503 à 6103 par :

Agent par défaut (publication)

Agent de réplication inverse (inversion de publication)

Service Tunnel sur l’auteur

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

Répliquer la clé Crypto

Deux fonctionnalités des communautés AEM exigent que toutes les instances de serveur AEM utilisent les mêmes clés de chiffrement. Il s’agit d’Analytics et d’ASRP .
Depuis 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 éléments clés 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éder au dossier de données
      Par exemple :
      • <author-aem-install-dir>/crx-quickstart/launchpad/felix/bundle21/data
    • Copie des fichiers hmac et originaux
  • Pour chaque instance AEM cible
    • Accéder 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.
Si une autre fonction de sécurité a déjà été configurée basée sur les clés de chiffrement, la réplication des clés de chiffrement pourrait endommager la configuration. Pour obtenir de l’aide, contactez le service à la 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 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
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 vers d’autres instances est la suivante :
Using CRXDE Lite :

Actualiser l’offre groupée Granite Crypto

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

Répartiteur

Si vous utilisez un répartiteur, reportez-vous à la section :