392 lines
14 KiB
ReStructuredText
392 lines
14 KiB
ReStructuredText
|
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
|
|||
|
|
-------------------------------------
|
|||
|
|
|
|||
|
|
PPAs Ubuntu
|
|||
|
|
~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
Il existe des PPAs Ubuntu pour plusieurs versions (Lucid, Maverick et Natty); 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 ``python-software-properties`` avant de lancer les commandes précédentes.
|
|||
|
|
Vous pouvez le faire avec la ligne suivante :
|
|||
|
|
|
|||
|
|
sudo apt-get install python-software-properties
|
|||
|
|
|
|||
|
|
.. 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 Squeeze (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.3.0-1_amd64.deb
|
|||
|
|
|
|||
|
|
* Installer le paquet::
|
|||
|
|
|
|||
|
|
# dpkg -i libreplan_1.3.0-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 17::
|
|||
|
|
|
|||
|
|
# cd /etc/yum.repos.d
|
|||
|
|
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/Fedora_17/home:jsuarezr:LibrePlan.repo
|
|||
|
|
# yum install libreplan
|
|||
|
|
|
|||
|
|
Suivre ensuite les instructions présentes dans /usr/share/doc/libreplan-1.3.0/README.Fedora.
|
|||
|
|
|
|||
|
|
* Fedora 16::
|
|||
|
|
|
|||
|
|
# cd /etc/yum.repos.d
|
|||
|
|
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/Fedora_16/home:jsuarezr:LibrePlan.repo
|
|||
|
|
# yum install libreplan
|
|||
|
|
|
|||
|
|
Suivre ensuite les instructions présentes dans /usr/share/doc/libreplan-1.3.0/README.Fedora.
|
|||
|
|
|
|||
|
|
* 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 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 12.1::
|
|||
|
|
|
|||
|
|
# cd /etc/zypp/repos.d
|
|||
|
|
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/openSUSE_12.1/home:jsuarezr:LibrePlan.repo
|
|||
|
|
# zypper ref
|
|||
|
|
# zypper install libreplan
|
|||
|
|
|
|||
|
|
* openSUSE 11.4::
|
|||
|
|
|
|||
|
|
# cd /etc/zypp/repos.d
|
|||
|
|
# wget download.opensuse.org/repositories/home:/jsuarezr:/LibrePlan/openSUSE_11.4/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-6-jre postgresql postgresql-client tomcat6 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.x.y.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.x.y.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-jdbc3.jar /usr/share/tomcat6/lib/
|
|||
|
|
|
|||
|
|
* Copier le war dans le répertoire des applications web de Tomcat 6 ou 7::
|
|||
|
|
|
|||
|
|
# cp libreplan.war /var/lib/tomcat6/webapps/
|
|||
|
|
|
|||
|
|
* Relancer Tomcat::
|
|||
|
|
|
|||
|
|
# /etc/init.d/tomcat6 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_6_0-openjdk postgresql-server postgresql tomcat6 xorg-x11-server
|
|||
|
|
|
|||
|
|
* Installation manuelle du pilote JDBC::
|
|||
|
|
|
|||
|
|
# cd /usr/share/java/
|
|||
|
|
# wget http://jdbc.postgresql.org/download/postgresql-9.0-801.jdbc3.jar
|
|||
|
|
# mv postgresql-9.0-801.jdbc3.jar postgresql-jdbc3.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.x.y.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.x.y.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-jdbc3.jar /usr/share/tomcat6/lib/
|
|||
|
|
|
|||
|
|
* Copier le war dans le répertoire des applications web de Tomcat 6 ou 7::
|
|||
|
|
|
|||
|
|
# cp libreplan.war /srv/tomcat6/webapps/
|
|||
|
|
|
|||
|
|
* Relancer Tomcat 6 ou 7::
|
|||
|
|
|
|||
|
|
# /etc/init.d/tomcat6 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.
|