Supporto RDBMS in AEM 6.4

Panoramica

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 documentazione RDBDocumentStore e RDBBlobStore .

NOTA

È inoltre disponibile il supporto per PostgreSQL 9.4, ma solo a scopo dimostrativo. Non sarà disponibile per gli ambienti di produzione.

Database supportati

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

Passaggi di configurazione

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

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

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

NOTA

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 nella directory crx-quickstart\install :

    • 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 cartella crx-quickstart\install :

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

    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 Installa/Aggiorna
      • Sfoglia per selezionare il bundle estratto dall'archivio ZIP scaricato
      • Verificare che il driver JDBC di Oracle Corporation per MySQLcom.mysql.jdbc sia attivo e avviarlo.

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

    java -jar quickstart.jar -r crx3,crx3rdb

Opzioni di configurazione dell'origine dati

La configurazione org.apache.sling.datasource.DataSourceFactory-oak.config 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 stringa URL di seguito.

  • 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

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

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.

In questa pagina