Nettoyage rep install des fichiers obsoletes

This commit is contained in:
Laurent Destailleur 2007-11-23 01:12:54 +00:00
parent f44a0db145
commit 488972d120
10 changed files with 21 additions and 1111 deletions

View File

@ -1,42 +0,0 @@
# Copyright (C) 2003 Rodolphe Quiedeville <rodolphe@quiedeville.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
#
# $Id$
# $Source$
DOC=dolibarr-install
RSYNC=/usr/bin/rsync
ROPT=-av
RSSH=-e ssh
all: $(DOC).pdf $(DOC).html $(DOC).txt
%.txt: %.sgml $(FRPAGES)
linuxdoc --language=french --backend=txt -c latin dolibarr-install.sgml
%.pdf: dolibarr-install.sgml
linuxdoc --language=french --backend=latex -o pdf -c latin dolibarr-install.sgml
%.html: %.sgml
cd ../../htdocs/install/doc/ ; linuxdoc --language=french --backend=html -c latin ../../../doc/install/dolibarr-install.sgml
put:
$(RSYNC) $(ROPT) $(RSSH) ../../htdocs/install/doc/*html www.dolibarr.com:/home/www/www.dolibarr.com/htdocs/documentation
clean:
rm -f *pdf *ps *out *tpt *sasp

10
doc/install/README Normal file
View File

@ -0,0 +1,10 @@
README (english)
--------------------------------
User guide
--------------------------------
* For setup documentation or a quick tour, take a look at the README file in
the root directory.
* All Dolibarr guides are available, on line only, on the Dolibarr Web site:
http://www.dolibarr.org

11
doc/install/README-FR Normal file
View File

@ -0,0 +1,11 @@
README (french)
--------------------------------
Documentation utilisateur
--------------------------------
* Pour une prise en main et installation rapide, consulter le fichier
README-FR à la racine.
* Une documentation utilisateur francophone plus consistente est disponible en
ligne sur le site Web de Dolibarr à l'adresse:
http://www.dolibarr.fr

View File

@ -1,115 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
<TITLE>Dolibarr Installation: Installation</TITLE>
<LINK HREF="dolibarr-install-2.html" REL=next>
<LINK HREF="dolibarr-install.html#toc1" REL=contents>
</HEAD>
<BODY>
<A HREF="dolibarr-install-2.html">Page suivante</A>
Page précédente
<A HREF="dolibarr-install.html#toc1">Table des matières</A>
<HR>
<H2><A NAME="s1">1.</A> <A HREF="dolibarr-install.html#toc1">Installation</A></H2>
<H2><A NAME="ss1.1">1.1</A> <A HREF="dolibarr-install.html#toc1.1">R&eacute;cup&eacute;rer les sources</A>
</H2>
<P>R&eacute;cup&eacute;rer les sources sur
<A HREF="http://www.dolibarr.com/">http://www.dolibarr.com/</A></P>
<P>Les sources se pr&eacute;sentent sous la forme d'un fichier tar compress&eacute; avec gzip.</P>
<H2><A NAME="ss1.2">1.2</A> <A HREF="dolibarr-install.html#toc1.2">Pr&eacute;-requis</A>
</H2>
<P>Liste des logiciels &agrave; installer pour faire fonctionner Dolibarr :</P>
<P>
<UL>
<LI>php4</LI>
<LI>php4-mysql</LI>
<LI>php4-curl (pour la partie gestion des adh&eacute;rents)</LI>
<LI>php4-gd (pour les graphiques)</LI>
<LI>Apache</LI>
</UL>
Pour la gestion de l'authentification, Dolibarr fonctionne soit avec mod-auth-mysql soit avec Pear. Cette derni&egrave;re est plus facile &agrave; installer.
<UL>
<LI>Pear (package Auth)</LI>
<LI>libapache-mod-auth-mysql</LI>
</UL>
</P>
<H3>Pear</H3>
<P>Pear est un ensemble de classes et d'outils pour les installer et les mettre &agrave; jour. Les classes requises pour Dolibarr sont (par ordre d'installation) :</P>
<P>
<UL>
<LI>Archive_Tar</LI>
<LI>Console_Getopt</LI>
<LI>PEAR</LI>
<LI>Auth</LI>
<LI>DB</LI>
</UL>
</P>
<P>Pour installer un paquet Pear, ex&eacute;cutez en root '$ pear install &lt;nom du paquet&gt;'.</P>
<P>Pour plus d'informations sur Pear et sa configuration, veuillez vous reporter &agrave; son site officiel
<A HREF="pear.php.net">pear.php.net</A>.</P>
<H2><A NAME="ss1.3">1.3</A> <A HREF="dolibarr-install.html#toc1.3">Base de donn&eacute;es</A>
</H2>
<P>1- cr&eacute;er une base de donn&eacute;es mysql appel&eacute;e 'dolibarr' (vous
pouvez changer le nom, dans ce cas remplacer dans la suite des
commandes 'dolibarr' par le nom de votre base de donn&eacute;es)</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
# mysqladmin create dolibarr
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>
2- charger la base en ex&eacute;cutant :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
# mysql dolibarr &lt; mysql/mysql.sql
</PRE>
</CODE></BLOCKQUOTE>
</P>
<H2><A NAME="ss1.4">1.4</A> <A HREF="dolibarr-install.html#toc1.4">Apache</A>
</H2>
<P>Pour configurer Apache : des fichier httpd.conf.dist est fournit
avec les sources, vous pouvez vous en servir pour configurer
votre serveur, il est pr&eacute;vu pour que vous ayez juste &agrave; ajouter
une r&eacute;gle Include dans votre fichier principal httpd.conf.</P>
<P>Utilisez le fichier httpd.conf.dist pour l'authentification par Pear
(conseill&eacute;) et le fichier httpd.conf.dist.modauth pour utiliser
mod-auth-mysql.</P>
<H2><A NAME="ss1.5">1.5</A> <A HREF="dolibarr-install.html#toc1.5">Dolibarr</A>
</H2>
<P>Cr&eacute;er un r&eacute;pertoire appel&eacute; document dans le r&eacute;pertoire htdocs des sources et affectez les droits d'&eacute;criture dans ce r&eacute;pertoire &agrave; l'utilisateur ex&eacute;cutant le serveur web.</P>
<P>Cr&eacute;er un fichier conf/conf.php et donnez les droits d'&eacute;criture dans ce fichier &agrave; l'utilisateur ex&eacute;cutant le serveur web.</P>
<P>Pour configurer Dolibarr acc&eacute;dez &agrave; la page
<BLOCKQUOTE><CODE>
<PRE>
/install/
</PRE>
</CODE></BLOCKQUOTE>
, pour vous logger utlisez
le login <B>admin</B> avec le mot de passe <B>admin</B>.</P>
<P>Si les contr&ocirc;les sont corrects
vous n'avez qu'&agrave; cliquer sur le lien, 'Configurer les modules'.</P>
<P>Une fois les modules configur&eacute;s il ne reste plus qu'&agrave; d&eacute;finir les
utilisateurs et leurs permissions respectives. Pour cela cliquer sur
Accueil -> Utilisateurs</P>
<P>Il est fortement conseill&eacute; de supprimer le fichier install.php une fois l'installation termin&eacute;e. De m&ecirc;me pensez &agrave; modifier le mot de passe de l'utilisateur admin.</P>
<HR>
<A HREF="dolibarr-install-2.html">Page suivante</A>
Page précédente
<A HREF="dolibarr-install.html#toc1">Table des matières</A>
</BODY>
</HTML>

View File

@ -1,33 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
<TITLE>Dolibarr Installation: Mise &agrave; jour</TITLE>
<LINK HREF="dolibarr-install-3.html" REL=next>
<LINK HREF="dolibarr-install-1.html" REL=previous>
<LINK HREF="dolibarr-install.html#toc2" REL=contents>
</HEAD>
<BODY>
<A HREF="dolibarr-install-3.html">Page suivante</A>
<A HREF="dolibarr-install-1.html">Page précédente</A>
<A HREF="dolibarr-install.html#toc2">Table des matières</A>
<HR>
<H2><A NAME="s2">2.</A> <A HREF="dolibarr-install.html#toc2">Mise &agrave; jour</A></H2>
<P>Certaines action sont n&eacute;cessaires lors de la mise &agrave; jour de Dolibarr vers une version plus r&eacute;cente des sources.</P>
<H2><A NAME="ss2.1">2.1</A> <A HREF="dolibarr-install.html#toc2.1">Mise &agrave; jour de la base de donn&eacute;es</A>
</H2>
<P>Il peut &ecirc;tre n&eacute;cessaire de faire des modifications sur la structure et/ou les donn&eacute;es contenues dans la base Mysql lors de la mise &agrave; jour de Dolibarr. Pour cela des scripts sont fournis dans le r&eacute;pertoire mysql/migration/. Il se pr&eacute;sente sous la forme a.b.c-e.d.f.sql, les trois premiers num&eacute;ros indique la version de d&eacute;part et les 3 suivants la version que vous souhaitez atteindre. Si vous passez par exemple de la version 0.1.3 &agrave; la version 0.1.6 il vous faudra appliquer les patchs 0.1.3-0.1.4.sql, 0.1.4-0.1.5.sql et 0.1.5-0.1.6.sql si un patch n'&eacute;xiste pas d'une version &agrave; une autre c'est qu'il n'y a pas eu de modification de base.</P>
<H2><A NAME="ss2.2">2.2</A> <A HREF="dolibarr-install.html#toc2.2">Autres actions</A>
</H2>
<P>Il peut-&ecirc;tre n&eacute;cessaire d'effectuer d'autres actions lors de la mise &agrave;
jour, comme la d&eacute;sactivation et la r&eacute;activation des modules. Cette
information est communiqu&eacute;e dans le fichier README &agrave; la racine des sources.</P>
<HR>
<A HREF="dolibarr-install-3.html">Page suivante</A>
<A HREF="dolibarr-install-1.html">Page précédente</A>
<A HREF="dolibarr-install.html#toc2">Table des matières</A>
</BODY>
</HTML>

View File

@ -1,172 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
<TITLE>Dolibarr Installation: Annexe A - Fichiers de conf Apache</TITLE>
<LINK HREF="dolibarr-install-2.html" REL=previous>
<LINK HREF="dolibarr-install.html#toc3" REL=contents>
</HEAD>
<BODY>
Page suivante
<A HREF="dolibarr-install-2.html">Page précédente</A>
<A HREF="dolibarr-install.html#toc3">Table des matières</A>
<HR>
<H2><A NAME="s3">3.</A> <A HREF="dolibarr-install.html#toc3">Annexe A - Fichiers de conf Apache</A></H2>
<H2><A NAME="ss3.1">3.1</A> <A HREF="dolibarr-install.html#toc3.1">Fichier de config pour Apache 1.3</A>
</H2>
<P>Exemple pour l'authentification avec Pear</P>
<P>
<HR>
<PRE>
#
# Sample httpd.conf for dolibarr
#
&lt;VirtualHost dolibarr.lafrere.lan&gt;
ServerAdmin webmaster.fr@lolix.org
DocumentRoot /home/www/dolibarr/dolibarr/htdocs
ServerName dolibarr.lafrere.lan
ErrorLog /home/www/dolibarr/logs/error.log
CustomLog /home/www/dolibarr/logs/access.log combined
ErrorDocument 401 /public/error-401.html
php_flag register_globals on
&lt;/VirtualHost&gt;
</PRE>
<HR>
</P>
<H2><A NAME="ss3.2">3.2</A> <A HREF="dolibarr-install.html#toc3.2">Fichier de config pour Apache 1.3 + mod_auth_mysql</A>
</H2>
<P>Cet exemple ne fonctionne pas sur la s&eacute;rie Apache 2, voir le fichier correspond dans la section suivante.</P>
<P>
<HR>
<PRE>
#
# Sample httpd.conf for dolibarr
#
&lt;VirtualHost dolibarr.lafrere.lan&gt;
ServerAdmin webmaster.fr@lolix.org
DocumentRoot /home/www/dolibarr/dolibarr/htdocs
ServerName dolibarr.lafrere.lan
ErrorLog /home/www/dolibarr/logs/error.log
CustomLog /home/www/dolibarr/logs/access.log combined
ErrorDocument 401 /public/error-401.html
php_flag register_globals on
&lt;Location /&gt;
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Deny from all
AuthType Basic
# N'utilisez la ligne suivante que si vous utilisez aussi
# le module d'authentification bas&eacute; sur postgresql
#Auth_MySQL_Authoritative on
# Utilisez les lignes suivantes si le serveur Apache ne
# peut se logger en anonymous (ce qui est conseill&eacute; ;-)
# rq. erics: sur ma debian je n'ai pas le droit de mettre ces
# instructions dans un &lt;virtualhost&gt; ... (apache 1.3.27.0-2)
#AuthMySQL_DefaultHost &lt;host&gt;
#AuthMySQL_DefaultUser &lt;user&gt;
#AuthMySQL_DefaultPassword &lt;pass&gt;
Auth_MySQL_DB dolibarr
Auth_MySQL_Password_Table llx_user
Auth_MySQL_Username_Field login
Auth_MySQL_Password_Field pass
# Pour l'instant les pass sont enregistr&eacute;s en clair
# le stockage crypt&eacute; est dans la TODO
Auth_MySQL_Encrypted_Passwords off
AuthName "Dolibarr"
require valid-user
satisfy any
&lt;/Location&gt;
&lt;Location /public/&gt;
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Allow from all
&lt;/Location&gt;
&lt;/VirtualHost&gt;
</PRE>
<HR>
</P>
<H2><A NAME="ss3.3">3.3</A> <A HREF="dolibarr-install.html#toc3.3">Fichier de config pour Apache 2 + mod_auth_mysql + webmin</A>
</H2>
<P>
<HR>
<PRE>
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Deny from all
AuthType Basic
# N'utilisez la ligne suivante que si vous utilisez aussi
# le module d'authentification bas&eacute; sur postgresql
AuthMySQLAuthoritative on
# Utilisez les lignes suivantes si le serveur Apache ne
# peut se logger en anonymous (ce qui est conseill&eacute; ;-)
# rq. erics: sur ma debian je n'ai pas le droit de mettre ces
# instructions dans un &lt;virtualhost&gt; ... (apache 1.3.27.0-2)
#AuthMySQL_DefaultHost &lt;host&gt;
#AuthMySQL_DefaultUser &lt;user&gt;
#AuthMySQL_DefaultPassword &lt;pass&gt;
AuthMySQLHost localhost
AuthMySQLUser leDBuser
AuthMySQLPassword leDBpass
AuthMySQLDB dolibarr
AuthMySQLUserTable llx_user
AuthMySQLNameField login
AuthMySQLPasswordField pass
# Pour l'instant les pass sont enregistr&eacute;s en clair
# le stockage crypt&eacute; est dans la TODO
AuthMySQLCryptedPasswords off
AuthName "Dolibarr"
require valid-user
Satisfy any
</PRE>
<HR>
</P>
<P>Pour les gens qui installent Dolibarr dans un r&eacute;pertoire,
utilisez Webmin et ajoutez une "Per-Directory Options" &agrave; votre
serveur virtuel. Utilisez "Location" comme "Type" et "/dolibarr"
comme "Path". Une fois cr&eacute;&eacute;e, editez les directives et copiez la
config ci-dessus, sauvez, restartez Apache et testez en allant &agrave;
domainname.com/dolibarr. Le navigateur va vous demander de taper
le login/pass.</P>
<P>Il faut cr&eacute;er des options pour chaque &lt;Location&gt; du fichier httpd.conf donn&eacute; en exemple.</P>
<P>Merci &agrave; la personne qui m'a transmis ces infos, et aux pr&eacute;c&eacute;dentes qui avaient fait de m&ecirc;me au sujet d'Apache 2</P>
<HR>
Page suivante
<A HREF="dolibarr-install-2.html">Page précédente</A>
<A HREF="dolibarr-install.html#toc3">Table des matières</A>
</BODY>
</HTML>

View File

@ -1,51 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
<TITLE>Dolibarr Installation</TITLE>
<LINK HREF="dolibarr-install-1.html" REL=next>
</HEAD>
<BODY>
<A HREF="dolibarr-install-1.html">Page suivante</A>
Page précédente
Table des matières
<HR>
<H1>Dolibarr Installation</H1>
<H2>Rodolphe Qui&eacute;deville</H2>$Id$
<HR>
<EM>Installation et mise &agrave; jour de Dolibarr</EM>
<HR>
<P>
<H2><A NAME="toc1">1.</A> <A HREF="dolibarr-install-1.html">Installation</A></H2>
<UL>
<LI><A NAME="toc1.1">1.1</A> <A HREF="dolibarr-install-1.html#ss1.1">R&eacute;cup&eacute;rer les sources</A>
<LI><A NAME="toc1.2">1.2</A> <A HREF="dolibarr-install-1.html#ss1.2">Pr&eacute;-requis</A>
<LI><A NAME="toc1.3">1.3</A> <A HREF="dolibarr-install-1.html#ss1.3">Base de donn&eacute;es</A>
<LI><A NAME="toc1.4">1.4</A> <A HREF="dolibarr-install-1.html#ss1.4">Apache</A>
<LI><A NAME="toc1.5">1.5</A> <A HREF="dolibarr-install-1.html#ss1.5">Dolibarr</A>
</UL>
<P>
<H2><A NAME="toc2">2.</A> <A HREF="dolibarr-install-2.html">Mise &agrave; jour</A></H2>
<UL>
<LI><A NAME="toc2.1">2.1</A> <A HREF="dolibarr-install-2.html#ss2.1">Mise &agrave; jour de la base de donn&eacute;es</A>
<LI><A NAME="toc2.2">2.2</A> <A HREF="dolibarr-install-2.html#ss2.2">Autres actions</A>
</UL>
<P>
<H2><A NAME="toc3">3.</A> <A HREF="dolibarr-install-3.html">Annexe A - Fichiers de conf Apache</A></H2>
<UL>
<LI><A NAME="toc3.1">3.1</A> <A HREF="dolibarr-install-3.html#ss3.1">Fichier de config pour Apache 1.3</A>
<LI><A NAME="toc3.2">3.2</A> <A HREF="dolibarr-install-3.html#ss3.2">Fichier de config pour Apache 1.3 + mod_auth_mysql</A>
<LI><A NAME="toc3.3">3.3</A> <A HREF="dolibarr-install-3.html#ss3.3">Fichier de config pour Apache 2 + mod_auth_mysql + webmin</A>
</UL>
<HR>
<A HREF="dolibarr-install-1.html">Page suivante</A>
Page précédente
Table des matières
</BODY>
</HTML>

Binary file not shown.

View File

@ -1,382 +0,0 @@
<!doctype linuxdoc system>
<article>
<!-- Title information -->
<title>Dolibarr Installation</title>
<author>
<name>Rodolphe Quiédeville</name>
</author>
<date>$Id$</date>
<abstract>
Installation et mise à jour de Dolibarr
</abstract>
<!-- Table of contents -->
<toc>
<!-- Begin the document -->
<sect>
<heading>Installation</heading>
<sect1>
<heading>Récupérer les sources</heading>
<p>
Récupérer les sources sur <url url="http://www.dolibarr.com/">
</p>
<p>
Les sources se présentent sous la forme d'un fichier tar compressé avec gzip.
</p>
</sect1>
<sect1>
<heading>Pré-requis</heading>
<p>
Liste des logiciels à installer pour faire fonctionner Dolibarr :
<itemize>
<item>php4</item>
<item>php4-mysql</item>
<item>php4-curl (pour la partie gestion des adhérents)</item>
<item>php4-gd (pour les graphiques)</item>
<item>php4-cli (pour les scripts en mode console)</item>
<item>Apache</item>
</itemize>
Pour la gestion de l'authentification, Dolibarr fonctionne soit avec mod-auth-mysql soit avec Pear. Cette dernière est plus facile à installer.
<itemize>
<item>libapache-mod-auth-mysql</item>
</itemize>
</p>
<sect2>
<heading>Pear</heading>
<p>
Pear n'est plus nécessaire à partir de Dolibarr 2.0.0 les
librairies Pear utilisées ont été incluses dans les sources directement.
</p>
</sect2>
</sect1>
<sect1>
<heading>Base de données</heading>
<p>
1- créer une base de données mysql appelée 'dolibarr' (vous
pouvez changer le nom, dans ce cas remplacer dans la suite des
commandes 'dolibarr' par le nom de votre base de données)
</p>
<p>
<tscreen>
<verb>
# mysqladmin create dolibarr
</verb>
</tscreen>
</p>
<p>
2- charger la base en exécutant :
</p>
<p>
Cette étape n'est plus nécessaire à partir de la version 2.0.0 de
Dolibarr le chargement de la base est effectué lors de l'installation.
<tscreen>
<verb>
# mysql dolibarr < mysql/mysql.sql
</verb>
</tscreen>
</p>
</sect1>
<sect1>
<heading>Apache</heading>
<p>
Pour configurer Apache : des fichier httpd.conf.dist est fournit
avec les sources, vous pouvez vous en servir pour configurer
votre serveur, il est prévu pour que vous ayez juste à ajouter
une régle Include dans votre fichier principal <file>httpd.conf</file>.
</p>
<p>
Utilisez le fichier httpd.conf.dist pour l'authentification par Pear
(conseillé) et le fichier httpd.conf.dist.modauth pour utiliser
mod-auth-mysql.
</p>
</sect1>
<sect1>
<heading>Dolibarr</heading>
<p>
Décompressez l'archive
<tscreen>
<verb>
# tar xvfz dolibarr-2.0.0-alpha1.tgz
</verb>
</tscreen>
</p>
<p>
Créer un répertoire appelé <file>documents</file> au même niveau
que le répertoire <file>htdocs</file> et affectez les
droits d'écriture dans ce répertoire à l'utilisateur exécutant
le serveur web.
<tscreen>
<verb>
# cd dolibarr-2.0.0-alpha1
# mkdir documents
# chown www-data.www-data documents
# chmod 700 documents
</verb>
</tscreen>
</p>
<p>
Ce répertoire peut-être différent, il vous suffira de l'indiquer lors
de la phase d'installation web.
</p>
<p>
Créer un fichier <file>conf/conf.php</file> et donnez les droits
d'écriture dans ce fichier à l'utilisateur exécutant le serveur
web.
<tscreen>
<verb>
# cd htdocs/conf/
# touch conf.php
# chown www-data.www-data conf.php
# chmod 700 conf.php
</verb>
</tscreen>
</p>
<p>
Pour des raisons de securite pensez a modifier les permissions sur ce
fichier, il n'est plus modifie une fois l'installation finie.
</p>
<p>
Pour configurer Dolibarr accédez à la page
<tscreen><verb>/install/index.php</verb></tscreen>
</p>
<p>
Suivez les <20>étapes une <20>à une et l'installation devrait se faire sans douleurs.
</p>
<p>
Si les contrôles sont corrects vous n'avez qu'à cliquer sur le lien, 'Configurer les modules'.
</p>
<p>
Une fois les modules configurés il ne reste plus qu'à définir les
utilisateurs et leurs permissions respectives. Pour cela cliquer sur
Accueil -> Utilisateurs
</p>
<p>
Il est fortement conseillé de supprimer le r<>épertoire
<file>htdocs/install.php</file> une fois l'installation terminée. De
même pensez à modifier les permissions sur le fichier <file>conf/conf.php</file>.
</p>
</sect1>
</sect>
<sect>
<heading>Mise à jour</heading>
<p>
Certaines action sont nécessaires lors de la mise à jour de Dolibarr vers une version plus récente des sources.
</p>
<sect1>
<heading>Mise à jour de la base de données</heading>
<p>
Il peut être nécessaire de faire des modifications sur la structure et/ou les données contenues dans la base Mysql lors de la mise à jour de Dolibarr. Pour cela des scripts sont fournis dans le répertoire <file>mysql/migration/</file>. Il se présente sous la forme a.b.c-e.d.f.sql, les trois premiers numéros indique la version de départ et les 3 suivants la version que vous souhaitez atteindre. Si vous passez par exemple de la version 0.1.3 à la version 0.1.6 il vous faudra appliquer les patchs 0.1.3-0.1.4.sql, 0.1.4-0.1.5.sql et 0.1.5-0.1.6.sql si un patch n'éxiste pas d'une version à une autre c'est qu'il n'y a pas eu de modification de base.
</p>
</sect1>
<sect1>
<heading>Autres actions</heading>
<p>
Il peut-être nécessaire d'effectuer d'autres actions lors de la mise à
jour, comme la désactivation et la réactivation des modules. Cette
information est communiquée dans le fichier README à la racine des sources.
</p>
</sect1>
</sect>
<sect>
<heading>Annexe A - Fichiers de conf Apache</heading>
<sect1>
<heading>Fichier de config pour Apache 1.3</heading>
<p>
Exemple pour l'authentification avec Pear
</p>
<p>
<code>
#
# Sample httpd.conf for dolibarr
#
&lt;VirtualHost dolibarr.lafrere.lan&gt;
ServerAdmin webmaster.fr@lolix.org
DocumentRoot /home/www/dolibarr/dolibarr/htdocs
ServerName dolibarr.lafrere.lan
ErrorLog /home/www/dolibarr/logs/error.log
CustomLog /home/www/dolibarr/logs/access.log combined
ErrorDocument 401 /public/error-401.html
php_flag register_globals on
&lt;/VirtualHost&gt;
</code>
</p>
</sect1>
<sect1>
<heading>Fichier de config pour Apache 1.3 + mod_auth_mysql</heading>
<p>
Cet exemple ne fonctionne pas sur la série Apache 2, voir le fichier correspond dans la section suivante.
</p>
<p>
<code>
#
# Sample httpd.conf for dolibarr
#
&lt;VirtualHost dolibarr.lafrere.lan&gt;
ServerAdmin webmaster.fr@lolix.org
DocumentRoot /home/www/dolibarr/dolibarr/htdocs
ServerName dolibarr.lafrere.lan
ErrorLog /home/www/dolibarr/logs/error.log
CustomLog /home/www/dolibarr/logs/access.log combined
ErrorDocument 401 /public/error-401.html
php_flag register_globals on
&lt;Location /&gt;
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Deny from all
AuthType Basic
# N'utilisez la ligne suivante que si vous utilisez aussi
# le module d'authentification basé sur postgresql
#Auth_MySQL_Authoritative on
# Utilisez les lignes suivantes si le serveur Apache ne
# peut se logger en anonymous (ce qui est conseillé ;-)
# rq. erics: sur ma debian je n'ai pas le droit de mettre ces
# instructions dans un &lt;virtualhost&gt; ... (apache 1.3.27.0-2)
#AuthMySQL_DefaultHost &lt;host&gt;
#AuthMySQL_DefaultUser &lt;user&gt;
#AuthMySQL_DefaultPassword &lt;pass&gt;
Auth_MySQL_DB dolibarr
Auth_MySQL_Password_Table llx_user
Auth_MySQL_Username_Field login
Auth_MySQL_Password_Field pass
# Pour l'instant les pass sont enregistrés en clair
# le stockage crypté est dans la TODO
Auth_MySQL_Encrypted_Passwords off
AuthName "Dolibarr"
require valid-user
satisfy any
&lt;/Location&gt;
&lt;Location /public/&gt;
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Allow from all
&lt;/Location&gt;
&lt;/VirtualHost&gt;
</code>
</p>
</sect1>
<sect1>
<heading>Fichier de config pour Apache 2 + mod_auth_mysql + webmin</heading>
<p>
<code>
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Deny from all
AuthType Basic
# N'utilisez la ligne suivante que si vous utilisez aussi
# le module d'authentification basé sur postgresql
AuthMySQLAuthoritative on
# Utilisez les lignes suivantes si le serveur Apache ne
# peut se logger en anonymous (ce qui est conseillé ;-)
# rq. erics: sur ma debian je n'ai pas le droit de mettre ces
# instructions dans un &lt;virtualhost&gt; ... (apache 1.3.27.0-2)
#AuthMySQL_DefaultHost &lt;host&gt;
#AuthMySQL_DefaultUser &lt;user&gt;
#AuthMySQL_DefaultPassword &lt;pass&gt;
AuthMySQLHost localhost
AuthMySQLUser leDBuser
AuthMySQLPassword leDBpass
AuthMySQLDB dolibarr
AuthMySQLUserTable llx_user
AuthMySQLNameField login
AuthMySQLPasswordField pass
# Pour l'instant les pass sont enregistrés en clair
# le stockage crypté est dans la TODO
AuthMySQLCryptedPasswords off
AuthName "Dolibarr"
require valid-user
Satisfy any
</code>
</p>
<p>
Pour les gens qui installent Dolibarr dans un répertoire,
utilisez Webmin et ajoutez une "Per-Directory Options" à votre
serveur virtuel. Utilisez "Location" comme "Type" et "/dolibarr"
comme "Path". Une fois créée, editez les directives et copiez la
config ci-dessus, sauvez, restartez Apache et testez en allant à
domainname.com/dolibarr. Le navigateur va vous demander de taper
le login/pass.
Il faut créer des options pour chaque &lt;Location&gt; du fichier httpd.conf donné en exemple.
</p>
<p>
Merci à la personne qui m'a transmis ces infos, et aux précédentes qui avaient fait de même au sujet d'Apache 2
</p>
</sect1>
</sect>
</article>

View File

@ -1,316 +0,0 @@
Dolibarr Installation
Rodolphe Quiédeville
$Id: dolibarr-install.sgml,v 1.11 2004/02/12 09:54:20 erics
Exp $
Installation et mise à jour de Dolibarr
______________________________________________________________________
Table des matières
1. Installation
1.1 Récupérer les sources
1.2 Pré-requis
1.2.1 Pear
1.3 Base de données
1.4 Apache
1.5 Dolibarr
2. Mise à jour
2.1 Mise à jour de la base de données
2.2 Autres actions
3. Annexe A - Fichiers de conf Apache
3.1 Fichier de config pour Apache 1.3
3.2 Fichier de config pour Apache 1.3 + mod_auth_mysql
3.3 Fichier de config pour Apache 2 + mod_auth_mysql + webmin
______________________________________________________________________
1. Installation
1.1. Récupérer les sources
Récupérer les sources sur <http://www.dolibarr.com/>
Les sources se présentent sous la forme d'un fichier tar compressé
avec gzip.
1.2. Pré-requis
Liste des logiciels à installer pour faire fonctionner Dolibarr :
· php4
· php4-mysql
· php4-curl (pour la partie gestion des adhérents)
· php4-gd (pour les graphiques)
· php4-cli (pour les scripts en mode console)
· Apache
Pour la gestion de l'authentification, Dolibarr fonctionne soit
avec mod-auth-mysql soit avec Pear. Cette dernière est plus facile
à installer.
· libapache-mod-auth-mysql
1.2.1. Pear
Pear n'est plus nécessaire à partir de Dolibarr 2.0.0 les librairies
Pear utilisées ont été incluses dans les sources directement.
1.3. Base de données
1- créer une base de données mysql appelée 'dolibarr' (vous pouvez
changer le nom, dans ce cas remplacer dans la suite des commandes
'dolibarr' par le nom de votre base de données)
# mysqladmin create dolibarr
2- charger la base en exécutant :
Cette étape n'est plus nécessaire à partir de la version 2.0.0 de
Dolibarr le chargement de la base est effectué lors de l'installation.
# mysql dolibarr < mysql/mysql.sql
1.4. Apache
Pour configurer Apache : des fichier httpd.conf.dist est fournit avec
les sources, vous pouvez vous en servir pour configurer votre serveur,
il est prévu pour que vous ayez juste à ajouter une régle Include dans
votre fichier principal httpd.conf.
Utilisez le fichier httpd.conf.dist pour l'authentification par Pear
(conseillé) et le fichier httpd.conf.dist.modauth pour utiliser mod-
auth-mysql.
1.5. Dolibarr
Créer un répertoire appelé document dans le répertoire htdocs des
sources et affectez les droits d'écriture dans ce répertoire à
l'utilisateur exécutant le serveur web.
Créer un fichier conf/conf.php et donnez les droits d'écriture dans ce
fichier à l'utilisateur exécutant le serveur web.
Pour configurer Dolibarr accédez à la page
/install/index.php
, pour vous logger utlisez le login admin avec le mot de passe admin.
Si les contrôles sont corrects vous n'avez qu'à cliquer sur le lien,
'Configurer les modules'.
Une fois les modules configurés il ne reste plus qu'à définir les
utilisateurs et leurs permissions respectives. Pour cela cliquer sur
Accueil -> Utilisateurs
Il est fortement conseillé de supprimer le fichier install.php une
fois l'installation terminée. De même pensez à modifier le mot de
passe de l'utilisateur admin.
2. Mise à jour
Certaines action sont nécessaires lors de la mise à jour de Dolibarr
vers une version plus récente des sources.
2.1. Mise à jour de la base de données
Il peut être nécessaire de faire des modifications sur la structure
et/ou les données contenues dans la base Mysql lors de la mise à jour
de Dolibarr. Pour cela des scripts sont fournis dans le répertoire
mysql/migration/. Il se présente sous la forme a.b.c-e.d.f.sql, les
trois premiers numéros indique la version de départ et les 3 suivants
la version que vous souhaitez atteindre. Si vous passez par exemple de
la version 0.1.3 à la version 0.1.6 il vous faudra appliquer les
patchs 0.1.3-0.1.4.sql, 0.1.4-0.1.5.sql et 0.1.5-0.1.6.sql si un patch
n'éxiste pas d'une version à une autre c'est qu'il n'y a pas eu de
modification de base.
2.2. Autres actions
Il peut-être nécessaire d'effectuer d'autres actions lors de la mise à
jour, comme la désactivation et la réactivation des modules. Cette
information est communiquée dans le fichier README à la racine des
sources.
3. Annexe A - Fichiers de conf Apache
3.1. Fichier de config pour Apache 1.3
Exemple pour l'authentification avec Pear
______________________________________________________________________
#
# Sample httpd.conf for dolibarr
#
<VirtualHost dolibarr.lafrere.lan>
ServerAdmin webmaster.fr@lolix.org
DocumentRoot /home/www/dolibarr/dolibarr/htdocs
ServerName dolibarr.lafrere.lan
ErrorLog /home/www/dolibarr/logs/error.log
CustomLog /home/www/dolibarr/logs/access.log combined
ErrorDocument 401 /public/error-401.html
php_flag register_globals on
</VirtualHost>
______________________________________________________________________
3.2. Fichier de config pour Apache 1.3 + mod_auth_mysql
Cet exemple ne fonctionne pas sur la série Apache 2, voir le fichier
correspond dans la section suivante.
______________________________________________________________________
#
# Sample httpd.conf for dolibarr
#
<VirtualHost dolibarr.lafrere.lan>
ServerAdmin webmaster.fr@lolix.org
DocumentRoot /home/www/dolibarr/dolibarr/htdocs
ServerName dolibarr.lafrere.lan
ErrorLog /home/www/dolibarr/logs/error.log
CustomLog /home/www/dolibarr/logs/access.log combined
ErrorDocument 401 /public/error-401.html
php_flag register_globals on
<Location />
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Deny from all
AuthType Basic
# N'utilisez la ligne suivante que si vous utilisez aussi
# le module d'authentification basé sur postgresql
#Auth_MySQL_Authoritative on
# Utilisez les lignes suivantes si le serveur Apache ne
# peut se logger en anonymous (ce qui est conseillé ;-)
# rq. erics: sur ma debian je n'ai pas le droit de mettre ces
# instructions dans un <virtualhost> ... (apache 1.3.27.0-2)
#AuthMySQL_DefaultHost <host>
#AuthMySQL_DefaultUser <user>
#AuthMySQL_DefaultPassword <pass>
Auth_MySQL_DB dolibarr
Auth_MySQL_Password_Table llx_user
Auth_MySQL_Username_Field login
Auth_MySQL_Password_Field pass
# Pour l'instant les pass sont enregistrés en clair
# le stockage crypté est dans la TODO
Auth_MySQL_Encrypted_Passwords off
AuthName "Dolibarr"
require valid-user
satisfy any
</Location>
<Location /public/>
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Allow from all
</Location>
</VirtualHost>
______________________________________________________________________
3.3. Fichier de config pour Apache 2 + mod_auth_mysql + webmin
______________________________________________________________________
Options Indexes FollowSymLinks
AllowOverride All
Order deny,allow
Deny from all
AuthType Basic
# N'utilisez la ligne suivante que si vous utilisez aussi
# le module d'authentification basé sur postgresql
AuthMySQLAuthoritative on
# Utilisez les lignes suivantes si le serveur Apache ne
# peut se logger en anonymous (ce qui est conseillé ;-)
# rq. erics: sur ma debian je n'ai pas le droit de mettre ces
# instructions dans un <virtualhost> ... (apache 1.3.27.0-2)
#AuthMySQL_DefaultHost <host>
#AuthMySQL_DefaultUser <user>
#AuthMySQL_DefaultPassword <pass>
AuthMySQLHost localhost
AuthMySQLUser leDBuser
AuthMySQLPassword leDBpass
AuthMySQLDB dolibarr
AuthMySQLUserTable llx_user
AuthMySQLNameField login
AuthMySQLPasswordField pass
# Pour l'instant les pass sont enregistrés en clair
# le stockage crypté est dans la TODO
AuthMySQLCryptedPasswords off
AuthName "Dolibarr"
require valid-user
Satisfy any
______________________________________________________________________
Pour les gens qui installent Dolibarr dans un répertoire, utilisez
Webmin et ajoutez une "Per-Directory Options" à votre serveur virtuel.
Utilisez "Location" comme "Type" et "/dolibarr" comme "Path". Une fois
créée, editez les directives et copiez la config ci-dessus, sauvez,
restartez Apache et testez en allant à domainname.com/dolibarr. Le
navigateur va vous demander de taper le login/pass.
Il faut créer des options pour chaque <Location> du fichier httpd.conf
donné en exemple.
Merci à la personne qui m'a transmis ces infos, et aux précédentes qui
avaient fait de même au sujet d'Apache 2