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 création de rapports pour les ressources d’activation. Il comprend des tableaux pour d’autres fonctionnalités telles que le suivi de la mise en pause/reprise vidéo.

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

Conditions requises

Avant de configurer la fonction d’activation de MySQL pour Communities, veillez à

• Installez 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 de création.
• Sur toutes les instances AEM, installez le pilote JDBC officiel pour MySQL.
• Installez 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 cible.

Noms de table en minuscules

Comme SQL n’est pas sensible à la casse, pour les systèmes d’exploitation sensibles à la casse, il est nécessaire d’inclure un paramètre permettant de réduire la casse de 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 section [mysqld], ajoutez la ligne suivante : lower_case_table_names = 1

Jeu de caractères UTF8

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

Modifiez MySQL pour que UTF8 soit son 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 section [client], ajoutez : default-character-set=utf8
• Dans la section [mysqld], ajoutez : 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 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 à votre plateforme à des fins de démonstration, avec l’instance d’AEM de création 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.

Remarques:

• Le port par défaut est 3306.
• Le Connection Name sélectionné est saisi comme nom datasource dans la configuration OSGi JDBC.

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 remarquerez qu’il existe un schéma de test et des comptes utilisateur par défaut.

Obtention de scripts SQL

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

1. Accédez à CRXDE Lite :
   • Par exemple, http://localhost:4502/crx/de
2. Développez le dossier /libs/social/config/scorm/
3. Télécharger database_scormengine.sql
4. Télécharger database_scorm_integration.sql

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

• Sélectionnez le noeud jcr:content pour le fichier sql.
• Notez que la valeur de la propriété jcr:data est un lien d’affichage.
• Sélectionnez le lien d'affichage 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
    Suivez les étapes ci-dessous (
    ouvrez, exécutez) pour installer chaque script SQL . 🔗 Rafraîchissez-vous 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

• À partir du 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 le script SQL

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

Notez que l’exécution du script database_scormengine.sql pour 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 section SCHEMAS de la balise Navigator afin de voir la nouvelle base de données. Utilisez l’icône d’actualisation à droite de "SCHEMAS" :

Résultat : scormenginedb

Après l’installation et l’actualisation des SCHÉMAS, la balise scormenginedb est visible.

Configuration des connexions JDBC

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

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

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

• Sur chaque instance d’AEM de création et de publication

• Connexion avec droits d’administrateur

• Accédez à la console web

  • Par exemple, http://localhost:4502/system/console/configMgr

• Recherchez le Day Commons JDBC Connections Pool

• Sélectionnez l’icône + pour créer une configuration.

  

• Saisissez les valeurs suivantes :

  • Classe de pilote JDBC : com.mysql.jdbc.Driver
  • URIJ de connexion DBC : jdbc:mysql://localhost:3306/aem63reporting spécifiez server à la place de localhost si le serveur MySQL n’est pas le même que "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 le score

Service AEM Communities ScormEngine

La configuration OSGi pour AEM Communities ScormEngine Service 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 l’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 Connexion JDBC .

• Sur chaque instance d’AEM de création et de publication

• Connexion avec droits d’administrateur

• Accédez à la console web

  • Par exemple, http://localhost:4502/system/console/configMgr

• Recherchez le AEM Communities ScormEngine Service

• Sélectionner l’icône de modification

  

• Vérifiez que les valeurs de paramètre suivantes sont conformes à la configuration JDBC Connection :

  • 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 :

  • Mot de passe de l’utilisateur de notation : NE PAS MODIFIER

    Pour une utilisation interne uniquement : Il s’agit pour un utilisateur du service spécial utilisé par AEM Communities pour communiquer avec le moteur de score.

• Sélectionnez Enregistrer

Adobe du filtre CSRF Granite

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

• Connectez-vous à l’instance de publication AEM avec les droits d’administrateur.

• Accédez à la console web

  • Par exemple, http://localhost:4503/system/console/configMgr

• Recherchez Adobe Granite CSRF Filter.

• Sélectionnez l’icône de modification.

  

• Sélectionnez l’icône [+] pour ajouter un agent utilisateur sécurisé.

• Enter Mozilla/*.

• Sélectionnez Enregistrer.