Stöd för RDBMS i AEM 6.4 rdbms-support-in-aem
Ökning overview
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 supported-databases
Mer information om nivån på Relational Database-stöd i AEM finns i sidan Tekniska krav.
Konfigurationssteg configuration-steps
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
note note NOTE 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 namnet9
. -
Placera JDBC-behållaren i den nya mappen.
-
-
Till sist AEM du med
crx3
ochcrx3rdb
runmodes:code language-java java -jar quickstart.jar -r crx3,crx3rdb
Konfigurationsalternativ för datakälla data-source-configuration-options
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 äroak
. -
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 url-string-formats
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 known-limitations
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.