MySQL-Konfiguration für Aktivierungsfunktionen

MySQL ist eine relationale Datenbank, die hauptsächlich für SCORM-Tracking- und Reporting-Daten für Aktivierungsressourcen verwendet wird. Dazu gehören Tabellen für andere Funktionen wie das Tracking von angehaltenen/wiederaufgenommenen Videos.

In diesen Anweisungen wird beschrieben, wie Sie eine Verbindung zum MySQL-Server herstellen, die Aktivierungsdatenbank einrichten und die Datenbank mit Anfangsdaten füllen.

Voraussetzungen

Stellen Sie vor der Konfiguration der Aktivierungsfunktion von MySQL für Communities sicher, dass Sie

• Installieren Sie MySQL Server Community-Server Version 5.6
  • Version 5.7 wird für SCORM nicht unterstützt
  • Kann derselbe Server wie AEM Autoreninstanz sein
• Installieren Sie auf allen AEM Instanzen den offiziellen JDBC-Treiber für MySQL
• Installieren Sie MySQL Workbench
• Installieren Sie auf allen AEM das SCORM-Paket.

MySQL installieren

MySQL sollte heruntergeladen und entsprechend den Anweisungen für das Zielbetriebssystem installiert werden.

Tabellennamen mit Kleinbuchstaben

Da bei SQL nicht zwischen Groß- und Kleinschreibung unterschieden wird, müssen bei Betriebssystemen, bei denen zwischen Groß- und Kleinschreibung unterschieden wird, alle Tabellennamen in Kleinbuchstaben geschrieben werden.

So geben Sie beispielsweise alle Tabellennamen mit Kleinbuchstaben unter Linux an:

• Datei bearbeiten /etc/my.cnf
• Fügen Sie im Abschnitt [mysqld] die folgende Zeile hinzu:
  lower_case_table_names = 1

UTF8-Zeichensatz

Um eine bessere mehrsprachige Unterstützung zu bieten, ist es erforderlich, den UTF8-Zeichensatz zu verwenden.

Ändern Sie MySQL so, dass UTF8 als Zeichensatz verwendet wird:

• mysql> SET NAMES 'utf8';

Ändern Sie die MySQL-Datenbank in UTF8:

• Datei bearbeiten /etc/my.cnf
• Fügen Sie im Abschnitt [client] die folgende Zeile hinzu:
  default-character-set=utf8
• Fügen Sie im Abschnitt [mysqld] die folgende Zeile hinzu:
  character-set-server=utf8

Installieren von MySQL Workbench

MySQL Workbench bietet eine Benutzeroberfläche zum Ausführen von SQL-Skripten, die das Schema und die Anfangsdaten installieren.

MySQL Workbench sollte heruntergeladen und entsprechend den Anweisungen für das Zielbetriebssystem installiert werden.

Aktivierungsverbindung

Wenn die MySQL Workbench zum ersten Mal gestartet wird, sofern sie nicht bereits für andere Zwecke verwendet wird, werden noch keine Verbindungen angezeigt:

Neue Verbindungseinstellungen

1. Wählen Sie rechts neben MySQL Connections das Symbol "+"aus.
2. Geben Sie im Dialogfeld Setup New Connection die für Ihre Plattform geeigneten Werte zu Demonstrationszwecken ein, wobei sich die Autoreninstanz AEM MySQL auf demselben Server befindet:
   • Verbindungsname: Enablement
   • Verbindungsmethode: Standard (TCP/IP)
   • Hostname: 127.0.0.1
   • Benutzername: root
   • Passwort: no password by default
   • Standardschema: leave blank
3. Wählen Sie Test Connection aus, um die Verbindung zum ausgeführten MySQL-Dienst zu überprüfen.

Anmerkungen:

• Der Standardanschluss ist 3306
• Der ausgewählte Connection Name wird als datasource Name in JDBC OSGi-Konfiguration angegeben.

Erfolgreiche Verbindung

Neue Aktivierungsverbindung

Datenbankeinrichtung

Beachten Sie beim Öffnen der neuen Aktivierungsverbindung, dass es ein Testschema und standardmäßige Benutzerkonten gibt.

Abrufen von SQL-Skripten

Die SQL-Skripte werden mithilfe der CRXDE Lite in der Autoreninstanz abgerufen. Das SCORM-Paket muss installiert sein:

1. Zur CRXDE Lite navigieren
   • Beispiel: http://localhost:4502/crx/de
2. Erweitern Sie den Ordner /libs/social/config/scorm/ .
3. Download database_scormengine.sql
4. database_scorm_integration.sql herunterladen

Eine Methode zum Herunterladen des Schemas besteht darin,

• Wählen Sie den Knoten jcr:contentfür die SQL-Datei aus.
• Beachten Sie, dass der Wert für die Eigenschaft jcr:dataein Ansichtslink ist.
• Klicken Sie auf den Ansichtslink, um die Daten in einer lokalen Datei zu speichern.

SCORM-Datenbank erstellen

Die zu erstellende Aktivierungs-SCORM-Datenbank lautet:

• name: ScormEngineDB
• erstellt aus Skripten:
  • schema: database_scormengine.sql
  • data: database_scorm_integration.sql
    Führen Sie die folgenden Schritte aus (
    Öffnen, Ausführen), um jedes SQL-Skript zu installieren. 🔗 Falls erforderlich, aktualisieren Sie, um die Ergebnisse der Skriptausführung anzuzeigen.

Installieren Sie das Schema, bevor Sie die Daten installieren.

Schritt 1: SQL-Datei öffnen

In der MySQL Workbench

• Über das Pulldown-Menü Datei
• Wählen Sie nun eine der folgenden Optionen aus Open SQL Script ...
• Wählen Sie in dieser Reihenfolge eine der folgenden Optionen aus:
  1. database_scormengine.sql
  2. database_scorm_integration.sql

Schritt 2: SQL-Skript ausführen

Wählen Sie im Workbench-Fenster für die in Schritt 1 geöffnete Datei lightening (flash) icon aus, um das Skript auszuführen.

Beachten Sie, dass die Ausführung des Skripts database_scormengine.sql zum Erstellen der SCORM-Datenbank möglicherweise eine Minute in Anspruch nehmen kann.

Aktualisieren

Nachdem die Skripte ausgeführt wurden, muss der Abschnitt SCHEMASdes Abschnitts Navigator aktualisiert werden, damit die neue Datenbank angezeigt wird. Verwenden Sie das Aktualisierungssymbol rechts neben "SCHEMAS":

Ergebnis: scormenginedb

Nach der Installation und Aktualisierung von SCHEMAS wird das scormenginedb angezeigt.

JDBC-Verbindungen konfigurieren

Die OSGi-Konfiguration für Day Commons JDBC Connections Pool konfiguriert den MySQL JDBC-Treiber.

Alle Veröffentlichungs- und AEM-Instanzen sollten auf denselben MySQL-Server verweisen.

Wenn MySQL auf einem Server ausgeführt wird, der sich von AEM unterscheidet, muss der Server-Hostname anstelle von "localhost"im JDBC-Connector angegeben werden (der die ScormEngine-Konfiguration füllt).

• In jeder AEM der Autoren- und Veröffentlichungsinstanz
• Mit Administratorrechten angemeldet
• Zugriff auf die Web-Konsole
  • Beispiel: http://localhost:4502/system/console/configMgr
• Suchen Sie nach Day Commons JDBC Connections Pool .
• Wählen Sie das Symbol + aus, um eine neue Konfiguration zu erstellen

• Geben Sie die folgenden Werte ein:
  • JDBC-Treiberklasse: com.mysql.jdbc.Driver
  • DBC connection URIJ: jdbc:mysql://localhost:3306/aem63reporting den Server anstelle von localhost angeben, wenn der MySQL-Server nicht mit dem 'this'-AEM Server übereinstimmt
  • Benutzername: Stamm oder geben Sie den konfigurierten Benutzernamen für den MySQL-Server ein, falls nicht "root"
  • Kennwort: Löschen Sie dieses Feld, wenn kein Kennwort für MySQL festgelegt ist. Geben Sie andernfalls das konfigurierte Kennwort für den MySQL-Benutzernamen ein.
  • Datenquellenname: Name, der für die MySQL-Verbindung eingegeben wurde, z. B. "Aktivierung"
• Wählen Sie Speichern aus

Scorm konfigurieren

AEM Communities ScormEngine-Dienst

Die OSGi-Konfiguration für AEM Communities ScormEngine Service konfiguriert SCORM für die Verwendung des MySQL-Servers durch eine Aktivierungs-Community.

Diese Konfiguration ist vorhanden, wenn das SCORM-Paket installiert ist.

Alle Veröffentlichungs- und Autoreninstanzen verweisen auf denselben MySQL-Server.

Wenn MySQL auf einem Server ausgeführt wird, der sich von AEM unterscheidet, muss der Server-Hostname anstelle von "localhost"im ScormEngine-Dienst angegeben werden, der normalerweise aus der JDBC Connection-Konfiguration gefüllt wird.

• In jeder AEM der Autoren- und Veröffentlichungsinstanz
• Mit Administratorrechten angemeldet
• Zugriff auf die Web-Konsole
  • Beispiel: http://localhost:4502/system/console/configMgr
• Suchen Sie nach AEM Communities ScormEngine Service .
• Bearbeiten-Symbol auswählen
  
• Stellen Sie sicher, dass die folgenden Parameterwerte mit der JDBC Connection-Konfiguration übereinstimmen:
  • JDBC-Verbindungs-URI: jdbc:mysql://localhost:3306/ScormEngineDB ** ScormEngineDBist der standardmäßige Datenbankname in den SQL-Skripten
  • Benutzername: Stamm oder geben Sie den konfigurierten Benutzernamen für den MySQL-Server ein, falls nicht "root"
  • Kennwort: Löschen Sie dieses Feld, wenn kein Kennwort für MySQL festgelegt ist. Geben Sie andernfalls das konfigurierte Kennwort für den MySQL-Benutzernamen ein.
• Für den folgenden Parameter:

  • Scorm-Benutzerkennwort: NICHT BEARBEITEN

    Nur zur internen Verwendung. Es ist für einen speziellen Dienstbenutzer bestimmt, der von AEM Communities zur Kommunikation mit der Scorm-Engine verwendet wird.

• Wählen Sie Speichern aus

Adobe Granite CSRF-Filter

Um sicherzustellen, dass Aktivierungskurse in allen Browsern ordnungsgemäß funktionieren, muss Mozilla als Benutzeragent hinzugefügt werden, der nicht vom CSRF-Filter überprüft wird.

• Bei jeder AEM-Instanz
• Mit Administratorrechten angemeldet
• Zugriff auf die Web-Konsole
  • Beispiel: http://localhost:4503/system/console/configMgr
• Suchen Sie Adobe Granite CSRF Filter .
• Bearbeiten-Symbol auswählen
  
• Wählen Sie das Symbol [+] aus, um einen sicheren Benutzeragenten hinzuzufügen.
• Geben Sie Mozilla/* ein
• Wählen Sie Speichern aus