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 à

  • Installer Serveur MySQL 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 d’AEM, installez le Pilote JDBC pour MySQL.
  • Installer MySQL Workbench.
  • Sur toutes les instances d’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 le [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 le [client] , ajoutez : default-character-set=utf8
  • Dans le [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 :

mysqlconnection

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électionner 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 est renseigné comme datasource name in Configuration OSGi JDBC.

Connexion réussie

mysqlconnection1

Nouvelle connexion d’activation

mysqlconnection2

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.

database-setup

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 :
  2. Développez l’objet /libs/social/config/scorm/ folder
  3. Télécharger database_scormengine.sql
  4. Télécharger database_scorm_integration.sql

sqlscripts

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

  • Sélectionnez la jcr:content pour le fichier sql.
  • Notez la valeur de la variable 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 (
      open, execute) pour installer chaque Script SQL . Actualiser lorsque cela s’avère nécessaire pour afficher les résultats de l’exécution du script.

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

ATTENTION

Si le nom de la base de données est modifié, veillez à le spécifier correctement dans :

É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

scrom-database

Étape 2 : exécuter le script SQL

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

Notez que l’exécution de la variable database_scormengine.sql la création de la base de données SCORM peut prendre une minute.

scrom-database1

Actualiser

Une fois les scripts exécutés, il est nécessaire d’actualiser la variable SCHEMAS de la section Navigator afin de voir la nouvelle base de données. Utilisez l’icône d’actualisation à droite de "SCHEMAS" :

scrom-database2

Résultat : scormenginedb

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

scrom-database3

Configuration des connexions JDBC

Configuration OSGi pour 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 variable ScormEngine config).

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

  • Connexion avec droits d’administrateur

  • Accédez au console web

  • Recherchez la variable Day Commons JDBC Connections Pool

  • Sélectionnez la + pour créer une configuration

    jdbcconnection1

  • 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 variable Connexion MySQL, par exemple, "activation".
  • Sélectionnez Enregistrer.

Configurer le score

Service AEM Communities ScormEngine

Configuration OSGi pour Service AEM Communities ScormEngine configure SCORM pour permettre à une communauté d’activation d’utiliser le serveur MySQL.

Cette configuration est présente lorsque la variable 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 variable Connexion JDBC config.

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

  • Connexion avec droits d’administrateur

  • Accédez au console web

  • Recherchez la variable AEM Communities ScormEngine Service

  • Sélectionner l’icône de modification

    scrom-engine

  • Vérifiez que les valeurs de paramètre suivantes sont conformes à la variable Connexion JDBC config :

    • 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 Scorm: 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 au console web

  • Localiser Adobe Granite CSRF Filter.

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

    jdbcconnection2

  • Sélectionnez la [+] pour ajouter un agent utilisateur sécurisé.

  • Enter Mozilla/*.

  • Sélectionnez Enregistrer.

Sur cette page