Ce guide a été testé sur :

• Debian 6.0 Squeeze
  

Pré-requis

Ce guide nécessite un serveur MySQL disposant du script mysql-tools disponible dans le guide Installer et configurer MySQL sur Debian.

Ce guide nécessite un serveur HTTP avec support du PHP disposant au choix d'un des scripts suivant :

• Le script a2tools disponible dans mon guide Installer Apache 2 sur Debian.
  
• Le script lighty-tools disponible dans mon guide Installer Lighttpd et PHP 5 sur Debian.

Paramètres

Renseignez le nom de domaine ou sera disponible l'application :

DOMAIN="crm.domaine-exemple.fr"

Renseignez le nom d'hôte de votre serveur MySQL (si vous ne savez pas de quoi il s'agit, ne modifiez pas cette valeur) :

MYSQL_HOST="localhost"

Si votre serveur MySQL n'est pas local, ce guide effectuera une connexion SSH pour y créer la base de données.

Installation

Préparation de l'environnement

Installez les logiciels et modules PHP nécessaires à l'installation et au bon fonctionnement de l'application :

command apt-get install php5-mysql unzip

Augmentez la limite mémoire de PHP pour l'application :

MEMORY_LIMIT="256M"
if [ -e "/etc/php5/conf.d/memory-limit.ini" ]; then
  CURRENT_MEMORY_LIMIT=$(command grep 'memory_limit' /etc/php5/conf.d/memory-limit.ini \
        | command cut --delimiter='=' --fields='2-' \
        | command sed -e 's/^[ \t]*//g')
  if [ "$(echo "${CURRENT_MEMORY_LIMIT}" | command sed -e 's/M$//g')" \
       -gt "$(echo "${MEMORY_LIMIT}" | command sed -e 's/M$//g')" ]; then
    MEMORY_LIMIT="${CURRENT_MEMORY_LIMIT}"
  fi
fi
echo "; Memory limit for PHP scripts.
memory_limit = ${MEMORY_LIMIT}" > "/etc/php5/conf.d/memory-limit.ini"

Ajoutez les paramètres de configuration PHP adaptés à vTiger:

echo ";PHP settings for Dolibarr
magic_quotes_gpc = Off" > /etc/php5/conf.d/dolibarr.ini

command test -x "/etc/init.d/lighttpd" && /etc/init.d/lighttpd force-reload
command test -x "/etc/init.d/apache2" && /etc/init.d/apache2 force-reload

Mise en place de l'application

Récupérez l'URL de téléchargement des sources de l'application :

SOURCE_URL="$(command wget --quiet --output-document=- \
    'http://sourceforge.net/projects/dolibarr/' \
    | command grep 'title="Download' \
    | command sed -e 's|.*href="\([^"]*\)".*|\1|')"
VERSION="$(echo "${SOURCE_URL}" \
    | command sed -e 's/.*dolibarr-\(.*\).tgz.*/\1/g')"

command wget "${SOURCE_URL}" \
    --output-document="/tmp/dolibarr-${VERSION}.tgz"

Décompressez l'archive obtenue :

command tar --directory="/tmp" -xzf "/tmp/dolibarr-${VERSION}.tgz"

Déplacez le dossier obtenu vers son emplacement final :

command mv "/tmp/dolibarr-${VERSION}" "/opt/${DOMAIN}"

Supprimez le fichier téléchargé :

command rm "/tmp/dolibarr-${VERSION}.tgz"

Ajustez les permissions par défaut de fichiers :

command find "/opt/${DOMAIN}" -type d -print0 | command xargs -0 -iDIR chmod 755 DIR
command find "/opt/${DOMAIN}" -type f -print0 | command xargs -0 -iFILE chmod 644 FILE

Déplacez le dossier destiné à contenir les documents à l'emplacement adéquat :

command mkdir --parent "/var/lib/dolibarr/${DOMAIN}"
command ln -s "/var/lib/dolibarr/${DOMAIN}" "/opt/${DOMAIN}/documents"
command chown -R www-data:www-data "/var/lib/dolibarr/${DOMAIN}"

Créez le fichier destiné à contenir la configuration de l'application, et donnez lui les permissions adéquates :

command touch "/opt/${DOMAIN}/htdocs/conf/conf.php"
command chown www-data:www-data "/opt/${DOMAIN}/htdocs/conf/conf.php"

Création de la base de données

Créez la base de données :

if [ "${MYSQL_HOST}" = "localhost" ]; then
  MYSQL_PARAMS=$(command mysql-tools create-domain-db "${DOMAIN}")
else
  command echo "Saisissez le mot de passe de l'utilisateur root MySQL :"
  command read PASSWORD
  MYSQL_PARAMS=$(command ssh "root@${MYSQL_HOST}" "command mysql-tools create-domain-db '${DOMAIN}' '$(command cat /etc/mailname)' '${PASSWORD}'")
fi

Récupérez les paramètres de la nouvelle base de données, et notez les précieusement, vous les utiliserez durant la procédure de configuration de l'application :

echo "${MYSQL_PARAMS}"

Mise en place de l'hôte virtuel

Créez la configuration du serveur HTTP pour votre domaine :

if [ -x "/usr/bin/a2tools" ]; then
  command a2tools add-vhost "${DOMAIN}" "/opt/${DOMAIN}/htdocs/"
fi
if [ -x "/usr/bin/lighty-tools" ]; then
  command lighty-tools add-vhost "${DOMAIN}" "/opt/${DOMAIN}/htdocs/"
fi

Important : les commandes ci-dessus ne mettent pas en place un hôte HTTPS. Je vous conseille de les adapter afin que votre CRM ne soit visible que sur une connexion HTTPS.

Votre installation de Dolibarr devrait maintenant être disponible sur le nom de domaine que vous avez spécifié. Configurez l'application à l'aide du script d'installation.

Une fois l'installation terminée, nous sécurisons l'ensemble un minimum :

command chown root:root "/opt/${DOMAIN}/htdocs/conf/conf.php"
command rm -r "/opt/${DOMAIN}/htdocs/install"

Sauvegardes

Pour sauvegarder votre installation, je vous conseille d'utiliser Backup Manager. Pour l'installer, vous pouvez suivre mon guide:

Installer et configurer Backup Manager sur Debian

Une fois Backup Manager installé, configurez la sauvegarde des fichiers avec la commande suivante:

command update-bm-folders add /opt/${DOMAIN}
command update-bm-folders add /var/lib/dolibarr

Important: Sauvegarder les fichiers ne suffit pas ! Il faut aussi sauvegarder la base de données. La procédure pour ce faire est disponible dans mon article MySQL sur Debian.

Remerciements

• Merci aux développeurs de Dolibarr.