Configuration MySQL pour les fonctionnalités d’activation

MySQL est une base de données relationnelle principalement utilisée pour le suivi SCORM et les données de rapports pour les ressources d’activation. Il contient des tableaux pour d’autres fonctionnalités telles que le suivi de la mise en pause/reprise de la vidéo.

Ces instructions décrivent comment se connecter au serveur MySQL, établir la base de données d’activation et renseigner la base de données avec les données initiales.

Conditions requises

Avant de configurer la fonction d’activation de MySQL pour les communautés, veillez à

• Installation de MySQL Server Community Server version 5.6
  • La version 5.7 n’est pas prise en charge pour SCORM
  • Peut être le même serveur que l’instance d’AEM d’auteur
• Sur toutes les instances AEM, installez le pilote JDBC officiel pour MySQL.
• Installation de MySQL Workbench
• Sur toutes les instances AEM, installez le package SCORM.

Installation de MySQL

MySQL doit être téléchargé et installé selon les instructions du système d’exploitation de cible.

Noms de table en minuscules

SQL n'étant pas sensible à la casse, pour les systèmes d'exploitation sensibles à la casse, il est nécessaire d'inclure un paramètre permettant de mettre en minuscules tous les noms de table.

Par exemple, pour spécifier tous les noms de table en minuscules sur un système d’exploitation Linux :

• Modifier le fichier /etc/my.cnf
• Dans la [mysqld] section, ajoutez la ligne suivante :
  lower_case_table_names = 1

Jeu de caractères UTF8

Pour une meilleure prise en charge multilingue, il est nécessaire d'utiliser le jeu de caractères UTF8.

Modifiez MySQL pour qu’UTF8 soit utilisé comme jeu de caractères :

• mysql> SET NAMES 'utf8';

Remplacez la base de données MySQL par défaut par UTF8 :

• Modifier le fichier /etc/my.cnf
• Dans la [client] section, ajoutez la ligne suivante :
  default-character-set=utf8
• Dans la [mysqld] section, ajoutez la ligne suivante :
  character-set-server=utf8

Installation de MySQL Workbench

MySQL Workbench fournit une interface utilisateur pour exécuter des scripts SQL qui installent le schéma et les données initiales.

MySQL Workbench doit être téléchargé et installé selon les instructions du système d’exploitation de cible.

Connexion d'activation

Lorsque MySQL Workbench est lancé pour la première fois, sauf s’il est déjà utilisé à d’autres fins, il n’affiche pas encore de connexions :

Nouveaux paramètres de connexion

1. Sélectionnez l'icône "+" à droite de MySQL Connections.
2. Dans la boîte de dialogue Setup New Connection, saisissez les valeurs appropriées pour votre plateforme à des fins de démonstration, avec l’instance d’AEM auteur et MySQL sur le même serveur :
   • Nom de la connexion: Enablement
   • Méthode de connexion : Standard (TCP/IP)
   • Nom d’hôte: 127.0.0.1
   • Nom d’utilisateur: root
   • Mot de passe: no password by default
   • Schéma par défaut : leave blank
3. Sélectionnez Test Connection pour vérifier la connexion au service MySQL en cours d’exécution.

Notes:

• Le port par défaut est 3306
• Le Connection Name choix est entré en tant que datasource nom dans la configuration JDBC OSGi.

Connexion réussie

Nouvelle connexion d'activation

Configuration de la base de données

Lors de l’ouverture de la nouvelle connexion d’activation, vous constatez qu’il existe un schéma de test et des comptes d’utilisateurs par défaut.

Obtention des scripts SQL

Les scripts SQL sont obtenus à l’aide du CRXDE Lite sur l’instance d’auteur. Le package SCORM doit être installé :

1. Accéder au CRXDE Lite
   • For example, http://localhost:4502/crx/de
2. Développez le /libs/social/config/scorm/ dossier
3. Téléchargement database_scormengine.sql
4. Téléchargement database_scorm_integration.sql

Une méthode de téléchargement du schéma consiste à

• Sélectionner le jcr:contentnoeud du fichier sql
• Notez que la valeur de la jcr:datapropriété est un lien de vue.
• Sélectionnez le lien de la vue pour enregistrer les données dans un fichier local.

Créer une base de données SCORM

La base de données SCORM d'activation à créer est la suivante :

• name: ScormEngineDB
• créé à partir de scripts :
  • schéma: database_scormengine.sql
  • data: database_scorm_integration.sql
    Follow the steps below (
    open, execute) pour installer chaque script SQL. Actualisez si nécessaire pour voir les résultats de l’exécution du script.

Veillez à installer le schéma avant d’installer les données.

Étape 1 : ouvrir le fichier SQL

Dans MySQL Workbench

• Dans le menu déroulant Fichier
• Sélectionner Open SQL Script ...
• Dans cet ordre, sélectionnez l'une des options suivantes :
  1. database_scormengine.sql
  2. database_scorm_integration.sql

Étape 2 : exécuter un script SQL

Dans la fenêtre Workbench du fichier ouvert à l’étape 1, sélectionnez le fichier lightening (flash) icon à exécuter.

Notez que l’exécution du database_scormengine.sql script destiné à créer la base de données SCORM peut prendre une minute.

Actualiser

Une fois les scripts exécutés, il est nécessaire d’actualiser la SCHEMASsection de la Navigator afin de voir la nouvelle base de données. Utilisez l’icône Actualiser à droite de "SCHÉMAS" :

Résultat : scormenginedb

Une fois les SCHÉMAS installés et actualisés, ils scormenginedb seront visibles.

Configuration des connexions JDBC

La configuration OSGi pour le pool de connexions JDBC Day Commons permet de configurer le pilote JDBC MySQL.

Toutes les instances d’AEM de publication et d’auteur doivent pointer vers le même serveur MySQL.

Lorsque MySQL s’exécute sur un serveur différent de AEM, le nom d’hôte du serveur doit être spécifié à la place de "localhost" dans le connecteur JDBC (qui renseigne la configuration de ScormEngine ).

• Sur chaque instance d’AEM d’auteur et de publication
• Connecté avec des droits d’administrateur
• Access the web console
  • For example, http://localhost:4502/system/console/configMgr
• Localisez la variable Day Commons JDBC Connections Pool
• Sélectionnez l' + icône permettant de créer une configuration

• Saisissez les valeurs suivantes :
  • Classe de pilote JDBC : com.mysql.jdbc.Driver
  • URIJ de connexion DBC :jdbc:mysql://localhost:3306/aem63reportingspécifiez le serveur à la place de localhost si le serveur MySQL n’est pas identique à "this" AEM serveur
  • Nom d'utilisateur: Racine ou saisissez le nom d’utilisateur configuré pour le serveur MySQL, si ce n’est "root"
  • Mot de passe: Effacez ce champ si aucun mot de passe n’est défini pour MySQL, sinon saisissez le mot de passe configuré pour le nom d’utilisateur MySQL.
  • Nom de la source de données : Nom saisi pour la connexion MySQL, par exemple "activation"
• Sélectionnez Enregistrer

Configurer Scorm

Service AEM Communities ScormEngine

La configuration OSGi pour le service ScormEngine AEM Communities configure SCORM pour l’utilisation du serveur MySQL par une communauté d’activation.

Cette configuration est présente lorsque le package SCORM est installé.

Toutes les instances de publication et d’auteur pointent vers le même serveur MySQL.

Lorsque MySQL s’exécute sur un serveur différent de AEM, le nom d’hôte du serveur doit être spécifié à la place de "localhost" dans le service ScormEngine, qui est généralement renseigné à partir de la configuration de connexion JDBC.

• Sur chaque instance d’AEM d’auteur et de publication
• Connecté avec des droits d’administrateur
• Access the web console
  • For example, http://localhost:4502/system/console/configMgr
• Localisez la variable AEM Communities ScormEngine Service
• Sélectionner l’icône de modification
  
• Vérifiez que les valeurs de paramètre suivantes sont cohérentes avec la configuration de la connexion JDBC :
  • URI de connexion JDBC : jdbc:mysql://localhost:3306/ScormEngineDB ScormEngineDB est le nom de base de données par défaut dans les scripts SQL.
  • Nom d'utilisateur: Racine ou saisissez le nom d’utilisateur configuré pour le serveur MySQL, si ce n’est "root"
  • Mot de passe: Effacez ce champ si aucun mot de passe n’est défini pour MySQL, sinon saisissez le mot de passe configuré pour le nom d’utilisateur MySQL.
• Concernant le paramètre suivant :

  • Scorm User Password: NE PAS MODIFIER

    usage interne uniquement. Il est destiné à un utilisateur de service spécial utilisé par AEM Communities pour communiquer avec le moteur de score.

• Sélectionnez Enregistrer

Filtre CSRF Granit Adobe

Pour que les cours d’activation fonctionnent correctement dans tous les navigateurs, il est nécessaire d’ajouter Mozilla en tant qu’agent utilisateur qui n’est pas contrôlé par le filtre CSRF.

• Sur chaque instance de publication AEM
• Connecté avec des droits d’administrateur
• Access the web console
  • For example, http://localhost:4503/system/console/configMgr
• Localiser Adobe Granite CSRF Filter
• Sélectionner l’icône de modification
  
• Sélectionnez l' [+] icône permettant d'ajouter un agent d'utilisateur sécurisé.
• Enter Mozilla/*
• Sélectionnez Enregistrer