explicanto by Beck et al. Services GmbH > explicanto Open Source Project

explicanto Distribution Platform Server Documentation

explicanto Developer Documentation for the Server of the Distribution Platform

How to build the explicanto Distribution Server

Prerequisites – Before the BEAS-explicanto software can be installed, you must install the prerequisites software described below.

New Installation – Once the additional products are installed, you can install and configure the BEAS-explicanto software.


BEAS-explicanto requires the following products to work properly:

  1. 1.Java2sdk 1.4.2_07 – you can download a version of this package from http://java.sun.com
  2. 2.Jakarta ant-1.6.2 – you can download a version of this package from http://jakarta.apache.org
  3. 3.Liferay 3.2.0+tomcat edition – you can download a version of this package from http://www.liferay.com/cms/servlet/HOME-INDEX
  4. 4.PostgreSQL 8.0.1 – you can download a version of this package from http://www.postgresql.org
  5. 5.The PostgreSQL JDBC driver pg74.215.jdbc3.jar – you can download a version of the package from http://jdbc.postgresql.org/download.html#jars

You must follow the steps:

  1. Install java2sdk (i.e. c:/j2sdk-1.4.2_07). Set JAVA_HOME variable to root installation folder.
  2. Install Jakarta ant-1.6.2 (i.e. c:/ant-1.6.2). Set ANT_HOME variable to root installation folder.
  3. Set up your path to include %ANT_HOME%\bin and %JAVA_HOME%\bin.
  4. Install PostgreSQL with the default options.
  5. Install Liferay-3.2.0+tomcat (i.e. c:/liferay-3.2.0). Set LIFERAY_HOME variable to root installation folder.

New Installation

Download the explicanto-pack project from the SVN repository. This will be the EXPLICANTO_HOME from now on.

This archive contains.

  • EDS, this will be the EDS_HOME
  • PORTLET, this will be PORTLET_HOME
  • YAWIKI, this will be YAWIKI_HOME
  • The etc folder from EDS, PORTLET and YAWIKI contains the configuration files for deploying the applications
  • The build.properties file
  • The build.xml file

Create two databases in PostgreSQL, ‘lportal’ and ‘explicanto’, both should be created on the same DB Server.

Create an user in PostgreSQL to use to give liferay so it can access the databases.

You must set your JAVA_HOME in the LIFERAY_HOME/bin/Catalina.bat file (i.e. SET JAVA_HOME=c:/j2sdk-1.4.2_07).

Go into the LIFERAY_HOME/conf/Catalina/localhost (change the localhost with whatever host you set up for Tomcat, if you do) and make the necessary changes in the liferay.xml file (url, driver class, username, password).

Library Dependencies

There are several jar that have to be copied into different folders:

Into the EDS_HOME/Web-Inf/lib folder (create it if it doesn't exist):

Into the PORTLET_HOME/Web-Inf/lib folder (create it if it doesn't exist):

Into the YAWIKI_HOME/Web-Inf/lib folder (create it if it doesn't exist):


There are different properties files that have to be modified:

In the EXPLICANTO_HOME folder there is the build.properties config file which contains different properties that have to be set to reflect you're local file system. Here you must set the folowing properties

In the EDS_HOME folder there is a explicanto-system.properties file which has to be modified to reflect your database setings

Also in EDS_HOME/etc and PORTLET_HOME/etc folder there are log configuration files log4j.properties which can be modified to change the log level (INFO, DEBUG, etc).

Run ant full-deploy from the EXPLICANTO_HOME folder - this will create the explicanto database tables (explicanto database must be created and empty before running this task), it will restore the lportal database (lportal database must be created and empty before running this task) and then it will deploy the apps, and copy the need it jars in the liferay lib directory.

Attention, the files from the repository are from a Linux deployment, you should change them for a Windows one.


Start LIFERAY – from the LIFERAY_HOME/bin/startup.bat.

Now the installation is finished and you can start the application. Open Internet Explorer browser and open the following URL: http://youraddress:yourport.

The application will start and the main page should be displayed. Login in the explicanto Administration portlet with automatically created test account: username=a and password=a.