Documentatie AEM 6.4 Implementatiehandleiding

RDBMS-ondersteuning in AEM 6.4 rdbms-support-in-aem

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:
Configuring

Gemaakt voor:

Developer

CAUTION

AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Overzicht overview

Ondersteuning voor relationele databasedruk in AEM wordt geïmplementeerd met behulp van Document Microkernel. De Document Microkernel is de basis die ook wordt gebruikt voor de implementatie van MongoDB-persistentie.

Deze API bestaat uit een Java API die is gebaseerd op de API van Mongo Java. Er wordt ook een implementatie van een BlobStore-API geleverd. Standaard worden klodders opgeslagen in de database.

Voor meer informatie over de implementatiedetails raadpleegt u de RDBDocumentStore en RDBBlobStore documentatie.

NOTE

Ondersteuning voor PostgreSQL 9.4 wordt ook verstrekt, maar alleen voor demo-doeleinden. Het zal niet beschikbaar voor productiemilieu's zijn.

Ondersteunde databases supported-databases

Voor meer informatie over het niveau van de Relationele Steun van het Gegevensbestand in AEM, gelieve te zien Pagina Technische vereisten.

Configuratiestappen configuration-steps

De opslagplaats wordt gemaakt door de configuratie van de DocumentNodeStoreService OSGi-service. Naast MongoDB is de toepassing uitgebreid met ondersteuning voor relationele databasepersistentie.

Om het te werken, moet een gegevensbron met AEM worden gevormd. Dit gebeurt via de org.apache.sling.datasource.DataSourceFactory.config bestand. De bestuurders JDBC voor het respectieve gegevensbestand moeten afzonderlijk als bundels OSGi binnen de lokale configuratie worden verstrekt.

Voor stappen bij het maken van OSGi-bundels voor JDBC-stuurprogramma's raadpleegt u deze documentatie op de Apache Sling-website.

NOTE

Sommige SQL-stuurprogramma's zijn al verpakt als OSGi-bundels.

Als dit het geval is, kopieert u het jar-bestand naar install-path/crx-quickstart/install/9.

Nadat de bundels zijn geïnstalleerd, volgt u de onderstaande stappen om AEM te configureren met RDB-persistentie:

Zorg ervoor dat de databasdaemon is gestart en dat u een actieve database hebt voor gebruik met AEM.
Kopieer de AEM 6.3 jar in de installatiemap.
Een map maken met de naam crx-quickstart\install in de installatiemap.
Vorm de opslag van de documentknoop door een configuratiedossier met de volgende naam in te creëren crx-quickstart\install map:
- org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

Vorm de gegevensbron en de parameters JDBC door een ander configuratiedossier met de volgende naam in te creëren crx-quickstart\install map:

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

note note
NOTE
Voor gedetailleerde informatie over de gegevensbronconfiguratie voor elke gesteunde gegevensbestand, zie Configuratieopties gegevensbron.

Bereid daarna de bundels JDBC OSGi voor die met AEM moeten worden gebruikt:
1. Download het ZIP-archief van https://dev.mysql.com/downloads/connector/j/
  - version must be >= 5.1.38
2. Het gereedschap Extraheren mysql-connector-java-version-bin.jar (bundel) uit het archief
3. Gebruik de webconsole om de bundel te installeren en te starten:
  - Ga naar http://serveraddress:serverport/system/console/bundles
  - Selecteren Installeren/bijwerken
  - Blader naar de bundel die u uit het gedownloade ZIP-archief hebt uitgepakt
  - Controleren of JDBC-stuurprogramma van oracle Corporation voor MySQLcom.mysql.jdbc is actief en start het.

Ten slotte begint u AEM met de crx3 en crx3rdb runmodi:

code language-java
`java -jar quickstart.jar -r crx3,crx3rdb`

Configuratieopties gegevensbron data-source-configuration-options

De org.apache.sling.datasource.DataSourceFactory-oak.config De configuratie OSGi wordt gebruikt om de parameters te vormen nodig voor communicatie tussen AEM en de laag van de gegevensbestandpersistentie.

De volgende configuratieopties zijn beschikbaar:

datasource.name: De naam van de gegevensbron. De standaardwaarde is oak.
url: De URL-tekenreeks van de database die moet worden gebruikt met JDBC. Elk databasetype heeft een eigen URL-tekenreeksindeling. Zie voor meer informatie Opmaak URL-tekenreeks hieronder.
driverClassName: De naam van de JDBC-stuurprogrammaklasse. Dit verschilt afhankelijk van de database die u wilt gebruiken en vervolgens van het stuurprogramma dat nodig is om verbinding met de database te maken. Hieronder ziet u de klassenamen voor alle databases die worden ondersteund door AEM:
- org.postgresql.Driver voor PostgreSQL;
- com.ibm.db2.jcc.DB2Driver voor DB2;
- oracle.jdbc.OracleDriver voor Oracle;
- com.mysql.jdbc.Driver voor MySQL en MariaDB (experimenteel);
- c om.microsoft.sqlserver.jdbc.SQLServerDriver voor Microsoft SQL Server (experimenteel).
username: De gebruikersnaam waaronder de database wordt uitgevoerd.
password: Het databasewachtwoord.

Opmaak URL-tekenreeks url-string-formats

Afhankelijk van het databasetype dat moet worden gebruikt, wordt in de configuratie van de gegevensbron een andere indeling voor de URL-tekenreeks gebruikt. Hieronder volgt een lijst met indelingen voor de databases die momenteel AEM ondersteunen:

jdbc:postgresql:databasename voor PostgreSQL;
jdbc:db2://localhost:port/databasename voor DB2;
jdbc:oracle:thin:localhost:port:SID voor Oracle;
jdbc:mysql://localhost:3306/databasename voor MySQL en MariaDB (experimenteel);
jdbc:sqlserver://localhost:1453;databaseName=name voor Microsoft SQL Server (experimenteel).

Bekende beperkingen known-limitations

Hoewel gelijktijdig gebruik van meerdere AEM instanties met één database wordt ondersteund door RDBMS-persistentie, zijn gelijktijdige installaties niet mogelijk.

Als u dit wilt omzeilen, moet u eerst de installatie uitvoeren met één lid en de andere leden toevoegen nadat de eerste installatie is voltooid.

recommendation-more-help

6a71a83d-c2e0-4ce7-a6aa-899aa3885b56