DocumentazioneAEM 6.4Guida alla distribuzione

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

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

Creato per:

  • Developer
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Panoramica overview

Il supporto per la persistenza del database relazionale in AEM viene implementato utilizzando il Microsoft Document. Il Document Microkernel è la base utilizzata anche per implementare la persistenza MongoDB.

È costituito da un’API Java basata sull’API Java Mongo. Viene inoltre fornita un’implementazione di un’API BlobStore. Per impostazione predefinita, i BLOB sono memorizzati nel database.

Per ulteriori informazioni sui dettagli di implementazione, consulta la RDBDocumentStore e RDBBlobStore documentazione.

NOTE
Supporto per PostgreSQL 9.4 viene fornito anche, ma solo a scopo dimostrativo. Non sarà disponibile per gli ambienti di produzione.

Database supportati supported-databases

Per ulteriori informazioni sul livello di supporto del database relazionale in AEM, vedere la Pagina Requisiti tecnici.

Passaggi di configurazione configuration-steps

L’archivio viene creato configurando il DocumentNodeStoreService Servizio OSGi. È stato esteso per supportare la persistenza del database relazionale oltre a MongoDB.

Affinché funzioni, è necessario configurare un’origine dati con AEM. Questo avviene tramite il org.apache.sling.datasource.DataSourceFactory.config file. I driver JDBC per il rispettivo database devono essere forniti separatamente come bundle OSGi all'interno della configurazione locale.

Per i passaggi sulla creazione di bundle OSGi per i driver JDBC, consulta questo documentazione sul sito web Apache Sling.

NOTE
Alcuni dei driver SQL sono già inclusi nel pacchetto come bundle OSGi.
Se questo è il caso, allora basta copiare il file jar in install-path/crx-quickstart/install/9.

Una volta installati i bundle, segui i passaggi seguenti per configurare AEM con la persistenza RDB:

  1. Assicurati che il daemon di database sia avviato e che sia presente un database attivo da utilizzare con AEM.

  2. Copia il jar AEM 6.3 nella directory di installazione.

  3. Crea una cartella denominata crx-quickstart\install nella directory di installazione.

  4. Configura l'archivio dei nodi del documento creando un file di configurazione con il seguente nome nel crx-quickstart\install directory:

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

  5. Configura l’origine dati e i parametri JDBC creando un altro file di configurazione con il seguente nome nella crx-quickstart\install cartella:

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    note note
    NOTE
    Per informazioni dettagliate sulla configurazione dell'origine dati per ciascun database supportato, vedere Opzioni di configurazione dell’origine dati.

  6. Quindi, prepara i bundle JDBC OSGi da utilizzare con AEM:

    1. Scarica l'archivio ZIP da https://dev.mysql.com/downloads/connector/j/

      • La versione deve essere >= 5.1.38

    2. Estrai il mysql-connector-java-version-bin.jar (bundle) dall'archivio

    3. Usa la console web per installare e avviare il bundle :

      • Vai a http://serveraddress:serverport/system/console/bundles
      • Seleziona Installazione/aggiornamento
      • Sfoglia per selezionare il bundle estratto dall'archivio ZIP scaricato
      • Controlla che Driver JDBC di Oracle Corporation per MySQLcom.mysql.jdbc è attivo e lo avvia.

  7. Infine, inizia AEM con il crx3 e crx3rdb modalità di esecuzione:

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

Opzioni di configurazione dell’origine dati data-source-configuration-options

La org.apache.sling.datasource.DataSourceFactory-oak.config La configurazione OSGi viene utilizzata per configurare i parametri necessari per la comunicazione tra AEM e il livello di persistenza del database.

Sono disponibili le seguenti opzioni di configurazione:

  • datasource.name: Nome dell'origine dati. Il valore predefinito è oak.

  • url: Stringa URL del database che deve essere utilizzata con JDBC. Ogni tipo di database ha il proprio formato stringa URL. Per ulteriori informazioni, consulta Formati di stringa URL sotto.

  • driverClassName: Nome della classe del driver JDBC. Questo varia a seconda del database che si desidera utilizzare e, successivamente, del driver necessario per connettersi ad esso. Di seguito sono riportati i nomi delle classi per tutti i database supportati da AEM:

    • org.postgresql.Driver per PostgreSQL;
    • com.ibm.db2.jcc.DB2Driver per DB2;
    • oracle.jdbc.OracleDriver per Oracle;
    • com.mysql.jdbc.Driver per MySQL e MariaDB (sperimentale);
    • c om.microsoft.sqlserver.jdbc.SQLServerDriver per Microsoft SQL Server (sperimentale).

  • username: Il nome utente con cui viene eseguito il database.

  • password: Password del database.

Formati di stringa URL url-string-formats

Nella configurazione dell’origine dati viene utilizzato un formato di stringa URL diverso a seconda del tipo di database che deve essere utilizzato. Di seguito è riportato un elenco dei formati per i database che AEM attualmente supportano:

  • jdbc:postgresql:databasename per PostgreSQL;

  • jdbc:db2://localhost:port/databasename per DB2;

  • jdbc:oracle:thin:localhost:port:SID per Oracle;

  • jdbc:mysql://localhost:3306/databasename per MySQL e MariaDB (sperimentale);

  • jdbc:sqlserver://localhost:1453;databaseName=name per Microsoft SQL Server (sperimentale).

Limitazioni note known-limitations

Mentre l’utilizzo simultaneo di più istanze AEM con un singolo database è supportato dalla persistenza RDBMS, le installazioni simultanee non lo sono.

Per risolvere il problema, assicurati di eseguire prima l'installazione con un singolo membro e di aggiungere gli altri al termine della prima installazione.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56