Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Ceci est une ancienne révision du document !


Dolibarr : installation gratuite chez Amen.fr (hébergement offert)

Ce tutoriel montre comment installer Dolibarr sur un hébergement gratuit offert par Amen.fr.

Introduction

  1. L'offre de Amen.fr avec un nom de domaine .fr à un euro et un micro hébergement offert : Voir la vidéo https://www.youtube.com/watch?v=BLbTt45e85Y&t=0s Pour vous procurer le pack domaine chez Amen.fr : https://sf66.eu/amenfr
  2. Pourquoi pas une installation locale par exemple avec Doliwamp ?
    1. Avec Doliwamp, vous aurez du mal à faire évoluer les versions des composants du serveur ou de Dolibarr.
    2. Il est conseillé de faire une installation sur un serveur distant comme le micro hébergement proposé par Amen.fr.
    3. Mais une installation locale permet les tests de mise à jour, de plugins, etc. : les tests de sauvegarde restauration, etc. devront être faits sur une installation locale.
    4. Mais cela pourra intervenir dans un second temps et vous pourrez utiliser l'hébergement de Amen.fr pour vous familiariser avec l'utilisation d'un serveur web distant.
  3. Quelle version installer ? :
    1. Dernière version disponible à l'heure de ce tuto : version 13.
    2. Mais nous allons installer une version antérieure (la dernière version mineure de la version 12) pour ne pas subir d'éventuels bugs résiduels de la dernière version.
  4. Les étapes de la procédure d'installation :
    1. Créer la base de données chez Amen.fr
    2. Télécharger Dolibarr (avant-dernière version) sur le site github de dolibarr
    3. Via FTP, transférer sur le serveur de Amen.fr les fichiers téléchargés, préalablement décompressés
    4. Installer Dolibarr en se connectant au domaine
    5. Verrouiller l'installation pour empêcher une installation tierce éventuellement malveillante

Pré-requis

Première étape : Créer la base de données chez Amen.fr

  1. Connectez-vous sur l'interface cpanel de Amen.fr avec vos identifiants :
  2. dans la rubrique base de données, cliquez sur l'assistant de base de données :
  3. Donnez un nom de base de données :
    1. le nom de la base de données est toujours précédé de l'identifiant cpanel (lisible en haut à droite)
    2. Principe de nommage :
      1. deux premières lettres : db comme dolibarr
      2. deux suivantes : an (première et dernière lettres du nom de domaine acop.phon)
      3. et 1 (c'est la première installation de dolibarr que je fais)
    3. Cliquez sur Étape suivante
  4. Créez l'utilisateur de la base de données :
    1. Nom d'utilisateur : le même que celui de la base de données, avec dban1
    2. Mot de passe
    3. Confirmation du mot de passe
    4. Cliquez sur Créer un utilisateur
  5. attribuer les droits à l'utilisateur :
    1. Cochez TOUS LES PRIVILÈGES pour lui donner tous les droits
    2. Cliquez sur Étape suivante
  6. Terminer la tâche :
    1. la base de données et l'utilisateur ont été créés
    2. Cliquez sur le lien Revenez aux bases de données MySQL :
  7. Vérifier dans la liste des bases de données de l'interface cpanel : je trouve la base de données que j'ai créée, l'utilisateur avec tous les droits, donc c'est ok

Autres étapes

Deuxième étape : Télécharger Dolibarr

  1. Sur le navigateur, ouvrez https://github.com/Dolibarr/dolibarr/
    1. on est automatiquement sur la dernière branche en cours de développementOr on ne veut pas la branche de développement, mais utiliser la version 12.
    2. Deux façons d'y accéder : cliquez sur la flèche de l'onglet develop et
      1. soit cliquez sur Branches puis sur 12, ce qui donne la dernière version mineure de la version majeure 12
      2. ou cliquez sur tag, ce qui liste de toutes les versions mineures : cliquez sur la version que vous voulez télécharger (12.0.4)
  2. Dans le répertoire de téléchargement, dézippez le fichier, ce qui crée le répertoire décompressé de dolibarr 12.0.4

Troisième étape : transférer les fichiers via FTP

00:08:25,539 Pour transférer les fichiers ftp, j'ai lancé mon logiciel ftp, Filezilla.

00:08:45,879 Il faut maintenant que je me connecte au serveur de amen.fr en FTP,

00:08:55,660 je vais avoir également besoin de ma base de données et du mot de passe pour aller saisir ici le nom d'hôte, l'identifiant et le mot de passe.

00:09:04,420 je colle mon url, le nom d'utilisateur et le mot de passe et je clique sur connexion rapide.

00:09:25,670 La connexion s'est bien initialisée donc on voit ici que j'ai sur la droite le site distant donc mon hébergement chez amen.fr

00:09:32,930 et ici sur la gauche mon site local donc qui est sur mon répertoire de transfert dans lequel j'ai mis dolibarr.

00:09:41,300 Je vais ici maintenant double cliquer dans le répertoire dolibarr que j'ai téléchargé et ce que je vais transférer en ftp dans mon répertoire d'hébergement chez amen.fr, ce n'est pas l'intégralité de ce que j'ai ici mais l'intégralité du contenu de htdocs.

00:10:02,180 Donc c'est tous ces fichiers là que je vais transférer donc où je vais les transférer sur mon hébergement chez amen.fr dans public_html.

00:10:18,700 Donc je double clique ici sur public_html et je vois que j'ai déjà quelques fichiers à l'intérieur donc je vais transférer l'intégralité de ces répertoires et des fichiers dans le répertoire qui est ici chez amen.fr.

00:10:34,610 Je vais aller sélectionner tous ces répertoires et tous ces fichiers et donc là je suis positionné dans le répertoire public_html

00:10:43,940 Je vais faire ici clic droit envoyer et donc l'intégralité du contenu de ce répertoire htdocs va être transféré dans le répertoire public_html.

00:10:56,300 Ca va prendre un certain temps.

00:11:26,450 bon alors ça y est le transfert des fichiers est terminé.

00:11:31,140 Pour vous donner un ordre d'idée du temps nécessaire, ça a mis à peu près un peu moins de deux heures et quart, tout en sachant que je suis connecté en wifi sur une connexion adsl traditionnelle donc le débit montant n'est pas n'est pas très élevé, ceci expliquant aussi peut-être cela ; si vous avez de la fibre ça ira beaucoup plus vite.

00:11:56,850 Le transfert a été effectué ; maintenant, avant de procéder à l'installation je vais faire une opération supplémentaire parce que là on a téléchargé tous les fichiers qui étaient dans le répertoire dolibarr local, qu'on avait téléchargé de github on l'a transféré dans le répertoire public_html de l'hébergement distant.

00:12:20,820 Par contre, pour l'installation de dolibarr, il y a possibilité de stocker les documents que vous allez émettre, les factures les bons de commande, les bons de livraison, tous les documents que vous allez émettre plus tous les documents que vous allez télécharger, il y a possibilité de les mettre dans un répertoire séparé.

00:12:45,149 Ce répertoire séparé qui s'appelle documents je vais le mettre dans un autre répertoire que public_html pour qu'ils ne soient pas en fait accessible de l'extérieur et qu'ils soient un petit peu protégés.

00:13:02,370 C'est plutôt conseillé de mettre le répertoire documents en dehors de ce qui est accessible au web

00:13:11,310 Je vais remonter ici dans l'arborescence de mon hébergement est donc là je suis à la racine de l'hébergement puisque je suis ici au / donc c'est home, je vais créer un répertoire que je vais appeler dolibarr et dans ce répertoire dolibarr je vais créer un répertoire documents donc pour ouvrir le menu, je fais clic droit et donc créer un dossier.

00:13:41,790 C'est maintenant prêt à recevoir l'installation de dolibarr.

00:13:48,690 Nous allons passer maintenant à cette quatrième étape qui est installer dolibarr en se connectant au domaine.

00:13:56,040 Dans mon navigateur je vais dans mon nouvel onglet et ici je vais taper le nom de domaine acop.fun et je vais taper /install pour lancer l'installation.

00:14:14,480 On arrive sur la page d'installation avec la sélection de la langue, je laisse détection automatique puisque là je vois que je suis bien en français et donc je fais suivant.

00:14:28,709 Si jamais vous n'étiez pas en français vous pourriez ici choisir la langue que vous souhaitez ou si vous souhaitez une autre langue vous pouvez la sélectionner ici.

00:14:38,760 Je clique ensuite sur étape suivante. Il fait un certain nombre de vérifications donc toutes les coches sont vertes sauf celle-ci : votre installation de php ne supporte pas les fonctions intl.

00:14:53,699 Il va falloir que j'aille régler ça sur l'hébergement de amen.

00:15:00,690 Pour régler la fonction de php, je vais retourner ici dans mon cpanel et je vais descendre et je vais aller ici dans logiciel sélectionner une version de php.

00:15:18,850 Je vais chercher maintenant l'extension intl, elle se trouve ici donc voyez elle est effectivement ici pas cochée donc ça veut dire qu'elle n'est pas installée, d'ailleurs si jamais vous avez un jour besoin d'installer d'autres fonctions de php, c'est ici que ça se trouve donc dans cpanel, quel que soit l'hébergeur, vous allez dans sélectionner la version de cpanel et vous aurez accès aux extensions php.

00:15:44,060 Je clique ici sur intl pour l'activer.

00:15:48,350 J'ai la petite fenêtre verte ici success module intl saved donc là, maintenant, c'est bon.

00:15:55,580 Je vais revenir ici sur mon installation et je vais actualiser cette page pour voir si c'est corrigé :

00:16:03,110 Maintenant, j'ai bien la petite coche verte sur les fonctions intl, tout est ok.

00:16:10,700 Si vous avez d'autres coches rouges, il faut les corriger avant d'installer dolibarr parce que sinon ça risque de vous poser un problème et dolibarr pourrait ne pas fonctionner correctement.

00:16:21,500 Je vais cliquer sur démarrer.

00:16:25,139 Ici, c'est la page de configuration de l'installation où je vais vérifier et modifier tout ce que j'ai besoin de faire.

00:16:35,670 Le répertoire contenant les pages web home, mon identifiant public html c'est bien ce que j'avais ici dans Filezilla,

00:16:44,879 Je vais revenir maintenant sur l'installation.

00:16:47,970 Ensuite le répertoire devant contenir les documents générés : on a créé le répertoire documents non pas dans public_html mais on l'a créé dans dolibarr.

00:17:03,929 Si on ne l'avait pas créé, automatiquement ce répertoire-là serait créé dans public_html

00:17:09,419 mais comme on l'a créé dans un répertoire en dehors de ce qui est accessible sur le web et qu'on l'a appelé dolibarr, je vais modifier le nom du répertoire, donc je mets ici dolibarr et je vais essayer donc documents c'est bien le nom que l'on a donné.

00:17:23,939 Ensuite l'url racine, c'est bien ici ce qu'on a tapé pour se connecter sans la suite mais on est bien sur https acop.phone donc là je laisse.

00:17:36,659 Ensuite je vais cocher ici forcer les connexions sécurisées https alors ce que ça va faire c'est que quand quelqu'un va taper http://acop.phone, automatiquement il va être redirigé sur la version https.

00:17:49,110 Si vous ne cochez pas ça, ça ne sera pas fait et il se connectera en http non sécurisé.

00:17:56,490 Ce n'est pas ce qu'on souhaite dans la mesure où la première chose qu'on saisit sur dolibarr quand on se connecte sur acop.phone, la première chose que l'on saisit c'est un identifiant et un mot de passe donc il vaut mieux ici qu'on soit sécurisé.

00:18:10,889 C'est pour ça que systématiquement j'active https sur l'hébergement et je coche ici cette case pour forcer l'utilisation d' https.

00:18:20,760 Ensuite le nom de la base de données donc ça c'est les informations que l'on a rentré lorsqu'on a créé la base de données donc je vais ici aller récupérer les informations que j'avais saisies dans KeePass donc je vais ici copier le nom de la base de données alors le type du pilote c'est bien mysqli, le serveur de base de données localhost, c'est bien ça, le port c'est bien 3306 et là on nous demande le préfixe des tables alors le préfixe des tables ce qui est proposé ici c'est ce qui est par défaut moi je préfère systématiquement le changer pour une question de sécurité.

00:18:57,900 Je vais remplacer par le nom du site donc je vais prendre la première lettre et la dernière lettre comme j'ai fait pour les lettres que j'ai intégrées dans le nom de la base de données je vais mettre ici an, je pourrais mettre même le 1 si je souhaitais mais bon je préfère laisser juste le nom du site.

00:19:17,670 Ici, créer la base de données donc je vais pas cocher puisque la base de données on l'a déjà créée.

00:19:21,450 Par contre je vais indiquer ici l'identifiant et le mot de passe donc je vais pareil copier ce que j'avais indiqués dans KeePass

00:19:33,830 Ensuite, ici le mot de passe

00:19:38,760 Ensuite j'ai cette petite case à cocher créer le propriétaire ou lui affecter les droits ça ce n'est pas la peine de cocher puisqu'on a déjà créé l'utilisateur et on lui a déjà attribué les droits, donc je vais cliquer ensuite sur étape suivante

00:19:50,430 Il a créé le fichier de configuration et il a fait des connexions au serveur et à la base de données, donc là toutes les coches sont vertes, on va pouvoir continuer

00:20:06,240 Si jamais vous avez une coche rouge c'est qu'il y a quelque chose qui n'a pas été renseigné correctement dans l'étape précédente

00:20:11,970 il faut donc revenir en arrière pour modifier, ça ne sert à rien d'essayer de continuer avec une coche rouge parce que vous aurez un problème, d'ailleurs je ne sais pas si on peut poursuivre, a priori je pense pas ; donc il faudra systématiquement, si vous avez une coche rouge, que vous revenez en arrière et que vous modifiez une information que vous avez certainement mal renseignée.

00:20:33,930 Je vais cliquer ensuite sur étape suivante.

00:20:35,940 Cette dernière étape est la vérification de connexion à la base de données donc ça a été connecté, ça crée les tables, les clés, les fonctions et le chargement des données donc la table est prête, on peut passer maintenant directement à l'installation.

00:20:51,960 Donc je clique sur étape suivante.

00:20:55,020 L'installation a été réalisée, il ne nous reste plus maintenant qu'à rentrer l'identifiant et le mot de passe de l'administrateur de dolibarr

00:21:06,060 J'ai préparé également dans la base de données une entrée pour l'administrateur donc avec un identifiant d'administrateur et un mot de passe.

00:21:15,090 Concernant le mot de passe, attention je vous conseille de n'utiliser que des caractères majuscules, minuscules et des chiffres, de ne pas mettre de caractères spéciaux dans le mot de passe de l'administrateur dolibarr parce que j'ai rencontré des problèmes, donc je vous conseille vraiment de ne pas mettre de caractères spéciaux dans le mot de passe de l'administrateur.

00:21:38,310 Je vais ensuite copier le nom de l'administrateur, j'ai mis un nom aléatoire plus admin ; lorsque je vais créer ensuite un utilisateur, je prendrai le même nom mais je rajouterai ici derrière util pour bien différencier le compte administrateur et le compte utilisateur donc le mot de passe que je vais copier ici deux fois et je n'ai plus qu'à cliquer sur étape suivante.

00:22:07,520 La création de l'administrateur a été effectuée, il ne me reste plus maintenant qu'à accéder à dolibarr et à l'espace de configuration pour commencer la configuration de dolibarr.

00:22:21,630 Je vais cliquez ici donc il me propose automatiquement l'identifiant de l'administrateur, il ne me reste plus ici qu'à renseigner le mot de passe et me connecter.

00:22:30,060 Je suis connecté à l'administration de dolibarr que je viens d'installer sur l'hébergement amen.fr.

00:22:41,850 C'est tout à fait possible d'installer dolibarr sur un nom de domaine offert ou à quelques euros et surtout un micro hébergement offert, donc l'installation fonctionne tout à fait correctement.

00:22:59,290 On a vérifié que l'on pouvait se connecter aux comptes administrateurs de dolibarr.

00:23:04,540 Pour pouvoir faire la configuration du logiciel, il reste la dernière étape à faire qui est de verrouiller l'installation.

00:23:18,600 Pour verrouiller l'installation, il faut aller mettre un fichier qui s'appelle install.lock dans le répertoire document.

00:23:30,190 C'est ce que je vais faire avec Filezilla.

00:23:35,620 Je vais me rendre dans le répertoire dolibarr dans lequel j'ai créé le répertoire document.

00:23:43,120 Je vais remonter puisque là je suis pas au bon endroit, je suis dans public, je vais aller dans le répertoire documents et dans le répertoire documents, je vais faire un clic droit et je vais faire créer un nouveau fichier que je vais appeler install.lock et je clique sur ok.

00:24:05,710 Le fichier est présent, ça veut dire que maintenant les installations ou les mises à jour sont verrouillées.

00:24:12,490 Si vous voulez par la suite faire une mise à jour, il faudra supprimer ce fichier install.lock.

00:24:18,460 C'est une mesure de sécurité et on peut d'ailleurs le vérifier en retournant sur le domaine donc j'ouvre une nouvelle fenêtre, je vais taper acop.phone/install : et là vous voyez que j'ai ce message qui m'indique que le répertoire d'installation et de mise à jour est verrouillé.

00:24:44,170 Voilà c'est une sécurité.

Conclusion

Problèmes connus

Voir aussi