LibrePlan compilation

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

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.