Configuration de 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 à

• 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 d’auteur.
• Sur toutes les instances AEM, installez le pilote officiel JDBC 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 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 d'abaisser 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 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 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 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 à 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.

Remarques:

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

Connexionré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édez au CRXDE Lite :
   • Par exemple, http://localhost:4502/crx/de
2. Développez le dossier /libs/social/config/scorm/.
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électionnez le noeud jcr:content pour le fichier sql.
• Notez que la valeur de la propriété jcr:data est un lien de vue.
• Sélectionnez le lien de la vue pour enregistrer les données dans un fichier local.

Créer la 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 (
    open, execute) pour installer chaque script SQL. Actualiser 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 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 Navigator afin de voir la nouvelle base de données. Utilisez l’icône Actualiser à droite de "SCHÉMAS" :

Résultat : scormenginedb

Après avoir installé et actualisé des SCHÉMAS, le 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 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 ScormEngine).

• Sur chaque instance d’AEM d’auteur et de publication

• Connecté avec des droits d’administrateur

• Accédez à la console Web

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

• Localisez le Day Commons JDBC Connections Pool

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

  

• Saisissez les valeurs suivantes :

  • Classe de pilote JDBC : com.mysql.jdbc.Driver
  • URIJ de connexion DBC : jdbc:mysql://localhost:3306/aem63reporting spécifiez le serveur à la place de localhost si le serveur MySQL n’est pas identique au serveur AEM "this".
  • 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 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 JDBC Connection.

• Sur chaque instance d’AEM d’auteur et de publication

• Connecté avec des droits d’administrateur

• Accédez à la console Web

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

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

  • Scorm User Password : NE PAS MODIFIER

    Pour un 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 Granite 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.

• 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 Modifier.

  

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

• Enter Mozilla/*.

• Sélectionnez Enregistrer.