SuiteCRM, un fork de SugarCRM, est une plate-forme open source de gestion de la relation client (CRM) d'entreprise écrite en langage de programmation PHP qui peut être utilisée pour créer des stratégies, des actions et des décisions commerciales.
Ce tutoriel décrit toutes les étapes nécessaires pour installer la dernière version de la plate-forme SuiteCRM sur une Debian 9, afin de déployer une puissante plate-forme en ligne pour votre entreprise. L'application CRM sera déployée sur Debian Linux sous serveur Apache HTTP, PHP et moteur de base de données MariaDB.
Exigences
- Un serveur bare-metal ou un serveur privé virtuel avec au moins 2 Go de RAM et l'installation minimale du serveur Debian 9.
- Accès à la racine compte via la console de la machine ou à distance via SSH. Outre le compte root, vous pouvez également utiliser un compte avec des privilèges root via sudo commande.
- L'interface réseau externe configurée avec une adresse IP statique ou le serveur DHCP configuré pour louer une adresse IP statique pour cette interface.
- Un nom de domaine public enregistré pour accéder à l'application depuis Internet. Si l'application est déployée sur des intranets, vous pouvez effectuer le processus d'installation et accéder au site Web via l'adresse IP de votre serveur.
- Un serveur de messagerie configuré dans vos locaux afin d'utiliser l'enregistrement sur le site Web ou d'autres fonctionnalités de l'application. Vous pouvez également utiliser un service de messagerie public, tel que Gmail ou Yahoo!, Microsoft Exchange ou autres pour envoyer et recevoir des e-mails.
Préparer le serveur
Dans la première étape, connectez-vous à la console de votre serveur avec le compte root ou un utilisateur disposant des privilèges root obtenus via sudo et configurez le nom de votre système avec la commande ci-dessous. Assurez-vous de remplacer le nom d'hôte de la machine utilisé dans cet exemple en conséquence.
hostnamectl set-hostname www.mycrm.org
Après avoir modifié le nom d'hôte du système, lancez la commande ci-dessous pour vérifier si le nom de la machine a été correctement appliqué.
hostnamectl
cat /etc/hostname
hostname –s
hostname –f
Ensuite, assurez-vous de mettre à jour vos référentiels système, vos progiciels et le noyau en exécutant les commandes ci-dessous.
apt update
apt upgrade
Enfin, une fois le processus de mise à jour terminé, redémarrez la machine afin d'appliquer les changements de nom d'hôte et les mises à jour du noyau, en exécutant la commande ci-dessous.
systemctl reboot
Après le redémarrage de la machine, reconnectez-vous à la console du serveur et exécutez la commande ci-dessous afin d'installer certains utilitaires de ligne de commande, tels que wget, curl et zip, qui seront ensuite utilisés pour télécharger des logiciels sur Internet et extraire des fichiers d'archive zip.
apt install wget curl zip unzip
Installer Apache et PHP
L'application SuiteCRM sera déployée dans Debian au-dessus d'une pile LAMP. Les premiers composants de la pile LAMP que nous allons installer sont le serveur HTTP Apache et l'interpréteur de langage de programmation dynamique PHP. Exécutez la commande ci-dessous pour installer le serveur Web Apache et tous les modules PHP requis sur votre système.
apt install apache2 libapache2-mod-php7.0 php7.0 php7.0-gd php7.0-opcache php7.0-mbstring php7.0-xml php7.0-json php7.0-zip php7.0-curl php7.0-imap
Installer la base de données MariaDB
Le prochain composant du pack logiciel LAMP que nous installerons sur le serveur Debian est le moteur de base de données MariaDB. La base de données RDBMS est requise par l'application pour stocker différentes configurations de plate-forme, telles que les utilisateurs, les sessions, les contacts, les produits, les catalogues et autres. Pour installer le moteur de base de données MariaDB et le module PHP nécessaire pour accéder à la base de données, exécutez la commande ci-dessous dans la console de votre machine.
apt install mariadb-server php7.0-mysql mariadb-client
Une fois tous les composants LAMP installés, vérifiez si le serveur Web Apache et le démon MariaDB sont opérationnels et écoutent les connexions réseau sur les ports 80 et 3306 TCP en exécutant l'une des commandes suivantes.
netstat –tlpn
ss- tulpn
L'utilitaire Netstat n'est pas présent par défaut dans le système Debian 9. Pour installer netstat utilitaire dans un serveur Debian Stretch, exécutez la commande ci-dessous.
apt install net-tools
Je Afin d'accéder en toute sécurité au site CRM via le protocole HTTPS qui sécurisera le trafic entre le serveur et les navigateurs clients, assurez-vous d'activer également le module Apache TLS et le fichier de configuration du site SSL, en exécutant les commandes ci-dessous.
a2enmod ssl
a2ensite default-ssl.conf
Ensuite, activez le module de réécriture Apache en exécutant la commande ci-dessous. Le module de réécriture est nécessaire si vous souhaitez modifier les configurations du serveur Web à la volée via .htaccess fichiers placés dans la racine Web de votre domaine.
a2enmod rewrite
systemctl restart apache2
Ensuite, activez le module de réécriture en plaçant les règles requises dans les fichiers de configuration d'Apache. Tout d'abord, nous appliquerons les règles de réécriture dans le fichier de configuration par défaut d'Apache. Alors, ouvrez /etc/apache2/sites-enabled/000-default.conf fichier à modifier avec un éditeur de texte et insérez les règles de réécriture d'URL ci-dessous après le DocumentRoot déclaration, comme le montre l'extrait suivant.
nano /etc/apache2/sites-enabled/000-default.conf
Extrait du fichier 000-default.conf :
<Directory /var/www/html>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>
Fermez le 000-default.conf avec CTRL+o, puis Ctrl+x et ouvrez le fichier de configuration du site SSL par défaut d'Apache et insérez les règles de réécriture d'URL en ajoutant les lignes de code suivantes après la directive DocumentRoot, comme indiqué dans l'exemple ci-dessous :
nano /etc/apache2/sites-enabled/default-ssl.conf
Extrait du fichier de configuration du site SSL :
<Directory /var/www/html>
Options +FollowSymlinks
AllowOverride All
Require all granted
</Directory>
Enfin, après avoir apporté toutes les modifications ci-dessus, redémarrez le démon Apache pour récupérer toutes les nouvelles règles configurées jusqu'à présent.
systemctl restart apache2
Maintenant, vous devez visiter votre domaine ou l'adresse IP du serveur via le protocole HTTP à partir d'un ordinateur de bureau distant. La page Web Debian par défaut devrait être affichée dans votre navigateur.
http://votredomaine.tld
Configuration du pare-feu
Si vous ne pouvez pas voir la page Web, vérifiez si l'application de pare-feu UFW est activée sur le serveur Debian. Si tel est le cas, vous devez insérer les règles ci-dessous pour autoriser le trafic HTTP et HTTPS à traverser le pare-feu.
ufw allow 'WWW Full'
ou
ufw allow 80/tcp
ufw allow 443/tcp
Les iptables Les règles brutes du pare-feu permettant au trafic entrant des ports 80 et 443 TCP de passer le pare-feu sont décrites ci-dessous.
apt-get install -y iptables-persistent
iptables -I INPUT -p tcp --destination-port 80 -j ACCEPT
iptables -I INPUT -p tcp --destination-port 443 -j ACCEPT
netfilter-persistent save
systemctl restart netfilter-persistent
systemctl status netfilter-persistent
systemctl enable netfilter-persistent.service
Enfin, après avoir ajouté les règles de pare-feu requises, testez si la page Web par défaut du serveur Web Apache peut être affichée dans un navigateur distant en visitant votre nom de domaine ou l'adresse IP du serveur via le protocole HTTPS. Exécutez les commandes ifconfig ou ip a pour afficher l'adresse IP de votre serveur.
http://votredomaine.tld
Étant donné que vous utilisez le certificat automatiquement auto-signé émis par Apache lors de l'installation, certificat qui n'est pas approuvé par le navigateur, un avertissement indiquant que "Votre connexion n'est pas sécurisée" doit s'afficher dans le navigateur. Acceptez le certificat non approuvé afin de contourner l'erreur et d'être redirigé vers la page Web par défaut d'Apache, comme illustré dans l'image ci-dessous.
Configurer MariaDB et PHP
Maintenant, commencez à sécuriser le compte racine MariaDB. Connectez-vous à la console MySQL, exécutez les commandes ci-dessous pour mettre à jour root plug-in de compte.
mysql -h localhost
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 2
Server version: 10.1.26-MariaDB-0+deb9u1 Debian 9.1
Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(aucun)]> utilise mysql ;
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A
Database changed
MariaDB [mysql]> mettre à jour l'ensemble d'utilisateurs plugin='' where user='root';
Query OK, 1 row affected (0.00 sec)
Rows matched: 1 Changed: 1 Warnings: 0
MariaDB [mysql]> flush privilèges ;
Query OK, 0 rows affected (0.00 sec)
MariaDB [mysql]> exit
Bye
Exécutez également le script mysql_secure_installation a fourni des référentiels extensibles Debian pour sécuriser davantage la base de données MariaDB. Le script vous posera les questions suivantes : modifier le mot de passe root MySQL, supprimer les utilisateurs anonymes, désactiver les connexions root à distance et supprimer la base de données de test. Répondez par oui à toutes les questions, comme illustré dans l'exemple de sortie de script ci-dessous.
mysql_secure_installation
NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MariaDB
SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY!
In order to log into MariaDB to secure it, we'll need the current
password for the root user. If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.
Enter current password for root (enter for none):
OK, successfully used password, moving on...
Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.
You already have a root password set, so you can safely answer 'n'.
Change the root password? [Y/n] y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
... Success!
By default, a MariaDB installation has an anonymous user, allowing anyone
to log into MariaDB without having to have a user account created for
them. This is intended only for testing, and to make the installation
go a bit smoother. You should remove them before moving into a
production environment.
Remove anonymous users? [Y/n] y
... Success!
Normally, root should only be allowed to connect from 'localhost'. This
ensures that someone cannot guess at the root password from the network.
Disallow root login remotely? [Y/n] y
... Success!
By default, MariaDB comes with a database named 'test' that anyone can
access. This is also intended only for testing, and should be removed
before moving into a production environment.
Remove test database and access to it? [Y/n] y
- Dropping test database...
... Success!
- Removing privileges on test database...
... Success!
Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.
Reload privilege tables now? [Y/n] y
... Success!
Cleaning up...
All done! If you've completed all of the above steps, your MariaDB
installation should now be secure.
Thanks for using MariaDB!
Testez si toutes les mesures de sécurité ont été appliquées en essayant de vous connecter à la console MySQL avec un compte root et aucun mot de passe fourni. L'accès à la base de données doit être refusé si aucun mot de passe n'est fourni pour le compte root, comme illustré dans l'extrait de commande ci-dessous :
mysql -h localhost -u root
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: NO)
Maintenant, essayez de vous connecter à la console MySQL avec le compte root et le mot de passe, comme indiqué dans l'exemple ci-dessous. Vous devriez pouvoir vous connecter à la console MySQL. Tapez quitter pour quitter la base de données MySQL.
mysql -h localhost -u root -p
Enter password:
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 15
Server version: 10.1.26-MariaDB-0+deb9u1 Debian 9.1
Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]> exit
Bye
À l'étape suivante, modifiez les variables PHP suivantes dans php.ini fichier de configuration comme décrit ci-dessous. Ouvrez /etc/php/7.0/apache2/php.ini fichier à éditer et modifier les lignes suivantes. Tout d'abord, assurez-vous de sauvegarder le fichier de configuration PHP initial.
cp /etc/php/7.0/apache2/php.ini{,.backup} nano /etc/php/7.0/apache2/php.ini
Recherchez, modifiez et modifiez les variables suivantes dans php.ini fichier de configuration :
file_uploads = On
default_charset = UTF-8
memory_limit = 128M
post_max_size = 60M
upload_max_filesize = 60M
memory_limit = 256M
max_input_time = 60
max_execution_time = 6000
date.timezone = Europe/London
Remplacer le fuseau horaire variable dans le fichier de configuration PHP en fonction de l'emplacement géographique de votre serveur. La liste des fuseaux horaires PHP peut être trouvée sur le lien suivant http://php.net/manual/en/timezones.php
Pour augmenter la vitesse de chargement des pages de votre site Web, activez le plug-in OPCache disponible pour PHP7. Insérez les lignes OPCache suivantes en bas du fichier de configuration de l'interpréteur PHP, après le [opcache] déclaration, comme le montre l'extrait suivant :
[opcache]
opcache.enable=1
opcache.enable_cli=1
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.memory_consumption=128
opcache.save_comments=1
opcache.revalidate_freq=1
Enfin, fermez le php.ini fichier de configuration et redémarrez le démon Apache pour appliquer les modifications en exécutant la commande ci-dessous.
systemctl restart apache2
Pour afficher tous les paramètres PHP dans un navigateur, créez un fichier d'informations PHP dans le chemin Webroot de votre domaine en exécutant la commande suivante.
echo '<?php phpinfo(); ?>'| tee /var/www/html/info.php
Accédez au fichier de script d'informations PHP à partir d'un navigateur distant à l'URL suivante. Faites défiler jusqu'à date paramètre pour vérifier si la configuration du fuseau horaire PHP et d'autres paramètres ont été appliqués avec succès.
https://domain.tld/info.php
Installer SuiteCRM
Une fois que nous avons configuré tous les paramètres LAMP requis pour l'installation de l'application SuiteCRM, visitez la page de téléchargement officielle de SuiteCRM à l'adresse https://suitecrm.com/download/ et récupérez la dernière archive de fichier zip de votre système en exécutant la commande ci-dessous. Au moment de la rédaction de ce guide, la dernière version publiée de SuiteCRM était le fichier SuiteCRM-7.9.9.zip.
wget https://suitecrm.com/files/158/SuiteCRM-7.9/178/SuiteCRM-7.9.9.zip
ls
Une fois le téléchargement de l'archive du fichier zip SuiteCRM terminé, extrayez le fichier d'archive zip dans votre répertoire de travail actuel et répertoriez les fichiers extraits en exécutant les commandes ci-dessous.
unzip SuiteCRM-7.9.9.zip
ls
ls –al SuiteCRM-7.9.9
Avant de copier les fichiers d'installation sur la racine Web de votre domaine, assurez-vous de supprimer le fichier index.html par défaut installé par le package Apache sur le chemin racine du document du serveur Web et supprimez également le fichier info.php créé précédemment.
rm /var/www/html/index.html
rm /var/www/html/info.php
Les fichiers d'installation de l'application SuiteCRM se trouvent dans votre répertoire de travail actuel sous SuiteCRM-7.9.9/ annuaire. Émettez ls commande pour lister les fichiers de ce répertoire. Copiez tout le contenu de la SuiteCRM-7.9.9/ répertoire vers le chemin racine du document de votre serveur Web en exécutant la commande suivante.
cp -rf SuiteCRM-7.9.9/* /var/www/html/
Ensuite, accordez à l'utilisateur d'exécution Apache (www-data) des autorisations d'écriture complètes sur le chemin racine du document Apache, en exécutant la commande ci-dessous. Exécutez ls pour répertorier les autorisations pour les fichiers installés situés sous le répertoire /var/www/html/.
chown -R www-data:www-data /var/www/html/
ls –al /var/www/html/
Ensuite, connectez-vous à la console de base de données MariaDB et créez la base de données SuiteCRM. Choisissez un nom pour cette base de données et un utilisateur avec un mot de passe fort pour gérer la base de données de l'application, en exécutant les commandes suivantes. Assurez-vous de modifier le nom de la base de données, l'utilisateur et le mot de passe utilisés dans ce didacticiel avec vos propres paramètres.
mysql –u root -p
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 2
Server version: 10.1.26-MariaDB-0+deb9u1 Debian 9.1
Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(aucun)]> crée la base de données mycrm_db ;
Query OK, 1 row affected (0.00 sec)
MariaDB [(none)]> accorde tous les privilèges sur mycrm_db.* à 'crm_user'@'localhost' identifié par 'password1234' ;
Query OK, 0 rows affected (0.00 sec)
MariaDB [(aucun)]> privilèges de vidage ;
Query OK, 0 rows affected (0.00 sec)
MariaDB [(none)]> exit
Bye
Maintenant, commençons le processus d'installation de l'application SuiteCRM. Ouvrez un navigateur et parcourez l'adresse IP ou le nom de domaine de votre serveur via le protocole HTTPS.
http://votredomaine.tld
Sur le premier écran d'installation, le programme d'installation de SuiteCRM affichera le contrat de licence. Cochez 'J'accepte ' afin d'accepter les termes et conditions de la licence, choisissez la langue d'installation de l'application et appuyez sur le bouton Suivant afin de démarrer le processus d'installation, comme illustré dans la capture d'écran ci-dessous.
Dans l'écran d'installation suivant, le programme d'installation de SuiteCRM vérifiera les exigences de votre environnement système et affichera un message OK si toutes les configurations PHP et de serveur sont réussies. Afin de continuer le processus d'installation, appuyez sur le bouton Suivant, comme indiqué dans la capture d'écran ci-dessous.
Ensuite, le programme d'installation affichera les paramètres de connexion à la base de données et la page de configuration du site. Dans le volet de gauche, sélectionnez MySQL avec l'extension MySQLi comme type de base de données et indiquez le nom de la base de données MySQL créée pour l'installation de l'application SuiteCRM, l'adresse de l'hôte du serveur de base de données, le nom d'utilisateur de la base de données et le mot de passe nécessaire pour accéder à la base de données SuiteCRM. Sélectionnez également "Identique à l'utilisateur administrateur" dans "Utilisateur de la base de données SuiteCRM /". Sur le plan de droite, ajoutez un nom d'utilisateur d'administrateur d'application et définissez un mot de passe fort pour le compte administrateur. Vérifiez l'adresse URL de l'instance SuiteCRM pour qu'elle corresponde à votre nom de domaine via le protocole HTTPS, sur le port 443 et ajoutez l'adresse e-mail du compte administrateur. Utilisez l'image suivante comme guide pour configurer cette étape.
Ensuite, dans le même écran d'installation, appuyez sur les données "Choisir une démo" dans le menu "Plus d'options" et choisissez de ne pas remplir la base de données SuiteCRM avec des données de démonstration. Ensuite, cliquez sur le menu Sélection de scénario et sélectionnez pour activer les modules suivants de SuiteCRM :Ventes, Marketing, Finance, Service et Gestion de projet. Si vous n'avez pas besoin d'un module lors de l'installation de l'application, vous pouvez le laisser décoché et l'activer une fois le processus d'installation terminé à l'aide de la page d'administration de l'application.
Ensuite, faites défiler vers le bas et appuyez sur le menu Spécification du serveur SMTP pour activer l'option de messagerie SuiteCRM. Ajoutez le nom et l'adresse e-mail que vous souhaitez voir apparaître dans l'en-tête de l'e-mail « De ». Ensuite, choisissez votre fournisseur de service de messagerie et spécifiez les paramètres du serveur de messagerie. Dans ce guide, nous utiliserons le fournisseur de services Gmail pour envoyer des e-mails, et les paramètres du serveur de messagerie peuvent être trouvés illustrés dans la capture d'écran ci-dessous. Une fois que vous avez défini les paramètres requis pour activer votre fournisseur de services de messagerie, cliquez sur le menu Marque et ajoutez un nom à afficher dans la barre de titre du navigateur pour l'application SuiteCRM et téléchargez l'image du logo de votre propre site Web.
Ensuite, faites défiler à nouveau vers le bas et appuyez sur le menu Paramètres régionaux du système et spécifiez comment les paramètres de format d'heure, de fuseau horaire et de devise doivent être affichés dans l'application SuiteCRM. Enfin, laissez les options de sécurité du site décochées pour le moment et appuyez sur le bouton Suivant pour terminer le processus d'installation. Vous pouvez utiliser l'image ci-dessous pour terminer cette étape.
Une fois le processus d'installation terminé, vous serez redirigé vers la page de connexion SuiteCRM. Pour accéder au panneau d'administration de l'application, connectez-vous à SuiteCRM avec les informations d'identification du compte administrateur configurées lors du processus d'installation, comme indiqué dans l'image ci-dessous.
Avant de vous connecter au panneau d'administration de SuiteCRM, revenez d'abord à la console du serveur et exécutez la commande suivante afin de supprimer le répertoire d'installation qui n'est plus nécessaire et peut représenter une faille de sécurité.
rm -rf /var/www/html/install/
Vous pouvez également visiter le tableau de bord SuiteCRM en accédant à l'adresse IP ou au nom de domaine de votre serveur via le protocole HTTPS. Une vue du tableau de bord d'administration de SuiteCRM est présentée dans la capture d'écran ci-dessous.
http://votredomaine.tld
Enfin, afin de rediriger automatiquement les visiteurs vers HTTPS, afin qu'ils puissent accéder en toute sécurité à l'interface SuiteCRM depuis leurs navigateurs, retournez sur votre terminal serveur et éditez le .htaccess généré automatiquement fichier situé dans le chemin racine du document de votre domaine, en exécutant la commande ci-dessous.
nano /var/www/html/.htaccess
Dans le fichier .htaccess, recherchez
.htaccess extrait de fichier :
# Redirect to HTTPS
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule (.*) https://%{SERVER_NAME}/$1 [R,L]
Au bas du fichier, vous pouvez modifier les paramètres du serveur PHP natif du serveur Web en ajoutant d'autres lignes avec les paramètres pour refléter vos propres ressources et configurations de serveur.
# Modify PHP settings
php_value session.use_trans_sid 0
php_value register_globals 1
php_value upload_max_filesize 100M
php_value post_max_size 100M
Afin d'exécuter SuiteCRM Schedulers, modifiez le fichier crontab de votre compte d'exécution de serveur Web avec la commande ci-dessous et ajoutez la tâche cron suivante à exécuter chaque minute.
crontab -e -u www-data
exemple de fichier crontab :
* * * * * /usr/bin/php7.0 -f /var/www/html/cron.php > /dev/null 2>&1
Si vous souhaitez contourner les avertissements du navigateur qui sont générés chaque fois qu'un client visite votre application, vous devriez envisager d'acheter un certificat émis par une autorité de certification de confiance ou d'émettre un certificat gratuit de Let's Encrypt CA.
C'est tout! L'application Web SuiteCRM a été installée et configurée avec succès sur un serveur Debian 9 au-dessus d'une pile LAMP.
Afin de personnaliser davantage la plate-forme SuiteCRM, assurez-vous de visiter la page wiki de l'application à l'adresse suivante :https://suitecrm.com/wiki/index.php/Main_Page