Supporto RDBMS in AEM 6.4

Panoramica

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

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

Per ulteriori informazioni sull'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, consultate la pagina Requisititecnici.

Passaggi di configurazione

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

Affinché funzioni, un’origine dati deve essere configurata con AEM. Questa operazione viene eseguita tramite il org.apache.sling.datasource.DataSourceFactory.config file. I driver JDBC per il rispettivo database devono essere forniti separatamente come pacchetti OSGi all'interno della configurazione locale.

Per informazioni sulla creazione di pacchetti OSGi per i driver JDBC, consultate questa documentazione sul sito Web Apache Sling.

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

  1. Accertatevi che il demone del database sia avviato e che sia presente un database attivo da utilizzare con AEM.

  2. Copiate il JAR di AEM 6.3 nella directory di installazione.

  3. Create una cartella chiamata crx-quickstart\install nella directory di installazione.

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

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
  5. Configurate 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
    Nota

    Per informazioni dettagliate sulla configurazione dell'origine dati per ciascun database supportato, vedere Opzioni di configurazione originedati.

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

    1. Nella crx-quickstart/install cartella, create una cartella denominata 9.

    2. Inserite il JDBC nella nuova cartella.

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

    java -jar quickstart.jar -r crx3,crx3rdb
    

Opzioni di configurazione 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: Il nome dell'origine dati. Il valore predefinito è oak.

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

  • driverClassName: Il nome della classe del driver JDBC. Ciò 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 utilizzato dal database.

  • password: La password del database.

Formati stringa URL

Nella configurazione dell'origine dati viene utilizzato un formato di stringa URL diverso a seconda del tipo di database da utilizzare. Di seguito è riportato un elenco dei formati per i database attualmente supportati da AEM:

  • 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

Anche se 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, accertatevi di eseguire prima l'installazione con un singolo membro e di aggiungere gli altri al termine della prima installazione.

In questa pagina