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 .

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.

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.