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.
Stöd för PostgreSQL 9.4 tillhandahålls också, 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öd i AEM finns i sidan Tekniska krav.
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:
Kontrollera att databasdaemon har startats och att du har en aktiv databas som kan användas med AEM.
Copy the AEM 6.3 jar into the installation directory.
Skapa en mapp med namnet crx-quickstart\install
i installationskatalogen.
Konfigurera dokumentnodarkivet genom att skapa en konfigurationsfil med följande namn i crx-quickstart\install
katalog:
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 crx-quickstart\install
mapp:
org.apache.sling.datasource.DataSourceFactory-oak.config
Detaljerad information om datakällkonfigurationen 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:
I crx-quickstart/install
mapp, skapa en mapp med namnet 9
.
Placera JDBC-behållaren i den nya mappen.
Till sist AEM du med crx3
och crx3rdb
runmodes:
java -jar quickstart.jar -r crx3,crx3rdb
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);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.