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 är baserat på Mongo Java API. En implementering av ett BlobStore API ingår också. Bloggar lagras som standard i databasen.

Mer information om implementeringsdetaljer finns i RDBDocumentStore och RDBBlobStore dokumentation.

Databaser som stöds

Mer information om nivån på Relational Database-stöd i AEM finns i sidan Tekniska krav.

Konfigurationssteg

Databasen skapas genom att DocumentNodeStoreService OSGi-tjänst. 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 org.apache.sling.datasource.DataSourceFactory.config -fil. 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 det här dokumentation 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. Copy the AEM 6.3 jar into the installation directory.

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

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

   • 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 crx-quickstart\install mapp:

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

   Detaljerad information om datakällkonfigurationen 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. I crx-quickstart/install mapp, skapa en mapp med namnet 9.

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

7. Till sist AEM du med crx3 och crx3rdb runmodes:

   java -jar quickstart.jar -r crx3,crx3rdb
   

Konfigurationsalternativ för datakälla

The org.apache.sling.datasource.DataSourceFactory-oak.config OSGi-konfigurationen 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 på 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.