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 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 MySQL Workbench
• Installieren Sie auf allen AEM die 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
• Im [mysqld] -Abschnitt, fügen Sie 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
• Im [client] -Abschnitt, fügen Sie die folgende Zeile hinzu:
  default-character-set=utf8
• Im [mysqld] -Abschnitt, fügen Sie 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 dem Symbol "+"das Symbol MySQL Connections.
2. Im Dialogfeld Setup New ConnectionGeben Sie Werte ein, die für Ihre Plattform zu Demonstrationszwecken geeignet sind, 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. Auswählen Test Connection Überprüfen der Verbindung zum ausgeführten MySQL-Dienst

Anmerkungen:

• Der Standardanschluss ist 3306
• Die Connection Name ausgewählt wird, wird als datasource name in JDBC OSGi-Konfiguration

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. Die SCORM-Paket muss installiert sein:

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

Eine Methode zum Herunterladen des Schemas besteht darin,

• Wählen Sie die jcr:contentKnoten für die SQL-Datei
• Beachten Sie den Wert für jcr:data-Eigenschaft ist ein Ansichtslink
• 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 (
    open, execute), um jede SQL-Skript . Aktualisieren wenn nötig, 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 die lightening (flash) icon , um das Skript auszuführen.

Beachten Sie, dass die database_scormengine.sql -Skript zur Erstellung der SCORM-Datenbank benötigen, kann es eine Minute dauern.

Aktualisieren

Nach Ausführung der Skripte muss die SCHEMASAbschnitt Navigator um die neue Datenbank zu sehen. Verwenden Sie das Aktualisierungssymbol rechts neben "SCHEMAS":

Ergebnis: scormenginedb

Nach der Installation und Aktualisierung von SCHEMAS wird die 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 Hostname des Servers anstelle von "localhost"im JDBC-Connector angegeben werden (der den ScormEngine config).

• In jeder AEM der Autoren- und Veröffentlichungsinstanz
• Mit Administratorrechten angemeldet
• Zugriff auf Webkonsole
  • Beispiel: http://localhost:4502/system/console/configMgr
• Suchen Sie die Day Commons JDBC Connections Pool
• Wählen Sie die + Symbol zum Erstellen einer neuen Konfiguration

• Geben Sie die folgenden Werte ein:
  • JDBC-Treiberklasse: com.mysql.jdbc.Driver
  • DBC-Verbindung 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"
  • Passwort: 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: Der für die MySQL-Verbindung, z. B. "Aktivierung"
• Wählen Sie Speichern aus

Scorm konfigurieren

AEM Communities ScormEngine-Dienst

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

Diese Konfiguration ist vorhanden, wenn die 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 dem JDBC-Verbindung config.

• In jeder AEM der Autoren- und Veröffentlichungsinstanz
• Mit Administratorrechten angemeldet
• Zugriff auf Webkonsole
  • Beispiel: http://localhost:4502/system/console/configMgr
• Suchen Sie die AEM Communities ScormEngine Service
• Bearbeiten-Symbol auswählen
  
• Stellen Sie sicher, dass die folgenden Parameterwerte mit dem JDBC-Verbindung config:
  • JDBC-Verbindungs-URI: jdbc:mysql://localhost:3306/ScormEngineDB ScormEngineDB ist der standardmäßige Datenbankname in SQL-Skripten
  • Benutzername: Stamm oder geben Sie den konfigurierten Benutzernamen für den MySQL-Server ein, falls nicht "root"
  • Passwort: 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 Webkonsole
  • Beispiel: http://localhost:4503/system/console/configMgr
• Suchen Adobe Granite CSRF Filter
• Bearbeiten-Symbol auswählen
  
• Wählen Sie die [+] Symbol zum Hinzufügen eines sicheren Benutzeragenten
• Geben Sie Mozilla/* ein
• Wählen Sie Speichern aus