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. Käesolevas palas käsitletakse Liferay kasutamist juhtumil kui andmeid hoitakse PostgreSQL andmebaasis.

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

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