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… :-)

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
Prochaine révisionLes deux révisions suivantes
tutoriel:erp-crm:dolibarr:install:amen:start [2022/03/14 14:24] – créée admintutoriel:erp-crm:dolibarr:install:amen:start [2022/03/16 17:14] – [Quatrième étape : Installer Dolibarr] admin
Ligne 1: Ligne 1:
 {{tag>tutoriel}} {{tag>tutoriel}}
  
-====== Installer DOLIBARR sur un hébergement professionnel offert par Amen.fr ======+====== 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 ===== ===== Introduction =====
 +
 +<WRAP list-deep>
 +  - **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]]
 +  - **Pourquoi pas une installation locale par exemple avec Doliwamp** ?
 +    - Avec **Doliwamp**, vous aurez du mal à faire évoluer les versions des composants du serveur ou de **Dolibarr**.
 +    - **Il est conseillé de faire une installation sur un serveur distant** comme le micro hébergement proposé par Amen.fr.
 +    - 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.
 +    - 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.
 +  - **Quelle version installer ?** :
 +    - Dernière version disponible à l'heure de ce tuto : version 13.
 +    - 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.
 +  - **Les étapes de la procédure d'installation** :
 +    - **Créer la base de données chez Amen.fr**
 +    - **Télécharger Dolibarr** (avant-dernière version) sur le site github de dolibarr
 +    - **Via FTP, transférer sur le serveur de Amen.fr les fichiers téléchargés**, préalablement décompressés
 +    - **Installer Dolibarr** en se connectant au domaine
 +    - **Verrouiller l'installation** pour empêcher une installation tierce éventuellement malveillante
 +</WRAP>
  
 ===== Pré-requis ===== ===== Pré-requis =====
  
  
-===== Première étape =====+===== Première étape : Créer la base de données chez Amen.fr ===== 
 + 
 +<WRAP list-deep> 
 +  - **Connectez-vous sur l'interface cpanel de Amen.fr** avec vos identifiants :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-001.png?600 |}} 
 +  - **dans la rubrique base de données**, cliquez sur l'**assistant de base de données** :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-002.png?600 |}} 
 +  - **Donnez un nom de base de données** : 
 +    - le nom de la base de données est toujours précédé de l'identifiant cpanel (lisible en haut à droite) 
 +    - Principe de nommage : 
 +      - **deux premières lettres : db** comme dolibarr 
 +      - **deux suivantes : an** (première et dernière lettres du nom de domaine acop.phon) 
 +      - **et 1** (c'est la première installation de dolibarr que je fais) 
 +    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-003.png?600 |}} 
 +  - **Créez l'utilisateur** de la base de données : 
 +    - **Nom d'utilisateur** : le même que celui de la base de données, avec dban1 
 +    - **Mot de passe** 
 +    - **Confirmation du mot de passe** 
 +    - **Cliquez sur <key>Créer un utilisateur</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-004.png?600 |}} 
 +  - **attribuer les droits à l'utilisateur** : 
 +    - Cochez **TOUS LES PRIVILÈGES** pour lui donner tous les droits 
 +    - Cliquez sur <key>Étape suivante</key>{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-005.png?600 |}} 
 +  - **Terminer la tâche** : 
 +    - la base de données et l'utilisateur ont été créés 
 +    - Cliquez sur le lien **Revenez aux bases de données MySQL** :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-006.png?600 |}} 
 +  - **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{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-007.png?600 |}} 
 +</WRAP>
  
 ===== Autres étapes ===== ===== Autres étapes =====
  
 +==== Deuxième étape : Télécharger Dolibarr ====
 +
 +<WRAP list-deep>
 +  - **Sur le navigateur, ouvrez** [[https://github.com/Dolibarr/dolibarr/]]
 +    - **on est automatiquement sur la dernière branche** en cours de développement{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-008.png?600 |}}Or on ne veut pas la branche de développement, mais utiliser la version 12.
 +    - **Deux façons d'y accéder** : cliquez sur la flèche de l'onglet **develop** et
 +      - **soit cliquez sur Branches** puis sur 12, ce qui donne la dernière version mineure de la version majeure 12{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-009.png?600 |}}
 +      - **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){{ :tutoriel:erp-crm:dolibarr:install:amen:amen-010.png?600 |}}
 +  - **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
 +</WRAP>
 +
 +==== Troisième étape : transférer les fichiers via FTP ====
 +
 +Ayez sous la main :
 +  * base de données
 +  * mot de passe
 +
 +<WRAP list-deep>
 +  - **Ouvrez Filezilla**
 +  - **Connectez-vous au serveur de amen.fr** : collez l'URL, le nom d'utilisateur et le mot de passe et cliquez sur <key>Connexion rapide</key>
 +    - le site distant (l'hébergement chez amen.fr) s'affiche sur la droite
 +    - et, sur la gauche, le site local, c'est-à dire le répertoire de transfert contenant dolibarr{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-011.png?600 |}}
 +  - **Transférez le contenu du répertoire htdocs du site local vers le répertoire public_html de l'hébergement amen.fr** :
 +    - sur le site distant, double cliquez sur public_html pour vous positionner dans ce répertoire
 +    - sur le site local :
 +      - sélectionnez tous les répertoires et fichiers
 +      - un clic droit, envoyer : l'intégralité du contenu du répertoire htdocs se transfère dans le répertoire public_html{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-012.png?600 |}}
 +    - sur le site distant, **Créez le répertoire /dolibarr/documents** en dehors de ce qui est accessible au web :
 +      - Remontez dans l'arborescence de l'hébergement jusqu'à la racine (/ ou home)
 +      - Avec un clic droit, créez un répertoire nommé dolibarr
 +      - et dans ce répertoire, un répertoire documents{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-013.png?600 |}}
 +</WRAP>
 +
 +==== Quatrième étape : Installer Dolibarr ====
 +
 +<WRAP list-deep>
 +  - Dans votre navigateur, ouvrez la page [[https:accope.fun/install]] pour lancer l'installation :
 +    - **Langue par défaut** : laisser **Détection automatique** ((Vous pourriez choisir une autre langue si vous voulez))
 +    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-014.png?600 |}}Il fait un certain nombre de vérifications
 +  - **Ici, toutes les coches sont vertes sauf** : **Votre installation de php ne supporte pas les fonctions intl** :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-015.png?600 |}}
 +    - **Pour régler ce problème de php** sur l'hébergement de amen.fr :
 +      - **Retournez dans cPanel**
 +      - **Dans le paragraphe LOGICIEL**, ((descendez dans la page)) cliquez sur **Sélectionner une version de PHP**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-016.png?600 |}}
 +      - **Cherchez l'extension intl** : elle n'est pas cochée, ce qui veut dire qu'elle n'est pas installée ((si vous avez un jour besoin d'installer d'autres fonctions php, c'est ici que ça se trouve donc dans cpanel, quel que soit l'hébergeur))
 +      - **Cochez intl pour l'activer**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-018.png?600 |}}La petite fenêtre verte en haut affiche : **Success module intl saved**
 +    - Revenez sur l'installation : toutes les coches sont vertes{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-019.png?400 |}}Si vous avez d'autres coches rouges, il faut les corriger avant d'installer dolibarr, sinon dolibarr pourrait ne pas fonctionner correctement.
 +    - Cliquez sur <key>Démarrer</key>
 +  - **La page de configuration de l'installation** s'affiche. Vérifiez et modifiez ce qui est nécessaire :
 +    - **Serveur web** :
 +      - **Répertoire contenant les pages web** : /home/mon_identifiant/public_html -> c'est bien ce qui était dans Filezilla
 +      - **Répertoire devant contenir les documents générés (PDF, etc.)** ((Si on ne l'avait pas créé, automatiquement ce répertoire-là serait créé dans public_html)) : on a créé le répertoire documents non pas dans public_html mais dans un répertoire en dehors de ce qui est accessible sur le web et qu'on l'a appelé dolibarr -> modifiez le nom du répertoire, soit ici : .../dolibarr/documents
 +      - **URL racine** : laisser https://accope.fun
 +      - Cochez **Forcer les connexions sécurisées HTTPS** : quand quelqu'un tape http://accope.fun, automatiquement il va être redirigé sur la version https. Si vous ne cochez pas ça, ça ne sera pas fait et il se connectera en http non sécurisé. Ce n'est pas souhaitable car la première chose qu'on saisit sur dolibarr quand on se connecte sur acop.phone, c'est un identifiant et un mot de passe. 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.{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-020.png?400 |}}
 +    - **Base de données Dolibarr** :
 +      - **Nom de la base de données** : celui qu'on a rentré lors de la création de la base de données
 +      - **Type du pilote** : mysqli
 +      - **Serveur de base de données** : localhost
 +      - **Port** : 3306
 +      - **Préfixe des tables** : le changer pour une question de sécurité ; ici, an_ (première et dernière lettre)
 +      - **Créer la base de données** : ne pas cocher puisque la base de données est déjà créée
 +      - **Identifiant** : celui rentré lors de la création de la base de données
 +      - **Mot de passe** : celui rentré lors de la création de la base de données
 +      - **Créer le propriétaire ou lui affecter les droits à la base** : pas la peine de cocher puisqu'on a déjà créé l'utilisateur et qu'on lui a déjà attribué les droits
 +      - {{ :tutoriel:erp-crm:dolibarr:install:amen:amen-21.png?400 |}}
 +    - **Cliquez sur <key>Étape suivante</key>** :
 +      - **toutes les coches sont vertes**, on va pouvoir continuer
 +      - **S'il y a une coche rouge**, revenez en arrière et modifiez une information que vous avez certainement mal renseignée
 +      - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-22.png?400 |}}
 +</WRAP>
 +
 +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 ===== ===== Conclusion =====