Installer le CRM vTiger sur Debian

Ce guide est testé sur:

• Debian 8.0 Jessie

Ce guide est testé avec ces versions de vTiger:

• 6.5.0

Prérequis

Ce guide nécessite:

• a2tools, l'outil d'administration simplifiée d'Apache 2.
• un serveur HTTP avec support du PHP, comme décrit par Installer PHP-FPM sur Debian.
• php-tools, l'outil de configuration simplifiée de PHP.
• un serveur MySQL, comme décrit par Installer et configurer MySQL sur Debian.
• mysql-tools, l'outil d'administration simplifiée de MySQL sur l'hôte local (et l'hôte du serveur MySQL, si différent).

Paramètres

Renseignez le nom de domaine où sera disponible l'application:

domain="vtigercrm.domain.com"

Renseignez le nom d'hôte du serveur MySQL:

mysqlHost="localhost"

Si le serveur MySQL n'est pas local, l'outil mysql-tools essaiera de s'y connecter avec le client MySQL, ou, en cas d'échec de connexion, via une connexion SSH.

Renseignez le nom du certificat SSL à utiliser pour chiffrer l'application avec HTTPS (créé via la procédure Créer un certificat SSL / TLS sur Debian ou via Let's Encrypt) (optionnel, recommandé):

sslKeyName="auto"

Installation

Détectez le proxy de commande (command ou sudo):

cmdProxy='command'
command type -f 'sudo' &>'/dev/null' && cmdProxy='sudo'

Déterminez le chemin d'installation:

installPath="/var/lib/vtiger/${domain}"

Créez les dossiers:

${cmdProxy} mkdir --parent "${installPath}"

Préparation de l'environnement

Installez les logiciels nécessaires:

${cmdProxy} apt-get install php5-mysql php5-imap php5-gd unzip

Adaptez la configuration PHP aux besoins de l'outil:

${cmdProxy} php-tools --for="vtiger" --set "memory_limit" "64M"
${cmdProxy} php-tools --for="vtiger" --set "max_execution_time" "1800"
${cmdProxy} php-tools --for="vtiger" --set "output_buffering" "1"
${cmdProxy} php-tools --for="vtiger" --set "upload_max_filesize" "20M"
${cmdProxy} php-tools --for="vtiger" --set "post_max_size" "20M"

Remarque: le script d'installation de vTiger peut durer plus de 10 minutes. Si vous utilisez une configuration FPM, n'oubliez pas de vérifier la valeur de "request_terminate_timeout" dans "/etc/php5/fpm/pool.d/*.conf" et de "idle-timeout" dans "/etc/apache2/mods-available/php5-fpm.conf". Ces valeurs doivent être légèrement supérieures à la valeur max_execution_time de la configuration PHP.

Rechargez la configuration de PHP:

${cmdProxy} php-tools --reload

Mise en place de l'application

Obtenez les sources de la dernière version du logiciel à l'aide de sf-downloader:

command wget 'https://raw.github.com/biapy/howto.biapy.com/master/various/sf-downloader' \
    --quiet --no-check-certificate --output-document='/tmp/sf-downloader'
command chmod +x '/tmp/sf-downloader'
source="$(${cmdProxy} /tmp/sf-downloader \
    --output-directory="${installPath}" \
    --strip-components=1 \
    --tgz 'vtigercrm' 'vtigercrmVERSION.tar.gz')"

Ajustez les permissions:

${cmdProxy} chown -R www-data:www-data "${installPath}"
${cmdProxy} chmod -R o-w "${installPath}"

Mettez en place le fichier .htaccess:

${cmdProxy} mv "${installPath}/htaccess.txt" "${installPath}/.htaccess"

Création de la base de données

Créez la base de données:

command mysql-tools --server="${mysqlHost}" --with-ssh \
        --auto-hosts --db-prefix="vtiger" --create "${domain}"

Notez les informations de connexion fournies par la commande.

Mise en place de l'hôte virtuel

Créez la configuration du serveur HTTP:

if [[ -n "${sslKeyName}" && ( -e "/etc/ssl/private/${sslKeyName}.key" || "${sslKeyName}" = 'auto' ) ]]; then
  ${cmdProxy} a2tools --ssl="${sslKeyName}" --overrides='Options' "${domain}" "${installPath}"
else
  ${cmdProxy} a2tools --overrides='Options' "${domain}" "${installPath}"
fi 

L'outil est maintenant disponible sur le domaine spécifié en HTTP ou HTTPS si possible.

Configuration

Configurez l'application à l'aide du script d'installation, disponible à l'adresse fournie par:

echo "http://${domain}/"

Important : lors des vérification de "pré-installation", les paramètres PHP recommandés pour vTiger ne sont pas respectées. Ces recommandations posent un risque de sécurité. Je les ai ignorées.

Renseignez les paramètres demandés:

• Identifiant et mot de passe de l'administrateur,
• monnaie que vous utilisez (Euro),
• etc.

Traduction

Activez la traduction française (après la fin de l'installation):

${cmdProxy} sed -i -e "s/^\(.*default_language.*'\).*\('.*\)/\1fr_fr\2/" \
         "${installPath}/config.inc.php"

Sauvegardes

Sauvegardez l'installation avec Backup Manager (voir Installer et configurer Backup Manager sur Debian):

${cmdProxy} backup-manager-tools add "${installPath}"

N'oubliez pas de sauvegarder la base de données (voir Installer et configurer MySQL sur Debian).

Remerciements

• Merci aux développeurs de vTiger.
• Merci à djantje pour #7618 : 3 Changes / fixes to support PHP v5.4.