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.

• Open folder “/Applications/MAMP/htdocs”
• Create a folder inside it and name it “ianseo” (all lower case, without quotes)
• Uncompress the contents of the downloaded zip file inside the ianseo folder
• IMPORTANT: Open the folder /Applications/MAMP/htdocs/ianseo/Common and delete the file config.inc.php (if it exists) to allow the installation procedure to start.
• Open a terminal window (Applications -> Utilities -> Terminal)
• Go to the MAMP folder by type the command below, including a space between cd and /, and press Enter:

   cd /Applications/MAMP/htdocs

• Type the following command and press Enter. You will be asked the password of your user: enter it but remember that nothing will be displayed while typing, not even *.

   sudo chown -R nobody:admin ianseo

• Type the following command and press Enter (again it can ask for the password):

   sudo chmod -R a+rwX ianseo

Starting MAMP

Start the MAMP application and then press the Start button. This will start the Apache web server and the MySQL database. You may be prompted to enter your password; enter it to continue.

Once MAMP starts, your browser should automatically open to a Welcome to MAMP page showing the current version number.

To start Ianseo, enter the address http://localhost/ianseo in a new tab. You will first need to agree to the License Agreement. Check the box and click on the I AGREE button.

If this is a new installation, follow the onscreen instructions.

During installation, MAMP does not set the MySQL root password, so when the installer will ask for it, leave it blank. The other fields can be left with default values. Click the Create user and database button to proceed.

If the installation program displays an error message indicating that it could not connect to the database, enter “root” in the ADMIN Password to create users and databases fields and click the Create user and database button to try again.

Once the database information is configured, you should see a message saying Ianseo is now installed on your system.

Click on the link “Go to IANSEO!” to update your system to the latest version. This will automatically download the latest version of the software and update the language files. When this is finished you will see the message “The upgrade process is finished.”. Click the button to continue.

---

Linux

The native way of installing the AMP stack is called LAMP: be aware that i@nseo will run on php 8 or later. Install with your package manager (you will need administrative privileges):

• 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