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.
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.
Mer information om nivån på Relational Database-stödet i AEM finns på sidan Technical Requirements.
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:
Kontrollera att databasdaemon har startats och att du har en aktiv databas som kan användas med AEM.
Kopiera AEM 6.3 burk till installationskatalogen.
Skapa en mapp med namnet crx-quickstart\install
i installationskatalogen.
Konfigurera dokumentnodarkivet genom att skapa en konfigurationsfil med följande namn i katalogen crx-quickstart\install
:
org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
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
Mer information om datakällans konfiguration för varje databas som stöds finns i Konfigurationsalternativ för datakälla.
Förbered sedan JDBC OSGi-paketen som ska användas med AEM:
Skapa en mapp med namnet 9
i mappen crx-quickstart/install
.
Placera JDBC-behållaren i den nya mappen.
Börja slutligen AEM med körningslägena crx3
och crx3rdb
:
java -jar quickstart.jar -r crx3,crx3rdb
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);om.microsoft.sqlserver.jdbc.SQLServerDriver
för Microsoft SQL Server (experimentell).username:
Användarnamnet som databasen körs under.
password:
Databaslösenordet.
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).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.