Installer i@nseo
Préparation de l'installation
i@nseo fonctionne comme un site web ; une pile dite AMP (Apache, MySQL, PHP) doit donc être installée au préalable.
Windows
Pour installer i@nseo sur un système d'exploitation Windows, suivez les étapes suivantes :
- Téléchargez le logiciel depuis ianseo.net. La méthode recommandée consiste à télécharger le programme d'installation complet, qui installera XAMPP.
- Extrayez le fichier dans le dossier souhaité. La méthode recommandée consiste à extraire le fichier dans
C:; ianseo se trouvera alors dansC:\ianseo.
- Exécutez le fichier
setup_xampp.bat, disponible dans le dossier. Une fenêtre de terminal s'ouvrira : si certains paramètres doivent être ajustés, le système affichera deux questions préremplies ; il suffit d'appuyer sur « Entrée ». Sinon, un message indiquant « Nothing to do » s'affichera. Fermez ensuite la fenêtre du terminal.
Après l'installation
Sous Windows 11, Windows Defender interfère apparemment avec XAMPP et provoque parfois le plantage d'i@nseo.
To avoid interferences between Windows Defender and XAMPP follow these steps[Win11 1]
Step 1: Open Windows Security and go in "Protection against virus and malware"
Step 2: At the bottom of the page click on Manage Exclusion
Step 3: Insert which elements to exclude from the scan paying attention to upper and lower case:
- Select folder to exclude:
- C:\ianseo
- File Types to exclude:
- .mysql
- .php
- Processes to exclude (type exactly as written):
- Apache HTTP Server
- mysqld
- xampp-control
- ↑ Arnaud Chalmel, Archers de Saint Loup
Exécuter XAMPP
Après avoir configuré les fichiers extraits, lancez XAMPP en cliquant sur l'icône Xampp-control, puis, dans la nouvelle fenêtre, cliquez sur « Start » pour **Apache** et MySQL.
AVERTISSEMENT
Si un avertissement apparaît indiquant que **VCRUNTIME140.dll** est introuvable, veuillez installer la dernière version de Microsoft Visual C++ Redistributable. Nous recommandons la version **x86**. En cas de doute, installez les deux !
Remarque : le panneau de contrôle XAMPP peut être fermé (ou réduit) et les services continueront de fonctionner.
Vérifiez que le dossier C:\ianseo\htdocs est accessible en écriture par tous : faites un clic droit sur le dossier, sélectionnez **Propriétés**, puis modifiez les autorisations afin que tout le monde dispose des droits de lecture et d'écriture sur ce dossier ainsi que sur tous les fichiers et sous-dossiers qu'il contient.
MacOs
Nous ne disposons pas d'un programme d'installation pour Mac ; la pile AMP doit donc être installée séparément.
Téléchargement de XAMPP/MAMP
Téléchargez XAMPP ([1]) ou MAMP ([2]) et suivez les instructions d'installation. Le guide suivant est basé sur MAMP, mais il est également valable pour XAMPP.
Choisissez la version appropriée selon que votre ordinateur utilise un processeur Intel ou Apple Silicon.
Exécutez le programme d'installation. Celui-ci installera MAMP ainsi qu'une version de démonstration de MAMP Pro. Ianseo n'utilise que les fonctionnalités de MAMP ; vous n'avez donc pas besoin d'acheter MAMP Pro, sauf si vous le souhaitez.
Après l'installation, vous trouverez un dossier nommé MAMP dans le dossier Applications. Ouvrez ce dossier en double-cliquant dessus, puis lancez l'application MAMP.
La plupart des valeurs par défaut conviennent pour Ianseo, mais quelques ajustements doivent d'abord être effectués. Ouvrez Préférences, puis l'onglet Ports. Cliquez sur le bouton « 80 & 3306 » afin de configurer MAMP pour utiliser les ports par défaut du serveur web et de MySQL.
Depuis ianseo.net, téléchargez le fichier ZIP et extrayez-le dans le dossier htdocs de XAMPP/MAMP (situé dans /Applications).
Pour les besoins de ce guide, Ianseo sera installé dans son propre dossier, nommé **ianseo**, et l'URL permettant d'accéder à Ianseo sera http://localhost/ianseo.
- Ouvrez le dossier
/Applications/MAMP/htdocs. - Créez un dossier à l'intérieur et nommez-le
ianseo(tout en minuscules, sans guillemets). - Décompressez le contenu du fichier ZIP téléchargé dans le dossier
ianseo. - IMPORTANT : Ouvrez le dossier
/Applications/MAMP/htdocs/ianseo/Commonet supprimez le fichierconfig.inc.php(s'il existe) afin de permettre le démarrage de la procédure d'installation. - Ouvrez une fenêtre de terminal (**Applications -> Utilitaires -> Terminal**).
- Accédez au dossier MAMP en saisissant la commande ci-dessous, en laissant un espace entre
cdet/, puis appuyez surEntrée:
cd /Applications/MAMP/htdocs
- Saisissez la commande suivante puis appuyez sur
Entrée. Le mot de passe de votre utilisateur vous sera demandé : saisissez-le en gardant à l'esprit que rien ne s'affichera pendant la saisie, pas même des astérisques (*).
sudo chown -R nobody:admin ianseo
- Saisissez la commande suivante puis appuyez sur
Entrée(le mot de passe pourra de nouveau être demandé) :
sudo chmod -R a+rwX ianseo
Starting MAMP
Lancez l'application MAMP, puis cliquez sur le bouton Start. Cela démarrera le serveur web Apache ainsi que la base de données MySQL. Il se peut que votre mot de passe vous soit demandé ; saisissez-le pour continuer.
Une fois MAMP démarré, votre navigateur devrait automatiquement ouvrir une page « Welcome to MAMP » affichant le numéro de version actuel.
Pour démarrer Ianseo, saisissez l'adresse http://localhost/ianseo dans un nouvel onglet. Vous devrez d'abord accepter le contrat de licence. Cochez la case, puis cliquez sur le bouton « I AGREE ».
S'il s'agit d'une nouvelle installation, suivez les instructions affichées à l'écran.
Une fois les informations de la base de données configurées, un message indiquant qu'Ianseo est désormais installé sur votre système devrait s'afficher.
Cliquez sur le lien « Go to IANSEO! » pour mettre votre système à jour vers la dernière version. La dernière version du logiciel sera automatiquement téléchargée et les fichiers de langue seront mis à jour. Une fois l'opération terminée, le message « The upgrade process is finished. » s'affichera. Cliquez sur le bouton pour continuer.
Linux
La méthode native d'installation de la pile AMP est appelée LAMP. Veuillez noter qu'i@nseo fonctionne avec PHP 8 ou une version ultérieure. Installez-la à l'aide de votre gestionnaire de paquets (des privilèges administrateur seront nécessaires) :
- apache2
- mysql-server
- mysql-client
- php
- php-mysql
- php-gd
- php-curl
- imagemagick
- php-imagick
- php-xml
- php-zip
- php-intl
- php-mbstring
Créez un utilisateur pour ianseo sur le serveur MySQL. Sur les distributions modernes dérivées de Debian, cela peut être fait avec la commande suivante (copiez et collez la ligne suivante dans un terminal) :
sudo mysql -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"
Si vous obtenez une erreur indiquant qu'un mot de passe est manquant, vous devez ajouter l'option permettant de spécifier le mot de passe. Veuillez noter que rien ne s'affichera pendant la saisie du mot de passe ; n'oubliez donc pas d'appuyer sur « Entrée » une fois la saisie terminée.
sudo mysql -p -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"
Créez le dossier /opt/ianseo et attribuez-en la propriété à votre utilisateur.
Téléchargez le fichier ZIP depuis ianseo.net et extrayez-le dans /opt/ianseo.
Attribuez les droits d'écriture à tous sur le dossier et les fichiers à l'aide de la commande suivante :
sudo chmod -R a+rwX /opt/ianseo
Copiez le fichier de configuration Apache situé dans /opt/ianseo/Install/apache-ianseo.conf vers /etc/apache2/conf-available, puis activez cette configuration dans Apache :
sudo cp /opt/ianseo/Install/apache-ianseo.conf /etc/apache2/conf-available sudo a2enconf apache-ianseo sudo service apache2 reload
Configuration finale d'i@nseo
Vérifiez qu'aucun fichier nommé config.inc.php n'est présent dans le dossier Common.
Ouvrez un navigateur Internet et accédez à l'adresse http://localhost/ianseo.
Suivez les instructions affichées à l'écran par le logiciel.