Dolibarr Installation Rodolphe Quiédeville $Id$ Installation et mise à jour de Dolibarr Installation Récupérer les sources

Récupérer les sources sur

Les sources se présentent sous la forme d'un fichier tar compressé avec gzip.

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

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.

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

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.

Dolibarr

Décompressez l'archive # tar xvfz dolibarr-2.0.0-alpha1.tgz

Créer un répertoire appelé documents au même niveau que le répertoire htdocs et affectez les droits d'écriture dans ce répertoire à l'utilisateur exécutant le serveur web. # cd dolibarr-2.0.0-alpha1 # mkdir documents # chown www-data.www-data documents # chmod 700 documents

Ce répertoire peut-être différent, il vous suffira de l'indiquer lors de la phase d'installation web.

Créer un fichier conf/conf.php et donnez les droits d'écriture dans ce fichier à l'utilisateur exécutant le serveur web. # cd htdocs/conf/ # touch conf.php # chown www-data.www-data conf.php # chmod 700 conf.php

Pour des raisons de securite pensez a modifier les permissions sur ce fichier, il n'est plus modifie une fois l'installation finie.

Pour configurer Dolibarr accédez à la page /install/index.php

Suivez les étapes une à une et l'installation devrait se faire sans douleurs.

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 répertoire htdocs/install.php une fois l'installation terminée. De même pensez à modifier les permissions sur le fichier conf/conf.php.

Mise à jour

Certaines action sont nécessaires lors de la mise à jour de Dolibarr vers une version plus récente des sources.

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.

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.

Annexe A - Fichiers de conf Apache 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>

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>

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