Installation sur MacOSX

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Prérequis

Ce guide fournit les éléments pour une installation de Dolibarr sur Mac en utilisant l'infrastructure fournie par MAMP.

Version Mac OS X 10.10 minimum.

Procédure

Téléchargements

Téléchargez MAMP (version 5.3 au moment de la rédaction) https://www.mamp.info/en/downloads/

Téléchargez la version standard de Dolibarr https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/

Installer MAMP et les fichiers de Dolibarr

  • Continuez à travers les fenêtres de licence, etc.
  • Sélectionnez votre disque interne, et sur l’étape d’après cliquez sur le bouton en bas à gauche “customize”.
  • Décochez “MAMP Pro”, seul “MAMP” est sélectionné obligatoirement.
  • Choisissez “Install” et attendez la fin de l’installation. Quand MAMP est installé, choisissez si oui ou non vous voulez mettre le fichier d’installation à la corbeille. Personnellement je préfère choisir “Keep” pour garder le fichier sous le coude.
  • Décompressez le .ZIP de Dolibarr dans vos Téléchargements.
  • Déplacez ce dossier à la racine du dossier MAMP qui se trouve désormais dans le dossier Applications du Finder. Vous pouvez renommer le dossier en supprimant l'indication de version.


Configurez l’application MAMP

  • Ouvrez l'application MAMP.
  • Commencez par décocher “Show this window when starting” en bas de la fenêtre “MAMP Cloud functions” et fermez la fenêtre.
  • Allez dans le menu “MAMP / Préférences” en haut à gauche dans la barre de menu.
  • Dans l’onglet “Général” cochez la case “Start servers”.
  • Dans l’onglet “Ports” notez le port Apache, qui doit être 8888 par défaut.
  • Dans l’onglet “Cloud”, assurez vous que “Use Cloud” est décoché.
  • Dans l’onglet “Web Server” à “Document Root”, cliquez sur le bouton “Select” et naviguez vers le dossier “Applications / MAMP / dolibarr” et sélectionner une fois le dossier “htdocs”. Cliquez sur “Select” en bas à droite de la fenêtre.
  • Puis cliquez sur le bouton “OK”

MAMP est désormais configuré.

Vous pouvez manuellement démarrer et éteindre le serveur qui va vous faire tourner Dolibarr. Par défaut nous l’avons configuré pour démarrer le serveur à chaque fois que MAMP est lancé. Vous l’aurez compris, si MAMP n’est pas lancé et que les voyants “Apache” et “SQL” ne sont pas au vert, pas de Dolibarr. (Vous pouvez aller dans “Préférences Système / Utilisateurs / ouverture” de votre Mac pour ajouter MAMP à la liste et faire en sorte que MAMP s’ouvre automatiquement à chaque fois que vous démarrez votre Mac).

Configurer Dolibarr

  • Lancer votre navigateur et rentrer l’adresse “localhost:8888”
  • Choisissez la langue, puis “étape suivante”
  • Bouton “Démarrer” pour la première installation, et "étape suivante".


Sous les options “Serveur Web” laissez tout par défaut.

Sous les options “Base de Données” :

  • Cochez la case “Créer la base de données”
  • Choisissez un identifiant et un mot de passe (pour la base de données SQL, différent des utilisateurs Dolibarr)
  • Cochez la case “Créer le propriétaire”
  • "Accès super utilisateur” va apparaitre en dessous. Utilisez le user par défaut de MAMP c’est à dire identifiant “root” et mot de passe “root”
  • Cliquez sur “suivant”

Dolibarr vous indique normalement que tout est OK : Vous avez donc créé une base de données SQL “dolibarr”, ainsi qu’un administrateur qui peut gérer cette base. Gardez bien cet identifiant car c’est avec lui que vous pourrez gérer les sauvegardes et restaurations de votre base de données.

  • Cliquez sur le bouton “suivant” et laissez Dolibarr procéder. Un fois que tout est OK, cliquez à nouveau sur “suivant” et vous arrivez sur la page de création de l’administrateur Dolibarr.
  • Choisissez un identifiant et un mot de passe. Il peut être différent ou identique à celui de l’étape précédente, mais notez que ce sont deux utilisateurs distincts.
  • Cliquez sur “suivant”
  • Dolibarr vous prévient ensuite que la création du user est OK, mais vous avertit que “pour des raisons de sécurité” “il est conseillé de placer dans le répertoire document de Dolibarr un fichier nommé install.lock en lecture seule” : Nous y reviendrons, car dans une utilisation strictement hors-réseau ça ne nous concerne pas, mais sachez que dès que vous vous connectez à un réseau, MAMP expose Dolibarr et votre base de données aux autres.
  • Cliquez sur “accéder à Dolibarr” en utilisant le compte administrateur Dolibarr ci-dessus.

Maintenant Dolibarr fonctionne en local sur votre installation de MAMP. Vous devez configurer toutes les options propres à votre société avant de continuer : “Les informations de configuration obligatoire doivent être renseignées”.

Vous effectuerez tous les réglages nécessaires à la première mise en route de Dolibarr ainsi que l'activation des modules requis en vous référant au Wiki de Dolibarr ainsi que ce forum.

Sécurisation

Une fois Dolibarr en place et que vous avez accès à la page “Accueil” de Dolibarr, en bas de cette page vous verrez deux avertissements de sécurité :

  • Ouvrez l’application TextEdit et sauvegardez un document vierge intitulé “install.lock” dans le dossier “Applications / MAMP / dolibarr / documents”. Aller dans ce dossier avec le Finder, sélectionner le fichier qui doit normalement s’appeler “install.lock.rtf” et aller dans le menu Fichier / Informations (raccourci pomme-i). Dans la case du nom de fichier, supprimer le “.rtf” à la fin, touche entrée puis “utiliser .lock” quand le Finder vous le demande.
  • Retournez dans Dolibarr et rafraichir la page, normalement le premier avertissement a disparu.
  • Dans le Finder, naviguez vers le dossier “Applications / MAMP / dolibarr / htdocs / conf” et sélectionnez le fichier “conf.php”. Aller dans les informations (raccourci pomme-i) et en bas de la fenêtre, dans la partie “partage et autorisations” basculer toutes les lignes sur “lecture seule”. Fermez la fenêtre, retourner sur Dolibarr et rafraichir la page.
  • Normalement les deux avertissements en bas de la page d’accueil ont disparus.

Dolibarr est désormais opérationnel.

Sauvegardes

Le plus simple c’est d’aller très régulièrement dans Dolibarr sous “Outils d’administration / Sauvegarde” et cliquez sur le bouton “générer sauvegarde”. Ces fichiers sont générés dans “Applications / MAMP / dolibarr / documents / admin / backup” C’est l’ensemble du dossier “Applications / MAMP / dolibarr / documents” que vous devrez sauvegarder. Sur Mac si votre Time Machine fonctionne correctement ça devrait suffire mais rien ne vous empêche de prendre des précautions supplémentaires…

Quand vous serez plus avancé avec Dolibarr, vous pourrez commencer à mettre en place des solutions type CRON pour réaliser des sauvegardes automatiques de la base de données.

Crédits : initialsBB