Show Menu
SUJETS×

Déploiement de Communities

Liste de contrôle d'installation

Pour la plateforme AEM
Pour la fonctionnalité Communautés

Latest Releases

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

Mises à jour d’AEM 6.5

À partir d’AEM 6.4, les mises à jour apportées aux communautés sont fournies dans le cadre des Fix Packs et Service Packs cumulatifs d’AEM.
Pour obtenir les dernières mises à jour d’AEM 6.5, voir Adobe Experience Manager 6.4 Cumulative Fix Packs et Service Packs .

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 de SCORM et apprenants
  • 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 :
  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 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 d' Oracle Corporation pour MySQLcom.mysql.jdbc est actif et -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, https://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 Console Web 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 . Packages Scorm pris en charge sur les communautés AEM 6.5 :
Pour installer un package 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 à partir de l’instance cq et exécutez-la dans mysql server pour créer un scormEngineDB mis à niveau.
  3. Ajouter /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, toutes les activations sont généreusement enregistrées 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 les 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’une personnalisée 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.5 à partir des versions précédentes d’AEM, il est important de lire Mise à niveau vers AEM 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 l’instance primary publisher de qui ne doit 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 le de publication , tel que les groupes de la communauté, ainsi que pour la gestion des membres et des groupes de membres de l’de l’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 le de l'auteur qui ont besoin que la configuration du transport soit correctement configurée.
  • Accès à la console de réplication sur l’auteur
    • Dans la navigation globale, accédez à 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)

Agent de réplication inverse (inversion de publication)

Service Tunnel sur l’auteur

Lorsque vous utilisez l’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 le 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

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 documents 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 for example,
      • <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 originaux
  • Pour chaque instance AEM
    • Accédez 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 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 à 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>

Dispatcher

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