Come installare Liferay 7 su JBOSS EAP con il supporto Oracle Database

Antonio Musarra's Blog © 2017 - https://www.dontesta.it - @antonio_musarra - IT_v1.0.0
LIFERAY 7 & JBOSS
COME INSTALLARE LIFERAY 7 SU JBOSS EAP + IL
SUPPORTO PER ORACLE DATABASE
!1

COME INSTALLARE LIFERAY 7 SU JBOSS EAP + ORACLE DATABASE
COSA NON È…
‣ Una guida d’installazione di JBOSS
‣ Una guida all’ottimizzazione della conﬁgurazione di JBOSS
‣ Una guida all’installazione di Oracle Database
‣ Una guida sull’ottimizzazione della conﬁgurazione di Liferay
!2

IL CONTENUTO DI QUESTA GUIDA
‣ Quali sono gli obiettivi
‣ Quali sono i requisiti software
‣ Download del software
‣ Layout d’installazione
‣ Installazione di Liferay
‣ Conﬁgurazione base di Liferay
‣ Conﬁgurazione di JBOSS
‣ Start del portale
‣ Accesso al portale
!3

1. QUALI SONO GLI OBIETTIVI?
Con questa sintetica guida puntiamo a:
‣ Installare JBOSS EAP (Enterprise Application Platform) versione 6.4
‣ Installare Liferay 7 Community Edition
‣ Applicare una configurazione minima a Liferay
‣ Configurare JBOSS
‣ Impostazioni specifiche per Liferay
‣ Configurazione del database connection pool verso Oracle
‣ Configurazione del servizio SMTP
!4

1. QUALI SONO GLI OBIETTIVI?
Con questa sintetica guida puntiamo a:
‣ Installare JBOSS EAP (Enterprise Application Platform) versione 6.4
‣ Installare Liferay 7 Community Edition
‣ Applicare una configurazione minima a Liferay
‣ Configurare JBOSS
‣ Impostazioni specifiche per Liferay
‣ Configurazione del database connection pool verso Oracle
‣ Configurazione del servizio SMTP
!4
Praticamente
un Bundle
Liferay 7 + JBOSS EAP
con supporto Oracle
Database

2. QUALI SONO I REQUISITI SOFTWARE?
Il sistema operativo (SO) di riferimento per questa guida rientra nella categoria Unix-like (*nix). Le stesse operazioni, con
qualche leggera differenza, sono valide anche in ambiente Microsoft Windows. Alcuni dei tools utilizzati sono nativi dell’SO.
Sulla macchina d’installazione il software necessario è:
‣ Oracle JDK 1.8
‣ Driver JDBC Oracle
‣ JBOSS EAP 6.4.x GA
‣ Liferay 7 GA3 Community Edition
‣ Liferay 7 Database All In One Support
‣ Maven 3.2 e Git (opzionale)
Assumiamo che Oracle JDK 1.8 e Maven (opzionale) siano già installati sulla macchina d’installazione, assumiamo inoltre
che un’istanza Oracle 12c sia già conﬁgurata per ospitare il database della nostra installazione Liferay 7.
!5

3. DOWNLOAD DEL SOFTWARE
Supponendo che JDK, Maven e Git siano già installati, il software da scaricare è:
‣ Liferay 7 Community Edition GA3 (7.0.3)
‣ Liferay 7 OSGi - liferay-ce-portal-osgi-7.0-ga3-20160804222206210.zip
‣ Liferay 7 Dependencies - liferay-ce-portal-dependencies-7.0-ga3-20160804222206210.zip
‣ Liferay 7 WAR - liferay-ce-portal-7.0-ga3-20160804222206210.war
‣ Driver JDBC Oracle (thin driver Oracle Database 12c Release 2) - ojdbc8.jar
‣ JBoss EAP 6.4.x GA - jboss-eap-6.4.0.GA.zip
‣ Liferay 7 Database All In One Support - liferay-portal-database-all-in-one-support-1.0.0.jar
Nel mio caso i ﬁle appena scaricati sono all’interno della directory $HOME/Download
!6

4. LAYOUT D’INSTALLAZIONE
!7
La struttura di directory dell’installazione sarà la seguente:
‣ /opt/liferay-7-jboss-eap-home : Liferay Home Directory
‣ jboss-eap-6.4 - JBOSS Home Directory
‣ osgi - Liferay Bundle Directory
‣ deploy (*) - Liferay Autodeploy Directory
‣ data (*) - Liferay Data Directory (esempio: document_library, elastic, etc.)
‣ logs (*) - Liferay Logs Directory
‣ conﬁg - Liferay Conﬁguration Directory
(*) Queste directory sono create da Liferay durante la fase di start-up del portale.
IL REPOSITORY LIFERAY-7-JBOSS-EAP-HOME CONTIENE L’INTERO LAYOUT D’INSTALLAZIONE E I FILE DI
CONFIGURAZIONE COMPLETI DI LIFERAY E JBOSS. POTRESTE UTILIZZARE QUESTO REPOSITORY COME BASE DI
PARTENZA PER VELOCIZZARE IL PROCESSO D’INSTALLAZIONE.

4.1. PREPARAZIONE DEL LAYOUT D’INSTALLAZIONE
Procediamo con la creazione del layout d’installazione utilizzando i comandi a seguire:
$ mkdir /opt/liferay-7-jboss-eap-home
$ mkdir /opt/liferay-7-jboss-eap-home/config
$ cd /opt/liferay-7-jboss-eap-home/
$ mkdir osgi
$ cd osgi
$ bsdtar -xf $HOME/Downloads/liferay-ce-portal-osgi-7.0-ga3-20160804222206210.zip -s'|
[^/]*/||'
$ cd ..
$ unzip $HOME/Downloads/jboss-eap-6.4.0.zip
!8

$ mkdir osgi
$ cd osgi
[^/]*/||'
$ cd ..
!8
CREAZIONE LIFERAY HOME DIRECTORY

$ mkdir osgi
$ cd osgi
[^/]*/||'
$ cd ..
!8
CREAZIONE LIFERAY CONFIG DIRECTORY

$ mkdir osgi
$ cd osgi
[^/]*/||'
$ cd ..
!8
CREAZIONE DIRECTORY BUNDLE OSGI

$ mkdir osgi
$ cd osgi
[^/]*/||'
$ cd ..
!8
ESTRAZIONE DEI BUNDLE OSGI LIFERAY

$ mkdir osgi
$ cd osgi
[^/]*/||'
$ cd ..
!8
ESTRAZIONE DEI BUNDLE OSGI LIFERAY
ESTRAZIONE INSTALLAZIONE JBOSS EAP

5. INSTALLAZIONE DI LIFERAY
Procediamo con l’installazione di Liferay utilizzando i comandi a seguire:
$ cd /opt/liferay-7-jboss-eap-home
$ mkdir -p jboss-eap-6.4/modules/com/liferay/portal/main/
$ cd jboss-eap-6.4/modules/com/liferay/portal/main/
$ bsdtar -xf $HOME/Downloads/liferay-ce-portal-dependencies-7.0-ga3-20160804222206210.zip -s'|[^/]*/||'
$ cp $HOME/Downloads/ojdbc8.jar .
$ curl -o module.xml -s https://gist.githubusercontent.com/amusarra/0c06b26dd465f8da2479abe8bd4f5a8f/raw/
f905bf74029a3739ace0b1c8973f979/module.xml
$ cd /opt/liferay-7-jboss-eap-home/jboss-eap-6.4/standalone/deployments
$ touch ROOT.war.dodeploy
$ mkdir ROOT.war && cd ROOT.war
$ unzip $HOME/Downloads/liferay-ce-portal-7.0-ga3-20160804222206210.war
$ cp $HOME/Downloads/liferay-portal-database-all-in-one-support-1.0.0.jar WEB-INF/lib/
!9

!9
CREAZIONE DIRECTORY JBOSS MODULE
PER LIFERAY

!9
PER LIFERAY
ESTRAZIONE DELLE DIPENDENZE LIFERAY
DENTRO LA DIRECTORY DEI MODULI

!9
PER LIFERAY
COPIA DRIVER JDBC ORACLE

!9
PER LIFERAY
COPIA FILE MODULE.XML CON
LE CONFIGURAZIONI

!9
PER LIFERAY
LE CONFIGURAZIONI
ESTRAZIONE DEL WAR LIFERAY E
CREAZIONE DODEPLOY

!9
PER LIFERAY
LE CONFIGURAZIONI
ESTRAZIONE DEL WAR LIFERAY E
CREAZIONE DODEPLOY COPIA DRIVER LIFERAY ALL IN
ONE

6. CONFIGURAZIONE BASE DI LIFERAY
La configurazione base di Liferay prevede:
‣ Impostazione della risorsa JNDI per la connessione JDBC. Il nome della risorsa in questo caso è
impostata a: java:jboss/LiferayPool
‣ Impostazione della risorsa JNDI per la connessione al servizio di mail: Il nome della risorsa in
questo caso è impostata a: java:jboss/mail/LiferayMailSession
Nel file $LIFERAY_HOME/config/portal-runtime.properties ci saranno quindi queste due properties:
mail.session.jndi.name=java:jboss/mail/LiferayMailSession
jdbc.default.jndi.name=java:jboss/LiferayPool
Queste due risorse JNDI devono essere poi configurate sul file standalone.xml di JBOSS. Il file di
configurazione completo portal-runtime.properties è disponibile sul repository github.
!10

7. CONFIGURAZIONE JBOSS
La configurazione di JBOSS prevede:
‣ Configurazione delle system properties per URI encoding in UTF-8
‣ Modifica del timeout per il sistema di deployment scanner
‣ Aggiunta del security domain JAAS per il modulo PortalLogin
‣ Disabilitazione della welcome page
‣ Impostazione development mode per le pagine JSP e supporto per java 1.8
Queste configurazioni devono essere inserite all’interno del file di configurazione standalone.xml. Nelle
due successive slide sono mostrati le parti di configurazione da aggiungere o modificare. Il file
standalone.xml completo è disponibile sul repository github.
!11

<system-properties>
<property name="org.apache.catalina.connector.URI_ENCODING" value="UTF-8" />
<property name="org.apache.catalina.connector.USE_BODY_ENCODING_FOR_QUERY_STRING" value="true"
/>
</system-properties>
<subsystem xmlns="urn:jboss:domain:deployment-scanner:2.0">
<deployment-scanner deployment-timeout="360" path="deployments" relative-
to="jboss.server.base.dir" scan-interval="5000"/>
</subsystem>
<security-domain name="PortalRealm">
<authentication>
<login-module code="com.liferay.portal.security.jaas.PortalLoginModule" flag="required" />
</authentication>
</security-domain>
!12

<subsystem xmlns="urn:jboss:domain:web:2.2" default-virtual-server="default-
host" native="false">
<connector name="http" protocol="HTTP/1.1" scheme="http" socket-
binding="http"/>
<virtual-server name="default-host" enable-welcome-root="false">
…
<configuration>
<jsp-configuration development="true" source-vm="1.8" target-vm="1.8"/>
</configuration>
!13

7.1. CONFIGURAZIONE JDBC CONNECTION POOL
<datasource jta="true" jndi-name="java:jboss/LiferayPool" pool-name="LiferayPool" enabled="true" use-java-context="true" use-ccm="true">
<connection-url>jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=oracle12c.labs.dontesta.it)(PORT=32769))(CONNECT_DATA=(SERVER=DEDICATED)(SID=XE)))</
connection-url>
<driver>oracle</driver>
<new-connection-sql>select 1 from dual</new-connection-sql>
<pool>
<min-pool-size>40</min-pool-size>
<max-pool-size>100</max-pool-size>
<prefill>true</prefill>
<allow-multiple-users>false</allow-multiple-users>
</pool>
<security>
<user-name>liferay</user-name>
<password>liferay</password>
</security>
<validation>
<check-valid-connection-sql>select 1 from dual</check-valid-connection-sql>
<validate-on-match>true</validate-on-match>
<background-validation>false</background-validation>
<use-fast-fail>false</use-fast-fail>
<exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
</validation>
<timeout>
<set-tx-query-timeout>false</set-tx-query-timeout>
</timeout>
<statement>
<track-statements>NOWARN</track-statements>
<share-prepared-statements>false</share-prepared-statements>
</statement>
!14

7.2. CONFIGURAZIONE MAIL SESSIONS
<subsystem xmlns="urn:jboss:domain:mail:1.2">
…
<mail-session jndi-name="java:jboss/mail/LiferayMailSession" >
<smtp-server outbound-socket-binding-ref="mail-gmail-smtp">
<login name="YOUR_USER" password="YOUR_PASSWORD"/>
</smtp-server>
<pop3-server outbound-socket-binding-ref="mail-gmail-pop"/>
<imap-server outbound-socket-binding-ref="mail-gmail-imap">
<login name="YOUR_USER" password="YOUR_PASSWORD"/>
</imap-server>
</mail-session>
…
</subsystem>
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
...
<outbound-socket-binding name="mail-gmail-smtp">
<remote-destination host="smtp.gmail.com" port="465"/>
</outbound-socket-binding>
<outbound-socket-binding name="mail-gmail-pop">
<remote-destination host="pop.gmail.com" port="110"/>
<outbound-socket-binding name="mail-gmail-imap">
<remote-destination host="imap.gmail.com" port="993"/>
</socket-binding-group>
!15

7.3. CONFIGURAZIONE JAVA OPTIONS
Affinché Liferay funzioni correttamente è importante impostare alcune opzioni per la JVM. Le opzioni possono essere aggiunte
tramite l’environment $JAVA_OPTS.
Il file dove apportare la modifica della variabile JAVA_OPTS è standalone.conf (o standalone.conf.bat su Windows) situato
all’interno della directory $JBOSS_HOME/bin.
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Dsecmgr -
Djava.security.policy=$JBOSS_HOME/bin/server.policy -Djboss.home.dir=$JBOSS_HOME -Duser.timezone=GMT
-Xmx1024m -XX:MaxMetaspaceSize=384m" -Dliferay.configDir=/opt/liferay-7-jboss-eap-home/config
La stringa di configurazione per JAVA_OPTS deve essere aggiunta alla fine del file standalone.conf. Tramite il file server.policy non
diamo alcuna restrizione a Liferay. Successivamente e sulla base delle proprie esigenze è possibile raffinare le policy di sicurezza.
grant {
permission java.security.AllPermission;
};
!16

8. START DEL PORTALE
JBoss EAP 6.4 può essere lanciato in modalità standalone o in modalità di domain. La
modalità domain consente di gestire più istanze dell’application server da un singolo
nodo chiamato di management. Questa collezione di application server è conosciuta
come domain o dominio.
Per approfondimenti sulla modalità standalone vs. dominio, potete fare riferimento alla
sezione su questo argomento nella Guida Amministrazione e Conﬁgurazione di JBoss
EAP 6.4.
Liferay 7 supporta completamente JBoss EAP 6.4 quando viene eseguito in modalità
standalone ma non quando viene eseguito in modalità di dominio. Per veriﬁcare i limiti
della modalità domain potete fare riferimento alla documentazione disponibile sul
Liferay Developer Network.
!17

É giunto il momento di avviare il portale Liferay 7 Community Edition con il supporto per il database
Oracle. Per avviare il portale in modalità standalone è sufficiente eseguire il comando a seguire, accertando
prima di avere il database online.
$ cd /opt/liferay-7-jboss-eap-home/jboss-eap-6.4
$ ./bin/standalone.sh
Eseguito il comando, sulla console vedrete le varie attività in esecuzione su JBOSS, inoltre potrete
verificare le attività eseguite da Liferay monitorando i file di log che nel frattempo saranno stati creati
dentro il folder /opt/liferay-7-jboss-eap-home/logs
L’evidenza dell’avvenuto start-up del portale è la seguente riga che dovreste vedere in console:
10:10:03,977 INFO [org.jboss.as] (Controller Boot Thread) JBAS015874: JBoss EAP
6.4.0.GA (AS 7.5.0.Final-redhat-21) started in 147774ms - Started 1912 of 1949
services (62 services are lazy, passive or on-demand)
!18

A seguire un estratto dal ﬁle di log di Liferay che mostra l’uso del driver Oracle e
l’inizio del processo di creazione tabelle e popolamento delle stesse con i dati
essenziali al funzionamento.
10:29:58,914 INFO [ServerService Thread Pool -- 64][DialectDetector:75] Determine dialect for Oracle 12.1
10:29:58,938 INFO [ServerService Thread Pool -- 64][DialectDetector:148] Found dialect org.hibernate.dialect.Oracle10gDialect
10:29:58,950 INFO [ServerService Thread Pool -- 82][AutoDeployDir:160] Creating missing directory /opt/liferay-7-jboss-eap-home/deploy
10:29:59,450 INFO [ServerService Thread Pool -- 82][AutoDeployDir:185] Auto deploy scanner started for /opt/liferay-7-jboss-eap-home/deploy
10:31:21,921 INFO [ServerService Thread Pool -- 64][StartupAction:118] There are no patches installed
10:31:32,097 WARN [ServerService Thread Pool -- 64][ReleaseLocalServiceImpl:228] ORA-00942: tabella o vista inesistente_ [Sanitized]
10:31:32,102 INFO [ServerService Thread Pool -- 64][ReleaseLocalServiceImpl:125] Create tables and populate with default data
10:31:54,309 INFO [ServerService Thread Pool -- 64][BaseDB:498] Database supports case sensitive queries
11:11:45,835 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running Bookmarks SQL scripts
11:11:46,483 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running Flags SQL scripts
11:11:46,945 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running IM SQL scripts
11:11:47,555 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running Microblogs SQL scripts
11:11:48,065 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running PM SQL scripts
11:11:49,682 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running Wiki SQL scripts
11:11:51,810 INFO [ServerService Thread Pool -- 72][ServiceComponentLocalServiceImpl:317] Running Calendar SQL scripts
!19

Una volta avviato il portale la $LIFERAY_HOME conterrà dei nuovi folder:
!"" data
   !"" document_library
   $"" elasticsearch
!"" deploy
!"" logs
   !"" liferay.2017-05-11.log
   !"" liferay.2017-05-11.xml
   !"" liferay.2017-05-12.log
   $"" liferay.2017-05-12.xml
Sono gli stessi folder descritti nell’introduzione al layout d’installazione di Liferay.
!20

9. ACCESSO AL PORTALE
A questo punto il portale è raggiungibile
puntando il proprio il browser su http://
localhost:8080 accedendo con la coppia di
credenziali amusarra@labs.dontesta.it/test
(utenza configurata sul file di configurazione di
Liferay portal-runtimes.properties).
Al primo accesso vi sarà richiesto l’accettazione
di termini d’uso.
A questo punto Liferay 7 + Oracle Database su
JBOSS EAP 6.4 è pronto all’uso!
!21

10. RISORSE
‣ Repository liferay-7-jboss-eap-home con la
struttura e file di configurazione di Liferay e
JBOSS EAP 6.4.0.GA
‣ Liferay 7 Wildfly: How to add support for Oracle
DB - Antonio Musarra’s Blog YouTube Channel
‣ Installazione su WildFly 10 - Liferay Developer
Network
‣ Installation Guide JBOSS EAP 6.4
!22
Antonio Musarra - IT Senior Consultant
Twitter: @antonio_musarra
LinkedIn: https://www.linkedin.com/in/amusarra/
GitHub: https://github.com/amusarra
YouTube: Antonio Musarra’s Blog Channel
Blog: https://www.dontesta.it

Come installare Liferay 7 su JBOSS EAP con il supporto Oracle Database

Recommended

Recommended

More Related Content

What's hot

What's hot (17)

Similar to Come installare Liferay 7 su JBOSS EAP con il supporto Oracle Database

Similar to Come installare Liferay 7 su JBOSS EAP con il supporto Oracle Database (20)

More from Antonio Musarra

More from Antonio Musarra (20)