DokumentationAEM 6.4Communities-Anleitung

MySQL-Konfiguration für Aktivierungsfunktionen mysql-configuration-for-enablement-features

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

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 requirements

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 installing-mysql

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

Tabellennamen mit Kleinbuchstaben lower-case-table-names

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 utf-character-set

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 installing-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 enablement-connection

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

chlimage_1-327

Neue Verbindungseinstellungen new-connection-settings

  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 successful-connection

chlimage_1-328

Neue Aktivierungsverbindung new-enablement-connection

chlimage_1-329

Datenbankeinrichtung database-setup

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

chlimage_1-330

Abrufen von SQL-Skripten obtain-sql-scripts

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

  1. Zur CRXDE Lite navigieren
  2. Erweitern Sie die /libs/social/config/scorm/ Ordner
  3. Herunterladen database_scormengine.sql
  4. Herunterladen database_scorm_integration.sql

chlimage_1-331

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 create-scorm-database

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.

CAUTION
Wenn der Datenbankname geändert wird, geben Sie ihn in

Schritt 1: SQL-Datei öffnen step-open-sql-file

In der MySQL Workbench

  • Über das Pulldown-Menü Datei

  • Klicken Sie auf Open SQL Script ...

  • Wählen Sie in dieser Reihenfolge eine der folgenden Optionen aus:

    1. database_scormengine.sql
    2. database_scorm_integration.sql

chlimage_1-332

Schritt 2: SQL-Skript ausführen step-execute-sql-script

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.

chlimage_1-333

Aktualisieren refresh

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

chlimage_1-334

Ergebnis: scormenginedb result-scormenginedb

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

chlimage_1-335

JDBC-Verbindungen konfigurieren configure-jdbc-connections

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
  • Suchen Sie die Day Commons JDBC Connections Pool
  • Wählen Sie die + Symbol zum Erstellen einer neuen Konfiguration

chlimage_1-336

  • 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 configure-scorm

AEM Communities ScormEngine-Dienst aem-communities-scormengine-service

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

  • Suchen Sie die AEM Communities ScormEngine Service

  • Bearbeiten-Symbol auswählen
    chlimage_1-337

  • 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 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
  • Suchen Adobe Granite CSRF Filter
  • Bearbeiten-Symbol auswählen
    chlimage_1-338
  • Wählen Sie die [+] Symbol zum Hinzufügen eines sicheren Benutzeragenten
  • Geben Sie Mozilla/* ein
  • Wählen Sie Speichern aus
recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6