Install i@nseo/fr

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 dans C:\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

Step 1: Open Windows Security and go in "Protection against virus and malware"

Step 1

Step 2: At the bottom of the page click on Manage Exclusion

Step 2

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

Step 3

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/Common et supprimez le fichier config.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 cd et /, puis appuyez sur Entré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.

Pendant l'installation, MAMP ne définit pas de mot de passe pour l'utilisateur root de MySQL ; lorsque le programme d'installation le demandera, laissez ce champ vide. Les autres champs peuvent être laissés avec leurs valeurs par défaut. Cliquez sur le bouton « Create user and database » pour poursuivre.

Si le programme d'installation affiche un message d'erreur indiquant qu'il n'a pas pu se connecter à la base de données, saisissez « root » dans le champ « ADMIN Password to create users and databases », puis cliquez sur le bouton « Create user and database » pour réessayer.

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

Create a user for ianseo in the mysql server. This can be done in modern debian derived distribution with (copy and paste the following line in a terminal):

sudo mysql -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"

If you have an error of missing password, you need to add the password switch. Be aware that you will not see the password as you type, so don't forget to hit "enter" when done.

sudo mysql -p -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"

Create the folder /opt/ianseo and assign the folder to your user. Download the zip file from ianseo.net and extract in /opt/ianseo.

Assign world writeable permissions to the folder and files with the following command.

sudo chmod -R a+rwX /opt/ianseo

Copy the apache configuration file located in /opt/ianseo/Install/apache-ianseo.conf in /etc/apache2/conf-available and enable the change in apache

sudo cp  /opt/ianseo/Install/apache-ianseo.conf /etc/apache2/conf-available
sudo a2enconf apache-ianseo
sudo service apache2 reload

Final Setup of i@nseo

Check there is no file in Common called config.inc.php Open an Internet browser and navigate to http://localhost/ianseo

Follow the on-screen instructions given by the software.

Main I@nseo Menu Bar

• Install i@nseo
• Update i@nseo
• Competition
• Participants
• Qualification
• Round Robin
• Individual Finals
• Team Finals
• Printout
• ISK
• Output
• Modules
• Tips and Tricks
• Common Issues