diff --git a/doc/install/Makefile b/doc/install/Makefile deleted file mode 100644 index 90b9c9b2199..00000000000 --- a/doc/install/Makefile +++ /dev/null @@ -1,42 +0,0 @@ -# Copyright (C) 2003 Rodolphe Quiedeville -# -# 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 \ No newline at end of file diff --git a/doc/install/README b/doc/install/README new file mode 100644 index 00000000000..167578da010 --- /dev/null +++ b/doc/install/README @@ -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 diff --git a/doc/install/README-FR b/doc/install/README-FR new file mode 100644 index 00000000000..be656dd0541 --- /dev/null +++ b/doc/install/README-FR @@ -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 diff --git a/doc/install/dolibarr-install-1.html b/doc/install/dolibarr-install-1.html deleted file mode 100644 index 73122f5f958..00000000000 --- a/doc/install/dolibarr-install-1.html +++ /dev/null @@ -1,115 +0,0 @@ - - - - - Dolibarr Installation: Installation - - - - - -Page suivante -Page précédente -Table des matières -
-

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 :

-

-

- -Pour la gestion de l'authentification, Dolibarr fonctionne soit avec mod-auth-mysql soit avec Pear. Cette dernière est plus facile à installer. - -

-

Pear

- -

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) :

-

-

-

-

Pour installer un paquet Pear, exécutez en root '$ pear install <nom du paquet>'.

-

Pour plus d'informations sur Pear et sa configuration, veuillez vous reporter à son site officiel -pear.php.net.

-

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 :

-

-

-
-        # 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/
-
-
-, 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.

-
-Page suivante -Page précédente -Table des matières - - diff --git a/doc/install/dolibarr-install-2.html b/doc/install/dolibarr-install-2.html deleted file mode 100644 index a5cb8356333..00000000000 --- a/doc/install/dolibarr-install-2.html +++ /dev/null @@ -1,33 +0,0 @@ - - - - - Dolibarr Installation: Mise à jour - - - - - -Page suivante -Page précédente -Table des matières -
-

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.

-
-Page suivante -Page précédente -Table des matières - - diff --git a/doc/install/dolibarr-install-3.html b/doc/install/dolibarr-install-3.html deleted file mode 100644 index 0222f0c0e43..00000000000 --- a/doc/install/dolibarr-install-3.html +++ /dev/null @@ -1,172 +0,0 @@ - - - - - Dolibarr Installation: Annexe A - Fichiers de conf Apache - - - - -Page suivante -Page précédente -Table des matières -
-

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

-
-Page suivante -Page précédente -Table des matières - - diff --git a/doc/install/dolibarr-install.html b/doc/install/dolibarr-install.html deleted file mode 100644 index b78fe88365d..00000000000 --- a/doc/install/dolibarr-install.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - Dolibarr Installation - - - - - -Page suivante -Page précédente -Table des matières -
-

Dolibarr Installation

- -

Rodolphe Quiédeville

$Id$ -
-Installation et mise à jour de Dolibarr -
-

-

1. Installation

- - -

-

2. Mise à jour

- - -

-

3. Annexe A - Fichiers de conf Apache

- - -
-Page suivante -Page précédente -Table des matières - - diff --git a/doc/install/dolibarr-install.pdf b/doc/install/dolibarr-install.pdf deleted file mode 100644 index 15383c68d88..00000000000 Binary files a/doc/install/dolibarr-install.pdf and /dev/null differ diff --git a/doc/install/dolibarr-install.sgml b/doc/install/dolibarr-install.sgml deleted file mode 100644 index 9b7df6bee32..00000000000 --- a/doc/install/dolibarr-install.sgml +++ /dev/null @@ -1,382 +0,0 @@ - - -
- - - -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 -

- - - - - -
diff --git a/doc/install/dolibarr-install.txt b/doc/install/dolibarr-install.txt deleted file mode 100644 index 021156ae8bc..00000000000 --- a/doc/install/dolibarr-install.txt +++ /dev/null @@ -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 - - 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 - # - - 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 - - - - ______________________________________________________________________ - - - - 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 - # - - 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 - - - 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 ... (apache 1.3.27.0-2) - #AuthMySQL_DefaultHost - #AuthMySQL_DefaultUser - #AuthMySQL_DefaultPassword - - 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 - - - - Options Indexes FollowSymLinks - AllowOverride All - Order deny,allow - Allow from all - - - - - ______________________________________________________________________ - - - - 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 ... (apache 1.3.27.0-2) - #AuthMySQL_DefaultHost - #AuthMySQL_DefaultUser - #AuthMySQL_DefaultPassword - - 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 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 - - -