Skip to content

Latest commit

 

History

History
416 lines (246 loc) · 14.6 KB

INSTALL_fr.rst

File metadata and controls

416 lines (246 loc) · 14.6 KB
Raw

Installation

Ceci est un guide d'installation de LibrePlan. Si vous voulez mettre à jour votre version de LibrePlan, voir le fichier UPDATE_fr. Si vous voulez savoir comment le compiler manuellement, voir le fichier HACKING.

Contents

Installation automatisée de LibrePlan

Images Docker

La façon la plus facile d'obtenir rapidement une instance fonctionnelle de LibrePlan consiste à utiliser des images Docker de LibrePlan. Outre l'image classique LibrePlan/Postgresql, vous trouverez également une image utilisant MySQL ou MariaDB.

Voir https://hub.docker.com/r/libreplan/libreplan/ pour obtenir davantage d'informations et les instructions nécessaires à leur utilisation.

PPAs Ubuntu

Il existe des PPAs Ubuntu pour plusieurs versions (Precise, Trusty, Utopic et Vivid); vous pourrez trouver davantage d'informations à l'URL suivante : https://launchpad.net/~libreplan/+archive/ppa

Instructions:

$ sudo add-apt-repository ppa:libreplan/ppa
$ sudo apt-get update
$ sudo apt-get install libreplan

Tip

Si nous n'avez pas la commande add-apt-repository, vous devrez installer le paquet software-properties-common avant de lancer les commandes précédentes. Vous pouvez le faire avec la ligne suivante :

sudo apt-get install software-properties-common

Warning

Si vous rencontrez des problèmes de mémoire, voir la section Corriger les erreurs de mémoire.

Paquets Debian

Il existe des paquets Debian pour Wheezy et Jessie (i386 et amd64), vous pouvez les télécharger sur : http://sourceforge.net/projects/libreplan/files/LibrePlan/

Instructions:

  • Télécharger le paquet:

    $ wget http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.4.1-1_amd64.deb

  • Installer le paquet:

    # dpkg -i libreplan_1.4.1-1_amd64.deb

  • Installer les dépendances:

    # apt-get install -f

Warning

Si vous rencontrez des problèmes avec la gestion de l'impression, voir la section Corriger l'impression avec Debian Squeeze.

Warning

Si vous rencontrez des problèmes de mémoire, voir la section Corriger les erreurs de mémoire.

Fedora, CentOS et openSUSE OBS (openSUSE Build Service)

Instructions dépendants de la distribution :

  • Fedora 23:

    # cd /etc/yum.repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/Fedora_23/home:jsuarezr:LibrePlan.repo
# yum install libreplan

    Suivre ensuite les instructions présentes dans /usr/share/doc/libreplan-1.4.1/README.Fedora.

  • Fedora 22:

    # cd /etc/yum.repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/Fedora_22/home:jsuarezr:LibrePlan.repo
# yum install libreplan

    Suivre ensuite les instructions présentes dans /usr/share/doc/libreplan-1.4.1/README.Fedora.

  • CentOS 7:

    # cd /etc/yum.repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/CentOS_7/home:jsuarezr:LibrePlan.repo
# yum install libreplan

  • CentOS 6:

    # cd /etc/yum.repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/CentOS_CentOS-6/home:jsuarezr:LibrePlan.repo
# yum install libreplan

  • openSUSE Leap_42.1:

    # cd /etc/zypp/repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/openSUSE_Leap_42.1/home:jsuarezr:LibrePlan.repo
# zypper ref
# zypper install libreplan

  • openSUSE Factory:

    # cd /etc/zypp/repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/openSUSE_Factory/home:jsuarezr:LibrePlan.repo
# zypper ref
# zypper install libreplan

  • openSUSE 13.2:

    # cd /etc/zypp/repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/openSUSE_13.2/home:jsuarezr:LibrePlan.repo
# zypper ref
# zypper install libreplan

  • openSUSE 13.1:

    # cd /etc/zypp/repos.d
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/openSUSE_13.1/home:jsuarezr:LibrePlan.repo
# zypper ref
# zypper install libreplan

Warning

Si vous rencontrez des problèmes de mémoire, voir la section Corriger les erreurs de mémoire.

Paquets RPM

Il existe plusieurs paquets RPM disponibles à l'URL suivante : http://download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/

Suivre les instructions du fichier README correspondant pour achever l'installation.

Warning

Si vous rencontrez des problèmes de mémoire, voir la section Corriger les erreurs de mémoire.

Installation manuelle de LibrePlan

Debian/Ubuntu

  • Installer les pré-requis:

    # apt-get install openjdk-7-jre postgresql postgresql-client tomcat7 libpg-java cutycapt xvfb

  • se connecter à la base de données:

    # su postgres -c psql

  • Utiliser les séquences SQL suivantes pour créer la base de données:

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

  • Télécharger le script d'installation de la base de données:

    $ wget -O install.sql http://downloads.sourceforge.net/project/libreplan/LibrePlan/install_1.4.0.sql

    Warning

    Le fichier 1.4.1.sql est spécifique pour une installation avec MySQL.

  • Créer la structure de la base de données:

    $ psql -h localhost -U libreplan -W libreplan < install.sql

    Warning

    Il est très important d'exécuter la commande précédente en tant que l'utilisateur libreplan (c'est ce à quoi sert l'option -U). Sinon votre installation de LibrePlan ne pourra pas démarrer correctement et vous pourrez trouver dans vos fichiers logs quelque chose comme ce qui suit:

    JDBCExceptionReporter  - ERROR: permission denied for relation entity_sequence

  • Télécharger le fichier .war sur SourceForge.net:

    $ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.4.1.war

  • Créer un nouveau fichier /etc/tomcat6/Catalina/localhost/libreplan.xml (le nom du fichier doit correspondre au nom avec .war) avec la configuration de la base de données pour Tomcat 6 ou 7:

    <?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>

  • Ajouter un nouveau fichier policy pour Tomcat 6 /etc/tomcat6/policy.d/51libreplan.policy avec le contenu suivant:

    grant codeBase "file:/var/lib/tomcat6/webapps/libreplan/-" {
   permission java.security.AllPermission;
};
grant codeBase "file:/var/lib/tomcat6/webapps/libreplan.war" {
   permission java.security.AllPermission;
};

  • Ajouter les lignes suivantes au fichier poilicy pour Tomcat 6 /etc/tomcat6/policy.d/03catalina.policy

    grant codeBase "file:${catalina.home}/bin/tomcat-juli.jar" {
  ...
  // begin:libreplan
  permission java.io.FilePermission "${catalina.base}${file.separator}webapps${file.separator}libreplan${file.separator}WEB-INF${file.separator}classes${file.separator}logging.properties", "read";
  // end:libreplan
  ...
};

  • Alternativement, pour Tomcat 7, ajouter les ligne des deux points précédent à tomcat/conf/catalina.policy.

  • Ajouter un lien vers le pilote Java JDBC pour PostgreSQL dans le répertoire des bibliothèques de Tomcat 6 ou 7:

    # ln -s /usr/share/java/postgresql-jdbc4.jar /usr/share/tomcat7/lib/

  • Copier le war dans le répertoire des applications web de Tomcat 6 ou 7:

    # cp libreplan.war /var/lib/tomcat7/webapps/

  • Relancer Tomcat:

    # /etc/init.d/tomcat7 restart

  • Aller à l'adresse http://localhost:8080/libreplan/

Warning

Si vous rencontrez des problèmes avec la gestion de l'impression, voir la section Corriger l'impression avec Debian Squeeze.

openSUSE

  • Installer les pré-requis:

    # zypper install java-1_7_0-openjdk postgresql-server postgresql tomcat7 xorg-x11-server

  • Installation manuelle du pilote JDBC:

    # cd /usr/share/java/
# wget http://jdbc.postgresql.org/download/postgresql-9.2-1004.jdbc41.jar
# mv postgresql-9.2-1004.jdbc41.jar postgresql-jdbc4.jar

  • Suivre les instructions du fichier HACKING pour compiler et installer CutyCapt

  • Lancer le service base de données:

    # /etc/init.d/postgresql start

  • Se connecter à la base de données:

    # su postgres -c psql

  • Utiliser la séquence SQL suivante pour créer la base de données:

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

  • Configurer le mot de passe de l'utilisateur postgres:

    ALTER USER postgres WITH PASSWORD 'postgres';

  • Ouvrir /var/lib/pgsql/data/pg_hba.conf et remplacer ident par md5

  • Relancer le service de base de données:

    # /etc/init.d/postgresql restart

  • Télécharger le script d'installation de la base de données:

    $ wget -O install.sql http://downloads.sourceforge.net/project/libreplan/LibrePlan/install_1.4.0.sql

  • Créer la structure de la base de données:

    $ psql -h localhost -U libreplan -W libreplan < install.sql

    Warning

    Il est très important d'exécuter la commande précédente en tant que l'utilisateur libreplan (c'est ce à quoi sert l'option -U). Sinon votre installation de LibrePlan ne pourra pas démarrer correctement et vous pourrez trouver dans vos fichiers logs quelque chose comme ce qui suit:

    JDBCExceptionReporter  - ERROR: permission denied for relation entity_sequence

  • Télécharger le fichier .war sur SourceForge.net:

    $ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.4.1.war

  • Créer un nouveau fichier /etc/tomcat6/Catalina/localhost/libreplan.xml (le nom du fichier doit correspondre avec le nom .war) avec la configuration de la base de données pour Tomcat 6 ou 7:

    <?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>

  • Ajouter un lien vers le pilote Java JDBC pour PostgreSQL dans le répertoire des bibliothèques Tomcat 6 ou 7:

    # ln -s /usr/share/java/postgresql-jdbc4.jar /usr/share/tomcat7/lib/

  • Copier le war dans le répertoire des applications web de Tomcat 6 ou 7:

    # cp libreplan.war /srv/tomcat7/webapps/

  • Relancer Tomcat 6 ou 7:

    # /etc/init.d/tomcat7 restart

  • Aller à l'adresse http://localhost:8080/libreplan/

Journaux

Depuis LibrePlan 1.1.1, le système de fichiers journaux est configuré pour créer automatiquement un nouveau répertoire sous /var/log/tomcat6/ avec le nom .war. Par exemple: /var/log/tomcat6/libreplan/.

Dans ce nouveau répertoire on trouvera deux fichiers (libreplan.log et libreplan-error.log) qui feront l'objet d'une rotation quotidienne.

Configurer le répertoire des fichiers journaux

Cependant, si vous voulez configurer manuellement le chemin d'accès aux journaux de LibrePlan, vous devrez configurer la variable JAVA_OPTS dans votre serveur. Cette variable est configurée dans différents fichiers selon la distribution :

  • Debian ou Ubuntu: /etc/default/tomcat6
  • Fedora ou openSUSE: /etc/tomcat6/tomcat6.conf

Dans ce fichier, vous devrez ajouter la ligne suivante:

# Configurer le répertoire des journaux de LibrePlan
JAVA_OPTS="${JAVA_OPTS} -Dlibreplan-log-directory=/mon/chemin/vers/les/logs/libreplan/"

Warning

Vous devez vous assurer que l'utilisateur qui exécute Tomcat (habituellement tomcat6 ou tomcat7 ou tomcat) possède le droit en écriture sur le répertoire indiqué.

Corriger l'impression avec Debian Squeeze

Depuis LibrePlan 1.2, la prise en charge de l'impression ne fonctionne pas correctement avec Debian Squeeze. Pour corriger ce problème, vous devez mettre en place une nouvelle version de CutyCapt et des dépendances WebKit provenant de Debian testing.

Instructions:

  • Assurez-vous que stable reste la distribution par défaut pour la récupération des paquets:

    # echo 'APT::Default-Release "stable";' >> /etc/apt/apt.conf

  • Ajouter un nouveau dépôt pour rendre les paquets testing disponibles pour apt-get:

    # echo "deb http://ftp.debian.org/debian testing main" >> /etc/apt/sources.list

  • Mettez à jour l'index des paquets:

    # apt-get update

  • Récupérez et installez cutycapt (et ses dépendances) depuis:

    # apt-get -t testing install cutycapt

Corriger les erreurs de mémoire

Avec les paramètres par défaut de Tomcat dans différentes distributions, vous pourriez avec des problèmes avec la mémoire Java.

Après quelques temps d'utilisation de LibrePlan, vous pourriez voir que certains écrans ne fonctionnent pas et que les journaux afficher une exception java.lang.OutOfMemoryError.

Cette exception pourrait être provoquée par deux problèmes différents :

  • Heap space:

    java.lang.OutOfMemoryError: Java heap space

  • PermGemp space (Génération permanente, données réflexives pour la JVM):

    java.lang.OutOfMemoryError: PermGen space

De façon à éviter ce problème, vous devrez configure de manière appropriée la variable JAVA_OPTS de votre serveur. Ceci se fait dans différents fichiers selon la distribution :

  • Debian ou Ubuntu: /etc/default/tomcat6
  • Fedora ou openSUSE: /etc/tomcat6/tomcat6.conf

Les lignes suivantes présentent à une configuration possible pour corriger les erreurs de mémoire (les valeurs exactes dépendent des caractéristiques du serveur):

JAVA_OPTS="-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m"
JAVA_OPTS="${JAVA_OPTS} -server -Djava.awt.headless=true"

où les différents paramètres ont la signification suivante :

  • -Xms: Taille initiale du tas (heap) Java
  • -Xmx: Taille maximale du tas Java
  • -XX:PermSize: Taille initiale du PermGen
  • -XX:MaxPermSize: Taille maximale du PermGen

Note

Tenez compte du fait que la taille de PermGen s'ajoute à celle du tas.