============== Dolibarr HOWTO (c) Nicolas Kovacs ============== Dernière révision : 26 août 2016 Ce HOWTO décrit l'installation et la maintenance de Dolibarr sur un serveur Slackware. * Installation * Mise à jour * Installer le module Multi-société * Élargir la colonne des libellés Installation ------------ Créer la base de données : # mysql -u root -p mysql> create database dolibarr; mysql> grant all on dolibarr.* to dolibarruser@localhost -> identified by '********'; mysql> flush privileges; Bye # cd /var/www/vhosts Télécharger Dolibarr : * http://www.dolibarr.fr Décompresser l'archive téléchargée : # cd /var/www/vhosts # unzip /root/webapps/dolibarr/dolibarr-3.9.1.zip Renommer en fonction de l'hébergement : # mv dolibarr-x.y.z societe-dolibarr Régler les droits d'accès et les permissions de fichiers : # chown -R apache:apache dolibarr/ # find dolibarr/ -type d -exec chmod 0750 \{} \; # find dolibarr/ -type f -exec chmod 0640 \{} \; Créer un fichier de configuration vide : # cd dolibarr # touch htdocs/conf/conf.php Définir les permissions de ce fichier : # chown apache:apache htdocs/conf/conf.php Créer le répertoire qui servira aux documents générés ou stockés par Dolibarr. Attention, il doit bien être à l'extérieur de l'arborescence du site, pour des raisons de sécurité évidentes : # mkdir documents Définir les permissions du répertoire : # chown -R apache:apache documents/ Créer un hôte virtuel, comme ceci par exemple : --8<---------- /etc/httpd/extra/httpd-vhosts.conf ---------------------------- ... # dolibarr.nestor.microlinux.montpezat ServerAdmin info@microlinux.fr ServerName dolibarr.nestor.microlinux.montpezat ServerAlias dolibarr.nestor DocumentRoot /srv/httpd/vhosts/dolibarr/htdocs ErrorLog "/var/log/httpd/dolibarr-error.log" CustomLog "/var/log/httpd/dolibarr-access.log" common --8<-------------------------------------------------------------------------- Redémarrer Apache : # /etc/rc.d/rc.httpd restart Pointer le navigateur sur la page principale, par exemple : * http://dolibarr.nestor Suivre les instructions de l'installation. Une fois l'installation terminée, on peut la verrouiller comme ceci : # cd /var/www/vhosts/dolibarr/documents # touch install.lock # chmod 0440 install.lock Accéder à l'interface d'administration et procéder à la configuration de base : * Nom de la société * Modules Mise à jour ----------- Vérifier si l'installation existante comporte un fichier 'install.lock' et supprimer ce fichier le cas échéant. Récupérer la dernière version de Dolibarr et la ranger à la racine du serveur Web : # cd /var/www/vhosts Décompresser l'archive : # tar xvzf dolibarr-x.y.z.tgz Recopier les nouveaux fichiers dans le répertoire dolibarr-x.y.z vers le répertoire contenant l'ancienne version de Dolibarr. Ceci a pour effet de remplacer les anciens fichiers par les nouveaux, tout en conservant les fichiers qui sont spécifiques à l'installation, comme le fichier conf.php ou encore les modules complémentaires installés. Au cas où la commande 'cp' comporte un alias vers 'cp -i', on utilisera l'astuce suivante pour éviter la confirmation pour chaque fichier : # scp -r dolibarr-x.y.z/* dolibarr/ À partir de là, on pourra supprimer le répertoire des fichiers sources : # rm -rf dolibarr-x.y.z/ Régler les droits d'accès et les permissions de fichiers : # chown -R apache:apache dolibarr/ # find dolibarr/ -type d -exec chmod 0750 \{} \; # find dolibarr/ -type f -exec chmod 0640 \{} \; Pointer le navigateur sur la page d'installation : * http://chemin_vers_dolibarr/install/ Choisir 'Mise à jour' dans le menu proposé, en respectant les versions intermédiaires successives. Lancer les étapes de migration successives. Une fois la mise à jour terminée, verrouiller le répertoire d'installation : # touch documents/install.lock # chmod 0440 documents/install.lock Vérifier les droits d'accès du fichier de configuration et les modifier le cas échéant : # chmod 0440 htdocs/conf/conf.php Installer le module Multi-société --------------------------------- Créer un répertoire 'custom' qui contiendra les modules tiers : # mkdir htdocs/custom Éditer le fichier 'htdocs/conf/conf.php' et définir le chemin vers les modules. Il suffira éventuellement de décommenter les deux lignes correspondantes : --8<---------- conf.php ------------------------------------------------------ ... $dolibarr_main_url_root='http://myserver'; $dolibarr_main_document_root='/path/of/dolibarr/htdocs'; $dolibarr_main_url_root_alt='http://myserver/custom'; $dolibarr_main_document_root_alt='/path/of/dolibarr/htdocs/custom'; ... --8<-------------------------------------------------------------------------- Décompresser le module : # unzip module_multicompany_3.4.0.zip Déplacer l'arborescence résultante vers l'endroit approprié : # mv multicompany/ chemin_vers_dolibarr/htdocs/custom/ Régler les droits d'accès : # chown -R apache:apache chemin_vers_dolibarr/htdocs/custom/ Élargir la colonne des libellés ------------------------------- Lorsqu'on affiche la liste des Produits ou des Services, la colonne "Libellé" n'est pas assez large pour afficher certains produits dont la dénomination est plus longue. Pour remédier à cela, on peut aller dans 'htdocs/product' et éditer le fichier 'list.php', en remplaçant la valeur maximale 40 par une valeur supérieure, comme ceci par exemple : --8<---------- htdocs/product/list.php --------------------------------------- // Label if (! empty($arrayfields['p.label']['checked'])) { print ''.dol_trunc($objp->label,60).''; } --8<-------------------------------------------------------------------------- ------------------------------------------------------------------------------ # vim: syntax=txt