03. INSTALLATION
3.1 Introduction
Keatic ERP est installable sur un serveur LAMP (Linux, Apache, MySQL, PHP). Ce chapitre présente deux méthodes d’installation en local sous Windows :
Via l’installeur DoliWamp (méthode recommandée pour débuter)
Via les sources GitHub avec XAMPP (méthode pour les développeurs)
3.2 Installation via DoliWamp
TÉLÉCHARGEMENT :
Commencez par récupérer les sources sur SourceForge : https://sourceforge.net/projects/keatic ERP/files/ Cliquez sur le lien Keatic ERP installer for Windows (DoliWamp), puis sur le tag de la dernière version stable.
Figure 3.1 – Page de téléchargement sur SourceForge
ÉTAPES DE L'INSTALLATION :
Récupérez et lancez l’exécutable DoliWamp. Suivez toutes les étapes de l’assistant d’installation pas à pas, en cliquant sur les boutons Oui, Suivant ou Installer.
Étape 1 — Démarrage de l’assistant
Figure 3.2 – Étape 1 : démarrage de l’assistant DoliWamp
Étape 2 — Accord de licence
Figure 3.3 – Étape 2 : accord de licence
Étape 3 — Dossier d'installation
Figure 3.4 – Étape 3 : dossier d’installation
Étape 4 — Composants à installer
Figure 3.5 – Étape 4 : composants à installer
Étape 5 — Dossier dans le menu Démarrer
Figure 3.6 – Étape 5 : dossier dans le menu Démarrer
Étape 6 — Résumé avant installation
Figure 3.7 – Étape 6 : résumé avant installation
Étape 7 — Autorisation d’accès réseau
Autorisez l’accès naturellement lorsque le pare-feu Windows vous le demande.
Figure 3.8 – Étape 7 : autorisation du pare-feu Windows
Étape 8 — Fin de l’installation Windows
Figure 3.9 – Étape 8 : installation DoliWamp terminée
SUITE DE L'INSTALLATIONDANS L'INTERFACE WEB :
Le reste de l’installation se déroule dans l’interface web. DoliWamp ouvre automatiquement le navigateur sur l’assistant d’installation Keatic ERP.
3.3 Installation à partir des sources GitHub (XAMPP)
Cette méthode est destinée aux développeurs qui souhaitent travailler directement avec les sources du projet.
PRÉREQUIS :
Un serveur LAMP local, par exemple XAMPP (https://www.apachefriends.org/)
Git Bash installé (https://git-scm.com/)
CLONNAGE DU DÉPOTS :
Placez-vous dans le dossier htdocs de XAMPP, faites un clic droit et lancez Git Bash.
Figure 3.11 – Lancement de Git Bash via le menu contextuel
Utilisez la ligne de commande suivante pour cloner le dépôt :
git clone git@github.com:Keatic ERP/keatic ERP.git
Figure 3.12 – Commande git clone dans Git Bash
Figure 3.13 – Progression du clonage
SÉLÉCTION DE LA VERSION :
Une fois le téléchargement terminé, déplacez-vous dans le dossier keatic ERP et basculez sur la version souhai- tée :
cd keatic ERP
git checkout 23.0
Renommez ensuite le dossier pour le distinguer des autres versions, par exemple keatic ERP-230.
CONFIGURATION D'UN VirtualHost XAMPP :
Pour accéder directement à Keatic ERP sans ajouter /htdocs/ dans l’URL, créez un VirtualHost Apache.
Éditez le fichier C:\xampp\apache\conf\extra\httpd-vhosts.conf et ajoutez :
ServerName keatic ERP-230.local
DocumentRoot "C:/xampp/htdocs/keatic ERP-230/htdocs"
AllowOverride All
Require all granted
Éditez le fichier hosts C:\Windows\System32\drivers\etc\hosts et ajoutez :
127.0.0.1 keatic ERP-230.local
Redémarrez Apache depuis le panneau de contrôle XAMPP.
Vous pouvez maintenant accéder à votre instance via : http ://keatic ERP-230.local
PAGE D'INDEX XAMPP PERSONNALISÉE (bonus) :
Pour avoir une page d’accueil XAMPP listant automatiquement vos VirtualHosts, remplacez le contenu de index.php à la racine de htdocs par :
Accueil XAMPP
Accueil XAMPP
Mes projets (VirtualHosts)
Figure 3.14 – Page d’accueil XAMPP personnalisée avec liste des VirtualHosts
CRÉATION DE LA BASE DE DONNÉES :
Ouvrez phpMyAdmin (http://localhost/phpmyadmin/) et créez une nouvelle base de données, par exemple keatic ERP-230.
Figure 3.15 – Création de la base de données dans phpMyAdmin
Figure 3.16 – Base de données créée
3.4 Assistant d’installation web de Keatic ERP
Que vous ayez utilisé DoliWamp ou l’installation depuis les sources, la suite de la configuration se déroule dans l’interface web de Keatic ERP.
Étape 1 — Vérification de l’environnement
L’assistant vérifie automatiquement la compatibilité de votre environnement (version PHP, extensions re- quises, droits sur les dossiers…).
Figure 3.17 – Étape 1 de l’assistant web : vérification de l’environnement
Passez à l’étape suivante une fois toutes les vérifications validées.
Étape 2 — Configuration de la base de données
Important : Le nom de la base de données doit correspondre exactement à celle créée précédemment (ici : keatic ERP-230).
Figure 3.18 – Étape 2 : configuration de la connexion à la base de données
Étape 3 — Installation des tables
L’installation des tables SQL peut prendre quelques minutes. Attendez l’affichage complet de la page suivante avant de poursuivre.
Figure 3.19 – Étape 3 : installation des tables en cours
Figure 3.20 – Progression de l’installation des tables
Étape 4 — Ping anonyme
Keatic ERP vous propose d’effectuer un ping anonyme pour permettre à la fondation de comptabiliser le nombre d’installations actives. Cette étape est facultative.
Figure 3.21 – Option de ping anonyme pour la fondation Keatic ERP
Étape 5 — Création du compte administrateur
Renseignez un identifiant et un mot de passe pour le compte administrateur de votre instance Keatic ERP.
Figure 3.22 – Création du compte administrateur
Figure 3.23 – Installation terminée — accès à Keatic ERP
Astuce : Notez bien vos identifiants administrateur. En cas de perte, il est possible de les réinitialiser directement en base de données, mais cela nécessite un accès à phpMyAdmin ou à la ligne de commande MySQL.