Skip to content

LibrePlan compilation

Jump to bottom
PaulLuchyn edited this page Dec 6, 2016 · 38 revisions

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

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

Clone this wiki locally