Liferay kasutamine GlassFish keskkonnas Debian Lennyga

Sissejuhatus

Glassfish on Suni poolt toetatud javal põhinev rakendusplatvorm (ingl. k. application platform), millest levitatakse erinevaid versioone, muu hulgas

• GlassFish Application Server - Sun poolt toetatud vaba tarkvara projekt, https://glassfish.dev.java.net/
• Sun GlassFish Enterprise Server - vaba tarkvara projektil põhinev Suni toode, http://www.sun.com/software/products/glassfish_portfolio/
• Glassfish+Liferay bundled - seda varianti kasutatakse käesoleval juhul, täpsemini Liferay + GlassFish v3 Prelude, http://www.liferay.com/web/guest/downloads/portal

Lähemalt saab erinevate versioonide ja nende kasutustingimustega tutvuda Sun kodulehel. Liferay http://www.liferay.com/ on peamiselt portaalide valmistamisele orienteeritud java rakendus, mis sobib kasutamiseks erinevatel rakendusserveritel, nt Tomcat, Resin, Jetty jt ning vastu erinevaid andmebaase, nt MySQL ja Oracle. Käesolevas palas käsitletakse Liferay kasutamist juhtumil kui andmeid hoitakse PostgreSQL andmebaasis ja rakendusserveriks on Glassfish v3 Prelude.

Ettevalmistused

Abstraktsel tasemel võib süsteemi skeemi kujutada selliselt

                    . ---  Liferay
                . /           |
              '            GlassFish
              |               |
       PostgreSQL            JVM
              |               |
           Debian GNU/Linux Lenny

kus kasutatud tarkvara versioonid on

• operatsioonisüsteem - Debian GNU/Linux Lenny, 64 bit
• andmebaas - PostgreSQL 8.3.7
• Java - JVM SDK v. 6
• GlassFish, Liferay - kasutatud on Liferay veebikohas jagatavat komplekti (ingl. k. bundle), v. liferay-portal-glassfish-5.2.3.zip

JVM

TODO

PostgreSQL

Liferay rakenduse jaoks vajaliku andmebaasi sisu saab moodustada Liferay veebikohas jagatava

 Download -> Additional Files -> Application Server Plugins - Database Scripts

nt liferay-portal-sql-5.2.3.zip, abil. Konkreetselt sobib nt sellest .zip arhiivist kasutada skripti

 ...

GlassFish+Liferay tarkvara paigaldamine

Kopeerida sobiv komplekt Glassfish+Liferay tarkvara komplekt Liferay veebikohast

 Download -> Liferay Portal -> Latest Liferay Portal Bundles -> Bundled with Glassfish 3

nt failinimi liferay-portal-glassfish-5.2.3.zip

Kasutamiseks on sobiv moodustada süsteemi vastav kasutaja:grupp, nt liferay:liferay ning selle kasutaja all tarkvara lahti pakkida

 $ cd /usr/local
 $ unzip liferay-portal-glassfish-5.2.3.zip
 $ mv liferay-... liferay

Serveri käivitamine

Käivitamiseks tuleb öelda

 $ sh asadmin start-domain

ja seiskamiseks

 $ sh asadmin stop-domain -u admin --passwordfile /home/mart/asadmin.password 
 Waiting for the domain to stop ..................................................
 Command stop-domain executed successfully.

Fail /home/mart/asadmin.password on 0600 loabittidega ning seal sisaldub

 $ cat /home/mart/asadmin.password
 AS_ADMIN_PASSWORD=parool

GlassFish haldusliides

Haldusliides asub pordil 4848, vaikimisi on nn anonymous kasutajal privilegeeritud ligipääs

Tõenäoliselt on üks esimesi tegevusi lisada admin kasutaja ja eemaldada anonymous kasutajalt haldamise privileegid

 Configuration -> Security -> Realms -> admin-realm -> Manage Users

Liferay veebiliides

Vaikimisi asub Liferay veebiliides pordil 8080

Vaikimisi on kasutaja Brunol administraatori privileegid.

Liferay ühendamine PostgreSQL andmebaasiga

Kui ettevalmistused on tehtud ning GlassFish+Liferay üldiselt töötavad, siis on sobiv aeg ühendada Liferay käima Derby asemel vastu PostgreSQL andmebaasi.

PostgreSQL baasile vastava pooli moodustamine GlassFishis

Esmalt tuleb kirjeldada pool, avades GlassFish haldusliideses

 Resources -> JDBC -> Connection Pools -> New

ning näidata ära

 Name: LiferayPool
 Resource Type: javax.sql.ConnectionPoolDataSource
 Database Vendor: PostgreSQL

valida Next ning kirjeldada ülejäänud pooli omadused sh baasi ligipääs ning ühenduse draiveri versioon

 DatabaseName=liferay
 Password=parool
 PortNumber=5432
 ServerName=localhost
 User=liferay
 JDBC30DataSource=true

Ning seejärel seostada pool JNDI nimega valides

Resources -> JDBC -> JDBC Resources

ning näidata

 JNDI Name: jdbc/LiferayPool
 Pool Name: LiferayPool
 Status: Enabled

Liferay rakenduse lülitamine kasutama PostgeSQL andmebaasi

Liferay rakenduse kasutamiseks koos PostgreSQL andmebaasiga on iseenesest kaks võimalust

• otse PG JDBC draiveri abil
• GlassFishi pooli abil

Otse kasutamise tuleb moodustada fail portal-ext.properties sisuga

 $ cat domains/domain1/applications/liferay-portal/WEB-INF/classes/portal-ext.properties
 jdbc.default.driverClassName=org.postgresql.Driver
 jdbc.default.url=jdbc:postgresql://localhost:5432/liferay
 jdbc.default.username=liferay
 jdbc.default.password=parool

Pooli kaudu kasutamiseks peab see fail sisaldama

 $ cat domains/domain1/applications/liferay-portal/WEB-INF/classes/portal-ext.properties
 jdbc.default.jndi.name=jdbc/LiferayPool

Selleks, et veenduda, et rakendus tõepoolest kasutab SQL baasi sobib nt kuulata rakenduse kasutamisel pealt liiklust 5432/tcp pordil.

Kasulikud lisamaterjalid

• http://www.sun.com/software/products/glassfish_portfolio/
• https://glassfish.dev.java.net/
• FreeBSD Glassfish