Prise en charge RDBMS dans AEM 6.4 rdbms-support-in-aem

Présentation overview

La prise en charge de la persistance de la base de données relationnelle dans AEM est mise en oeuvre à l’aide de Document Microkernel. Document Microkernel est la base qui est également utilisée pour mettre en oeuvre la persistance de MongoDB.

Il se compose d’une API Java basée sur l’API Java Mongo. Une implémentation d’une API BlobStore est également fournie. Par défaut, les blobs sont stockés dans la base de données.

Pour plus d’informations sur les détails de mise en oeuvre, voir la section RDBDocumentStore et RDBBlobStore la documentation.

NOTE
Prise en charge de PostgreSQL 9.4 est également fourni, mais uniquement à des fins de démonstration. Elle ne sera pas disponible pour les environnements de production.

Bases de données prises en charge supported-databases

Pour plus d’informations sur le niveau de prise en charge de la base de données relationnelle dans AEM, voir la section Page Exigences techniques.

Étapes de configuration configuration-steps

Le référentiel est créé lors de la configuration du service OSGi DocumentNodeStoreService. Il a été étendu pour prendre en charge la persistance de la base de données relationnelle en plus de MongoDB.

Pour qu’elle fonctionne, une source de données doit être configurée avec AEM. Cela s’effectue via le fichier org.apache.sling.datasource.DataSourceFactory.config. Les pilotes JDBC pour les bases de données respectives doivent être fournis séparément en tant que lots OSGi dans la configuration locale.

Pour obtenir des instructions sur la création de lots OSGi pour les pilotes JDBC, voir ceci documentation sur le site web Apache Sling.

Une fois les lots en place, suivez les étapes ci-dessous pour configurer AEM avec la persistance RDB :

  1. Assurez-vous que la base de données daemon est lancée et que votre base de données est active et prête à être utilisée avec AEM.

  2. Copiez le jar AEM 6.3 dans le répertoire de l’installation.

  3. Créez un dossier nommé crx-quickstart\install dans le répertoire de l’installation.

  4. Configurez l’entrepôt de nœud de document en créant un fichier de configuration avec le nom suivante dans le répertoire crx-quickstart\install :

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
  5. Configurez la source de données et les paramètres JDBC en créant un autre fichier de configuration avec le nom suivant dans le dossier crx-quickstart\install :

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    note note
    NOTE
    Pour plus d’informations sur la configuration de chaque base de données prise en charge, consultez les Options de configuration de la source de données.
  6. Ensuite, préparez les lots OSGi JDBC à utiliser avec AEM :

    1. Dans le fichier crx-quickstart/install, créez un dossier nommé 9.

    2. Placez le jar JDBC dans le nouveau dossier.

  7. Enfin, lancez AEM avec les modes d’exécution crx3 et crx3rdb :

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

Options de configuration des sources de données data-source-configuration-options

La configuration OSGi de org.apache.sling.datasource.DataSourceFactory-oak.config sert à configurer les paramètres nécessaires pour établir la communication entre AEM et la couche de persistance de la base de données.

Les options de configuration suivantes sont disponibles :

  • datasource.name: Le nom de la source de données. La valeur par défaut est oak.

  • url: La chaîne URL de la base de données qui doit être utilisée avec JDBC. Chaque type de base de données est doté de son propre format de chaîne d’URL. Pour plus d’informations, reportez-vous à la section Formats de chaîne d’URL ci-dessous.

  • driverClassName: Le nom de classe du pilote JDBC. Cela varie en fonction de la base de données que vous souhaitez utiliser et du pilote nécessaire pour s’y connecter. Vous trouverez ci-dessous les noms de classe pour toutes les bases de données prises en charge par AEM :

    • org.postgresql.Driver pour PostgreSQL
    • com.ibm.db2.jcc.DB2Driver pour DB2
    • oracle.jdbc.OracleDriver pour Oracle
    • com.mysql.jdbc.Driver pour MySQL et MariaDB (stade expérimental)
    • c om.microsoft.sqlserver.jdbc.SQLServerDriver pour Microsoft SQL Server (stade expérimental)
  • username: Le nom d’utilisateur avec lequel la base de données est exécutée.

  • password: Mot de passe de la base de données.

Formats de chaîne d’URL url-string-formats

Un format de chaîne URL différent est utilisé dans la configuration de la source de données en fonction du type de base de données à utiliser. Vous trouverez ci-dessous une liste de formats pour les bases de données actuellement prises en charge par AEM :

  • jdbc:postgresql:databasename pour PostgreSQL
  • jdbc:db2://localhost:port/databasename pour DB2
  • jdbc:oracle:thin:localhost:port:SID pour Oracle
  • jdbc:mysql://localhost:3306/databasename pour MySQL et MariaDB (stade expérimental)
  • jdbc:sqlserver://localhost:1453;databaseName=name pour Microsoft SQL Server (stade expérimental)

Limites connues known-limitations

Bien que l’utilisation simultanée de plusieurs instances d’AEM avec une seule base de données soit prise en charge par la persistance du SGBDR, les installations simultanées ne le sont pas.

Pour contourner ce problème, assurez-vous d’exécuter d’abord l’installation avec un seul membre et d’ajouter les autres à la fin de l’installation.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2