Skip to content

LibrePlan compilation

Jump to bottom
PaulLuchyn edited this page Dec 5, 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