RDBMS-Unterstützung in AEM 6.4 rdbms-support-in-aem

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.

Überblick overview

Die Unterstützung der relativen Datenbankpersistenz in AEM wird mithilfe des Document Microkernel implementiert. Der Document Microkernel ist die Grundlage, die auch für die Implementierung der MongoDB-Persistenz verwendet wird.

Er umfasst eine Java-API, die auf der Mongo-Java-API basiert. Eine BlobStore-API wird ebenfalls implementiert. Standardmäßig werden Blobs in der Datenbank gespeichert.

Weitere Informationen zu den Implementierungsdetails finden Sie im RDBDocumentStore und RDBBlobStore Dokumentation.

NOTE
Unterstützung für PostgreSQL 9.4 wird ebenfalls bereitgestellt, jedoch nur zu Demozwecken. Sie ist nicht für Produktionsumgebungen verfügbar.

Unterstützte Datenbanken supported-databases

Weitere Informationen zur Unterstützung relationaler Datenbanken in AEM finden Sie auf der Seite mit den technischen Anforderungen.

Konfigurationsschritte configuration-steps

Das Repository wird durch Konfigurieren des OSGi-Dienstes DocumentNodeStoreService erstellt. Es wurde erweitert, um neben MongoDB auch die Persistenz der relationalen Datenbank zu unterstützen.

Um diese nutzen zu können, muss eine Datenquelle mithilfe von AEM konfiguriert werden. Dies geschieht über die Datei org.apache.sling.datasource.DataSourceFactory.config. Die JDBC-Treiber für die jeweilige Datenbank müssen separat als OSGi-Bundles in der lokalen Konfiguration bereitgestellt werden.

Anweisungen zum Erstellen von OSGi-Bundles für JDBC-Treiber finden Sie in diesem Dokumentation auf der Apache Sling-Website.

NOTE
Einige der SQL-Treiber sind bereits als OSGi-Bundles gepackt.
Wenn dies der Fall ist, kopieren Sie einfach die JAR-Datei in install-path/crx-quickstart/install/9.

Nachdem die Bundles eingerichtet sind, führen Sie die folgenden Schritte aus, um AEM mit RDB-Persistenz zu konfigurieren:

  1. Stellen Sie sicher, dass der Datenbank-Daemon gestartet ist und eine aktive Datenbank für die Verwendung mit AEM vorhanden ist.

  2. Kopieren Sie die AEM 6.3-JAR-Datei in das Installationsverzeichnis.

  3. Erstellen Sie im Installationsverzeichnis einen Ordner namens crx-quickstart\install.

  4. Konfigurieren Sie den Document-Knotenspeicher, indem Sie eine Konfigurationsdatei mit dem folgenden Namen im Verzeichnis crx-quickstart\install erstellen:

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
  5. Erstellen Sie eine weitere Konfigurationsdatei mit dem folgenden Namen im Ordner crx-quickstart\install, um die Datenquelle und die JDBC-Parameter zu konfigurieren:

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    note note
    NOTE
    Detaillierte Informationen zur Datenquellenkonfiguration für die einzelnen unterstützten Datenbanken finden Sie unter Konfigurationsoptionen für die Datenquelle.
  6. Bereiten Sie dann die JDBC-OSGi-Bundles für die Verwendung mit AEM vor:

    1. Laden Sie das ZIP-Archiv von https://dev.mysql.com/downloads/connector/j/ herunter.

      • Version muss >= 5.1.38 sein.
    2. Extrahieren Sie die mysql-connector-java-version-bin.jar (Bundle) aus dem Archiv

    3. Verwenden Sie die Web-Konsole, um das Bundle zu installieren und zu starten:

      • Navigieren Sie zu http://serveraddress:serverport/system/console/bundles
      • Auswählen Installieren/Aktualisieren
      • Navigieren Sie zum Paket, das aus dem heruntergeladenen ZIP-Archiv extrahiert wurde.
      • Vergewissern Sie sich, dass JDBC-Treiber der oracle Corporation für MySQLcom.mysql.jdbc aktiv ist, und starten Sie es.
  7. Starten Sie abschließend AEM mit den Ausführungsmodi crx3 und crx3rdb:

    code language-java
    java -jar quickstart.jar -r crx3,crx3rdb
    

Konfigurationsoptionen für die Datenquelle data-source-configuration-options

Die OSGi-Konfiguration org.apache.sling.datasource.DataSourceFactory-oak.config dient zum Konfigurieren der erforderlichen Parameter für die Kommunikation zwischen AEM und der Datenbank-Persistenz-Schicht.

Folgende Konfigurationsoptionen sind verfügbar:

  • datasource.name: Der Name der Datenquelle. Der Standardwert lautet oak.

  • url: Die URL-Zeichenfolge der Datenbank, die mit JDBC verwendet werden muss. Jeder Datenbanktyp hat ein eigenes Format für die URL-Zeichenfolge. Weitere Informationen finden Sie nachfolgend unter URL-Zeichenfolgenformate.

  • driverClassName: Der Name der JDBC-Treiberklasse. Dieser variiert je nach der zu verwendenden Datenbank und dem Treiber, der für die Verbindung mit derselben benötigt wird. Nachfolgend finden Sie die Klassennamen aller von AEM unterstützten Datenbanken:

    • org.postgresql.Driver für PostgreSQL;
    • com.ibm.db2.jcc.DB2Driver für DB2;
    • oracle.jdbc.OracleDriver für Oracle;
    • com.mysql.jdbc.Driver für MySQL und MariaDB (experimentell)
    • com.microsoft.sqlserver.jdbc.SQLServerDriver für Microsoft SQL Server (experimentell)
  • username: Der Benutzername, unter dem die Datenbank ausgeführt wird.

  • password: Das Datenbankkennwort.

URL-Zeichenfolgenformate url-string-formats

Je nach dem zu verwendenden Datenbanktyp wird ein unterschiedliches URL-Zeichenfolgenformat in der Datenquellenkonfiguration verwendet. Nachstehend finden Sie eine Liste der Formate für die Datenbanken, die derzeit AEM unterstützt:

  • jdbc:postgresql:databasename für PostgreSQL;

  • jdbc:db2://localhost:port/databasename für DB2;

  • jdbc:oracle:thin:localhost:port:SID für Oracle;

  • jdbc:mysql://localhost:3306/databasename für MySQL und MariaDB (experimentell)

  • jdbc:sqlserver://localhost:1453;databaseName=name für Microsoft SQL Server (experimentell)

Bekannte Einschränkungen known-limitations

Die gleichzeitige Verwendung mehrerer AEM Instanzen mit einer einzigen Datenbank wird zwar durch die RDBMS-Persistenz unterstützt, gleichzeitige Installationen jedoch nicht.

Um dieses Problem zu umgehen, führen Sie zuerst die Installation mit nur einer Instanz aus und fügen Sie dann nach Abschluss derselben weitere hinzu.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56