179 lines
4.9 KiB
Plaintext
179 lines
4.9 KiB
Plaintext
<!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>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>Pear (package Auth)</item>
|
|
<item>libapache-mod-auth-mysql</item>
|
|
</itemize>
|
|
</p>
|
|
|
|
<sect2>
|
|
<heading>Pear</heading>
|
|
<p>
|
|
Pear est un ensemble de classes et d'outils pour les installer et les mettre à jour. Les classes requises pour Dolibarr sont (par ordre d'installation) :
|
|
|
|
<itemize>
|
|
<item>Archive_Tar</item>
|
|
<item>Console_Getopt</item>
|
|
<item>PEAR</item>
|
|
<item>Auth</item>
|
|
<item>DB</item>
|
|
</itemize>
|
|
</p>
|
|
<p>
|
|
Pour installer un paquet Pear, exécutez en root '$ pear install <nom du paquet>'.
|
|
</p>
|
|
<p>
|
|
Pour plus d'informations sur Pear et sa configuration, veuillez vous reporter à son site officiel <url url="pear.php.net">.
|
|
</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>
|
|
<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>
|
|
Créer un répertoire appelé <file>document</file> dans le répertoire <file>htdocs</file> des sources et affectez les droits d'écriture dans ce répertoire à l'utilisateur exécutant le serveur 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.
|
|
</p>
|
|
|
|
<p>
|
|
Pour configurer Dolibarr accédez à la page
|
|
<tscreen><verb>/install.php</verb></tscreen>, pour vous logger utlisez
|
|
le login <bf>admin</bf> avec le mot de passe <bf>admin</bf>.
|
|
</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 fichier install.php une fois l'installation terminée. De même pensez à modifier le mot de passe de l'utilisateur admin.
|
|
</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>
|
|
|
|
|
|
|
|
</article>
|