LibrePlan compilation

Debian/Ubuntu

Install requirements:

apt-get install git-core maven openjdk-8-jdk postgresql postgresql-client python-docutils make gettext cutycapt
Connect to database:

su postgres -c psql
Use SQL sentences:

CREATE DATABASE libreplandev;

CREATE DATABASE libreplandevtest;

CREATE USER libreplan WITH PASSWORD 'libreplan';

GRANT ALL PRIVILEGES ON DATABASE libreplandev TO libreplan;

GRANT ALL PRIVILEGES ON DATABASE libreplandevtest TO libreplan;
Download source code:

$ git clone git://github.com/LibrePlan/libreplan.git
Compile project:

$ cd libreplan/

$ mvn clean install
Launch application:

$ cd libreplan-webapp/

$ mvn jetty:run
Go to http://localhost:8080/

Fedora

Install requirements:

yum install git maven java-1.8.0-openjdk-devel postgresql postgresql-server python-docutils make gettext gnu-free-fonts-compat

WARNING: Use the following command in Fedora 16 or below:

 yum install git maven java-1.8.0-openjdk postgresql postgresql-server python-docutils 
 make gettext gnu-free-fonts-compat

Start database service:

su - postgres -c "PGDATA=/var/lib/pgsql/data initdb" systemctl start postgresql.service

WARNING: Use the following commands in Fedora 16 or below:

`service postgresql initdb`

`service postgresql start`

Connect to database:

su postgres -c psql
Use SQL sentences:

CREATE DATABASE libreplandev;

CREATE DATABASE libreplandevtest;

CREATE USER libreplan WITH PASSWORD 'libreplan';

GRANT ALL PRIVILEGES ON DATABASE libreplandev TO libreplan;

GRANT ALL PRIVILEGES ON DATABASE libreplandevtest TO libreplan;
Set 'postgres' user password:

ALTER USER postgres WITH PASSWORD 'postgres';

WARNING: These steps are only for Fedora 16 and below:

Edit '/var/lib/pgsql/data/pg_hba.conf' and replace 'ident' by 'md5'
Reload database configuration: service postgresql reload
Download source code:

$ git clone git://github.com/LibrePlan/libreplan.git
Compile project:

$ cd libreplan/

$ mvn clean install
Launch application:

$ cd libreplan-webapp/

$ mvn jetty:run
Go to http://localhost:8080/

openSUSE

Install requirements:

zypper install git-core java-1_8_0-openjdk-devel postgresql-server postgresql docutils make gettext-tools
Install Maven:

cd /opt/ wget http://www.apache.org/dist//maven/binaries/apache-maven-3.0.5-bin.tar.gz tar -xzvf apache-maven-3.0.5-bin.tar.gz

Edit '/etc/bash.bashrc.local' and add the following lines:

export M2_HOME=/opt/apache-maven-3.0.5 export MVN=$M2_HOME/bin export PATH=$MVN:$PATH
Start database service:

/etc/init.d/postgresql start
Connect to database:

su postgres -c psql
Use SQL sentences:

CREATE DATABASE libreplandev; CREATE DATABASE libreplandevtest; CREATE USER libreplan WITH PASSWORD 'libreplan'; GRANT ALL PRIVILEGES ON DATABASE libreplandev TO libreplan; GRANT ALL PRIVILEGES ON DATABASE libreplandevtest TO libreplan;
Set postgres user password:

ALTER USER postgres WITH PASSWORD 'postgres';
Edit /var/lib/pgsql/data/pg_hba.conf and replace ident by md5
Restart database service:

/etc/init.d/postgresql restart
Download source code:

$ git clone git://github.com/LibrePlan/libreplan.git
Compile project:

$ cd libreplan/ $ mvn clean install
Launch application:

$ cd libreplan-webapp/ $ mvn jetty:run
Go to http://localhost:8080/

Microsoft Windows


* Download and install latest Java Development Kit 8uXX (JDK8uXX):

    http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

* Download and install latest PostgreSQL database:

    http://www.enterprisedb.com/products-services-training/pgdownload#windows

* Download and install Apache Tomcat 8:

    http://tomcat.apache.org/download-80.cgi
    Note: in JDK folder there is JRE folder

* Set up JDBC41 PostgreSQL Driver:

    Download latest driver: https://jdbc.postgresql.org/download.html
    Copy downloaded *.jar file to JRE location: (e.g. C:\Program Files\Java\jre8\lib\ext)
    Copy downloaded *.jar file to JAVA_HOME location: (e.g. C:\Program Files\Java\jdk1.8.0_111\jre\lib\ext)
    Put downloaded *.jar file to Tomcat lib location: (e.g. C:\Program Files\Apache Software Foundation\Tomcat 8.0\lib)

* Create database:

    `CREATE DATABASE libreplan;`

* Use SQL sentences:

    `CREATE USER libreplan WITH PASSWORD 'libreplan';`
    `GRANT ALL PRIVILEGES ON DATABASE libreplan TO libreplan;`

* Download and install Git

    https://git-scm.com/download/win

* Download Maven

    https://maven.apache.org/download.cgi

WARNING:

    Check if latest Maven version is compatible with your JDK

* Connect to database:

    Go to PostgreSQL bin folder and command window from here
    psql -U postgres

* Use SQL sentences:

    `CREATE DATABASE libreplandev;`
    `CREATE DATABASE libreplandevtest;`
    `CREATE USER libreplan WITH PASSWORD 'libreplan';`
    `GRANT ALL PRIVILEGES ON DATABASE libreplan TO libreplan;`

* Create an Environment Variable JAVA_HOME

    You need to set it to your JDK installed directory

* Configure Apache Tomcat Server

* Go to (e.g. C:/Program Files/Apache Software Foundation/Tomcat 8.0/conf/Catalina/localhost/)
  and create there libreplan.xml file with this lines of code::

    `<?xml version="1.0" encoding="UTF-8"?>`

    `<Context antiJARLocking="true" path="">`
        `<Resource name="jdbc/libreplan-ds" auth="Container"`
            `type="javax.sql.DataSource"`
            `maxActive="100" maxIdle="30" maxWait="10000"`
            `username="libreplan" password="libreplan"`
            `driverClassName="org.postgresql.Driver"`
            `url="jdbc:postgresql://localhost/libreplan" />`
    `</Context>`

=======

* Download source code:

    Open GitBash
    git clone https://github.com/LibrePlan/libreplan.git

* Set JAVA_HOME environment variable:

    You need to set it to your JDK installed directory (e.g. C:\Program Files\Java\jdk1.8.0_111)

* Add path of unpacked distributions bin directory of Maven to 'Path' environment variable

    (e.g. C:/Program Files/apache-maven-3.3.3/bin)

* Compile project:

    `cd libreplan`
    `mvn clean install`

* Launch application:

    * Get *.war file from project folder (e.g ../libreplan/libreplan-webapp/target/libreplan-webapp.war)
    * Rename it to libreplan.war
    * Put your libreplan.war file to Apache Tomcat webapps folder (e.g. C:\Program Files\Apache Software Foundation\Tomcat 8.0\webapps\)
    * Start Apache Tomcat server

    Possible location: C:\Program Files\Apache Software Foundation\Tomcat 8.0\bin\Tomcat8.exe

* Go to http://localhost:8080/


CutyCapt compilation
--------------------

Like CutyCapt is not packaged for all distributions here are the instructions.

Ubuntu/Debian
~~~~~~~~~~~~~

* Install requirements:

    `apt-get install subversion libqt4-dev libqtwebkit-dev qt4-qmake g++ make`

  In Ubuntu Lucid 10.04 remove ``libqtwebkit-dev`` package.

  * Install:

    `apt-get install cutycapt`

If it doesn't work. Try to do it

* Download source code:

    `svn co https://cutycapt.svn.sourceforge.net/svnroot/cutycapt cutycapt`

* Compile:

    `$ cd CutyCapt`
    `$ qmake CutyCapt.pro`
    `$ make`

* Install:

    `cp CutyCapt /user/bin/cutycapt`

Fedora
~~~~~~

* Install requirements:

   `yum install subversion qt-devel qt-webkit-devel gcc-c++ make`

* Download source code:

    `$ svn co https://cutycapt.svn.sourceforge.net/svnroot/cutycapt cutycapt`

* Compile:

    `$ cd cutycapt/CutyCapt`
    `$ qmake-qt4 CutyCapt.pro`
    `$ make`

* Install:

    `cp CutyCapt /user/bin/cutycapt`

openSUSE
~~~~~~~~

* Install requirements:

    `zypper install subversion libqt4-devel libQtWebKit-devel gcc-c++ make`

* Download source code:

    `$ svn co https://cutycapt.svn.sourceforge.net/svnroot/cutycapt cutycapt`

* Compile:

    `$ cd cutycapt/CutyCapt`
    `$ qmake-qt4 CutyCapt.pro`
    `$ make`

* Install:

    `cp CutyCapt /user/bin/cutycapt`

LibrePlan documentation generation
----------------------------------

In the doc/src folder you'll find several types of documentation
available: technical documentation, user manual, some training documentation and training exercises.
This documentation is available in several languages.

The supported outputs are HTML and PDF.

Debian/Ubuntu
~~~~~~~~~~~~~

* Install requirements if generating HTML:

    `apt-get install make python-docutils`

* Install requirements if generating PDF:

    `apt-get install make python-docutils texlive-latex-base texlive-latex-recommended texlive-latex-extra textlive-fonts-recommended`

* Go to the directory where the documentation you want to generate is.
  For example, if you want to generate the user manual in English:

   `cd doc/src/user/en`

* Generate HTML:

    `make html`

* Generate PDF::

    `make pdf`

* Generate both formats:

    `make`

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

LibrePlan compilation

Debian/Ubuntu

Fedora

openSUSE

Clone this wiki locally