Stöd för RDBMS i AEM 6.4

Översikt

Stöd för relationsdatabasbeständighet i AEM implementeras med Document Microkernel. Dokumentmikrokärnan är grunden som också används för implementering av MongoDB-beständighet.

Det består av ett Java-API som baseras på Mongo Java API. En implementering av ett BlobStore API ingår också. Bloggar lagras som standard i databasen.

Mer information om implementeringen finns i dokumentationen RDBDocumentStore och RDBBlobStore.

OBSERVERA

Stöd finns också för PostgreSQL 9.4, men endast för demoändamål. Den kommer inte att vara tillgänglig för produktionsmiljöer.

Databaser som stöds

Mer information om nivån på Relational Database-stödet i AEM finns på sidan Technical Requirements.

Konfigurationssteg

Databasen skapas genom att OSGi-tjänsten konfigureras. DocumentNodeStoreService Det har utökats med stöd för relationsdatabasbeständighet utöver MongoDB.

För att en datakälla ska fungera måste den konfigureras med AEM. Detta görs via filen org.apache.sling.datasource.DataSourceFactory.config. JDBC-drivrutinerna för respektive databas måste anges separat som OSGi-paket i den lokala konfigurationen.

Anvisningar om hur du skapar OSGi-paket för JDBC-drivrutiner finns i den här dokumentationen på webbplatsen Apache Sling.

När paketen är på plats följer du stegen nedan för att konfigurera AEM med RDB-beständighet:

  1. Kontrollera att databasdaemon har startats och att du har en aktiv databas som kan användas med AEM.

  2. Kopiera AEM 6.3 burk till installationskatalogen.

  3. Skapa en mapp med namnet crx-quickstart\install i installationskatalogen.

  4. Konfigurera dokumentnodarkivet genom att skapa en konfigurationsfil med följande namn i katalogen crx-quickstart\install:

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

  5. Konfigurera datakällan och JDBC-parametrarna genom att skapa en annan konfigurationsfil med följande namn i mappen crx-quickstart\install:

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    OBSERVERA

    Mer information om datakällans konfiguration för varje databas som stöds finns i Konfigurationsalternativ för datakälla.

  6. Förbered sedan JDBC OSGi-paketen som ska användas med AEM:

    1. Skapa en mapp med namnet 9 i mappen crx-quickstart/install.

    2. Placera JDBC-behållaren i den nya mappen.

  7. Börja slutligen AEM med körningslägena crx3 och crx3rdb:

    java -jar quickstart.jar -r crx3,crx3rdb

Konfigurationsalternativ för datakälla

OSGi-konfigurationen org.apache.sling.datasource.DataSourceFactory-oak.config används för att konfigurera de parametrar som behövs för kommunikation mellan AEM och databasens beständighetslager.

Följande konfigurationsalternativ är tillgängliga:

  • datasource.name: Datakällans namn. Standardvärdet är oak.

  • url: URL-strängen för den databas som ska användas med JDBC. Varje databastyp har ett eget URL-strängformat. Mer information finns i URL-strängformat nedan.

  • driverClassName: Klassnamnet för JDBC-drivrutinen. Detta varierar beroende på vilken databas du vill använda och därefter vilken drivrutin som behövs för att ansluta till den. Nedan visas klassnamnen för alla databaser som stöds av AEM:

    • org.postgresql.Driver för PostgreSQL,
    • com.ibm.db2.jcc.DB2Driver för DB2,
    • oracle.jdbc.OracleDriver för Oracle,
    • com.mysql.jdbc.Driver MySQL och MariaDB (experimentell);
    • c om.microsoft.sqlserver.jdbc.SQLServerDriver för Microsoft SQL Server (experimentell).

  • username: Användarnamnet som databasen körs under.

  • password: Databaslösenordet.

URL-strängformat

Ett annat URL-strängformat används i datakällkonfigurationen beroende på vilken databastyp som ska användas. Nedan visas en lista över format för de databaser som AEM för närvarande stöder:

  • 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 MySQL och MariaDB (experimentell);
  • jdbc:sqlserver://localhost:1453;databaseName=name för Microsoft SQL Server (experimentell).

Kända begränsningar

Samtidigt bruk av flera AEM-instanser med en databas stöds av RDBMS-beständighet, men inte samtidiga installationer.

För att undvika detta måste du först köra installationen med en enda medlem och lägga till de andra efter att den första installationen är klar.

På denna sida