+++++ En cas de difficulté d'installation, n'hésitez pas à nous contacter (onglet CONTACT du site)

-- page mise à jour le 6 juin 2024 --
​
​Cette section décrit l'installation d'un serveur MariaDB, clone open source de MySQL. 
On peut utiliser sur MacOS  (Intel ou Silicon), comme sous Linux Ubuntu, un clone open source de MySQL, MariaDB.
Il n'est pas possible d'utiliser un serveur MySQL version 5.7 sur un Mac à puce Apple Silicon.
​
Si un serveur MySQL ou MariaDB est déjà installé sans encore de base de données Rufus valide, allez directement au cas n°1 de la page Installation d'un poste client MacOS.
Si un serveur MySQL ou MariaDB est déjà installé avec une base de données Rufus valide, allez directement au cas n°2 de la page Installation d'un poste client MacOS.

Techniquement, l'installation du serveur a 5 objectifs fondamentaux et un facultatif

• installer le programme serveur lui même, MySQL ou MariaDB
• configurer le serveur en créant un utilisateur qui aura tous les droits d'administration
• créer un dossier pointé par la variable secure-file-priv du serveur
• ​partager le dossier d'imagerie sur le réseau
• installer facultativement un gestionnaire graphique de la base de données

Votre version de MacOS doit être égale ou ultérieure à Monterey

Il y a de nombreuses instructions en ligne de commande. Plutôt que de les retaper, il est beaucoup plus rapide et sûr de faire à chaque fois un copier-coller de la ligne à taper depuis ce document vers le terminal pour éliminer les risques d'erreur (Command-C pour copier – Command-V pour coller).
Cette installation, téléchargement de MySQL non comprise, demande environ 15 minutes.

+++ Quelques précisions

​A plusieurs reprises, le terminal du mac vous demandera votre mot de passe.
Quand vous tapez un mot de passe dans le terminal, il n'y a aucun « echo » à votre frappe (il ne se passe rien à l'écran), ce qui est normal.
Attention aussi aux espaces dans les lignes de commande du terminal. On les oublie souvent.

!Attention! Vous devez être administrateur du système pour pouvoir faire cette installation. Vérifiez vos droits dans Pomme/Préférences Système/Utilisateurs et groupes. La case Autoriser l'administration de cet ordinateur doit être cochée.

Même si MySQL le permet, les logins ainsi que les mots de passe que vous créerez ne doivent contenir que des lettres ou des chiffres, pas de caractères spéciaux, ni d'espace, ni de caractères accentués.
Leur longueur ne doit pas dépasser 15 caractères.
DrRobert1234 ou gaxt79iy sont autorisés par Rufus.
Robert_Au, Robert/Au ou Robert Au ne le sont pas.

Enfin, chaque ligne de commande à taper est bien entendu suivie par la touche Enter
par exemple :
cd (Enter)
nano .bash_profile (Enter)

1. Installation de Homebrew

Homebrew est un gestionnaire de paquets (au même titre que apt pour Linux Ubuntu) qui permet d'installer de façon transparente des logiciels ou des utilitaires non installés par Apple.
Il s'utilise via le terminal d'Apple et va nous permettre d'installer MariaDB (mais aussi poppler, par exemple, utilitaire indispensable au fonctionnement de Qt, le langage de programmation qui va éxécuter le code de Rufus)

• Pour installer Homebrew donc, lancer de nouveau Terminal.
• ->  Applications/Utilitaires/Terminal ou LaunchPad/Autre/Terminal

et enter la commande
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Le terminal va vous demander votre mot de passe Mac,
​puis quelques lignes plus loin, va vous demander de confirmer en appuyantsur Enter.
Ensuite, suivant la rapidité de votre connexion, Homebrew va s'installer et occuper la machine un temps certain pendant que beaucoup d'informations vont défiler dans la fenêtre du Terminal.
Profitez en pour prendre un café.
A la fin, le programme se termine avec dans les dernières lignes le message

==> Homebrew has enabled anonymous aggregate formulae and cask analytics.
Read the analytics documentation (and how to opt-out) here
https://docs.brew.sh/Analytics
No analytics data has been sent yet (nor will any be during this install run).
==> Homebrew is run entirely by unpaid volunteers. Please consider donating:
https://github.com/Homebrew/brew#donations
==> Next steps:
- Run these two commands in your terminal to add Homebrew to your PATH
(echo; echo 'eval "$(/usr/local/bin/brew shellenv)"') >> ~/.profile
eval "$(/usr/local/bin/brew shellenv)"
- Run brew help to get started
- Further documentation
https://docs.brew.sh

Si vous ne comprenez rien à ce message, ne cherchez pas à le faire parce qu'à part une bonne migraine et une perte de temps conséquente, vous ne gagneriez pas grand chose.
Faites donc simplement ce qu'on vous dit en entrant les 2 commandes suivantes dans le terminal
pour un mac à puce Apple Silicon M1/M2

• (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.profile
• eval "$(/opt/homebrew/bin/brew shellenv)"

pour un mac à puce Intel x86

• (echo; echo 'eval "$(/usr/local/bin/brew shellenv)"') >> ~/.profile
• eval "$(/usr/local/bin/brew shellenv)"

2. Installation de MariaDB

Les choses vont devenir bien plus simples.
Dans le terminal, maintenant que Homebrew est installé, entrez la commande

• brew install mariadb

Nouveau pédalage, beaucoup de temps et de lignes qui défilent à l'écran, reprenez un café en attendant
puis programmez le démarrage automatique de MariaDB au démarrage de l'ordinateur avec la commande

• brew services start mariadb

3. Configuration de MariaDB

 Dans le Terminal, entrez la commande

• sudo mysql -u root

​le terminal vous demande votre mot de passe, entrez votre mot de passe Mac
​Vous devez normalement être accueilli par ces lignes qui signifient que le Terminal vous a mis en communication avec le serveur MariaDB

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 5
Server version: 10.11.2-MariaDB Homebrew
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]>

A partir de là, les commandes que vous entrez dans le terminal sont interprétées par MariaDB et pas par le Mac
Vous êtes maintenant connecté à MariaDB en tant qu'utilisateur root
Vous allez commencer par créer un mot de passe pour cet utilisateur parce que vous ne pourriez pas continuer plus loin dans le cas contraire
Tapez la commande

• ALTER USER root@localhost IDENTIFIED VIA mysql_native_password;
  
• SET PASSWORD = PASSWORD('lemotdepassequevousvoulez');
• flush privileges;
  

MariaDB va vous répondre à chaque fois par 

• Query OK, 0 rows affected (0,038 sec)

Quittez MariaDB pour revenir au Mac

• exit

Puis reconnectez vous en tant qu'utilisateur root pour vérifier que tout marche

• mysql -u root -p

le programme va vous demander votre mot de passe.
Entrez le mot de passe que vous venez de définir pour root

• lemotdepassequevousvoulez

Vous devez être accueilli par le même message que tout à l'heure

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 5
Server version: 10.11.2-MariaDB Homebrew
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
MariaDB [(none)]>

Cool. Tout marche à merveille.

• exit​

4. Sécurisation de MariaDB

Il vous faut maintenant sécuriser MariaDB pour le protéger contre les attaques extérieures.
Entrez la commande
pour un mac à puce Apple Silicon M1/M2

• /opt/homebrew/opt/mariadb/bin/mariadb-secure-installation

pour un mac à puce Intel x86

• /usr/local/opt/mariadb/bin/mariadb-secure-installation

Suivez les instructions et répondez aux questions successives
A la question Enter current password for root, entrez le mot de passe que vous venez de créer
A la question Switch to unix_socket authentication [Y/n], répondez n
A la question Change the root password? [Y/n], répondez n
A la question Remove anonymous users? [Y/n], répondez Y
A la question Disallow root login remotely? [Y/n], répondez Y
A la question Remove test database and access to it? [Y/n], répondez Y
,A la question Reload privilege tables now? [Y/n], répondez Y
Vous avez terminé cette étape

5. Paramètrage de MariaDB et création du premier utilisateur

• Depuis le terminal, redémarrez une session MariaDB en vous connectant comme utilisateur root
• mysql -u root -p
• la machine vous demande votre mot de passe de connexion à MariaDB.

• Créer un nouvel utilisateur avec l'identifiant que vous souhaitez et votre propre mot de passe.
  le login ne doit comporter que des chiffres ou des lettres non accentuées et sa longueur doit être comprise entre 5 et 15 caractères.
  le nouveau mot de passe ne doit comporter que des chiffres ou des lettres non accentuées et sa longueur doit être comprise entre 5 et ​12 caractères.​
  ​Si ces règles ne sont pas respectées, Rufus refusera de démarrer.
• Dans cet exemple j'ai pris pour login "DrNewUser" et pour mot de passe "newmdp"

create user DrNewUser@localhost identified by 'newmdp';

+++ RAPPEL
Pour les logins comme pour les mots de passe
→ pas de caractères spéciaux, ni d'espace ni de caractères accentués
Uniquement des chiffres ou des lettres.
​Longueur minimale 5 caractères
Longueur maximale
15 caractères pour le login
12 caractères pour le mot de passe

• donnez vous tous les droits...

grant all on *.* to DrNewUser@localhost with grant option;

• ​quitter MariaDB

exit (sans point virgule)

+++ Conservez précieusement ce login et ce mot de passe, ils vous seront utiles si vous avez besoin un jour de restaurer la base de données sur un poste vierge de toute installation de rufus et de sa base de données. Dans le cas contraire, il vous faudra recréer un nouvel utilisateur, comme dans les lignes précédentes.

• se reconnecter à MariaDB avec votre nouveau compte pour vérifier qu'il a bien été créé

mysql -u DrNewUser -p

• donner le mdp

newmdp

• vous devez obtenir la réponse Welcome to the MariaDB monitor...
• Bien, c'est maintenant 'DrNewUser' qui est connecté à la base MariaDB et plus 'root'
• Vérifiez que DrNewUser a bien tous les droits

show grants for DrNewUser@localhost;

• La réponse doit être GRANT ALL PRIVILEGES ON *.* TO 'DrNewUser'@'localhost' ...etc... WITH GRANT OPTION
• +++++ Cette réponse doit impérativement contenir à la fin les termes WITH GRANT OPTION sinon il faut recommencer à partir de la définition des droits du nouvel utilisateur en se déconnectant en root et entrant l'instruction
  •  grant all on *.* to DrNewUser@localhost with grant option;
• Si tout est OK, vous pouvez maintenant détruire l'utilisateur root (facultatif)

drop user root@localhost;

• ​quitter MariaDB

exit

6. Création et optimisation du fichier de configuration de MariaDB

A. Configuration du fichier 50-server.cnf
Par défaut, MariaDB n'a pas le droit de modifier de fichiers autres que ceux de la base de données. Il doit cependant pouvoir le faire dans le cas de Rufus pour gérer les documents d'imagerie qui ne sont pas stockés dans la base de données mais dans le dossier Imagerie que nous avons créé.
​Une variable interne de MariaDB, secure_file_priv, indique les dossiers que MariaDB a le droit de modifier sur l'ordinateur hôte. Elle est par défaut positionnée à 'null' (rien -> aucun).
Il faut donc modifier cette variable en la faisant pointer sur le dossier Rufus -> /Users/Shared/

Pour cela, dans le Terminal, il faut modifier le fichier 50-server-cnf
Ce fichier peut se trouver dans /opt/homebrew/etc/my.cnf.d ou dans /usr/local/etc/my.cnf.d/ suivant le type d'installation
​Pour cela copier-coller la ligne suivante dans la fenêtre du Terminal, suivie de Enter.​​
pour un mac à puce Apple Silicon M1/M2

• sudo nano /opt/homebrew/etc/my.cnf.d/50-server.cnf

pour un mac à puce Intel x86

• sudo nano /usr/local/etc/my.cnf.d/50-server.cnf

Entrez le mot de passe administrateur du Mac puis Enter
Vous venez de lancer un éditeur de texte simplifié qui va vous permettre de modifier la configuration de MariaDB.
Dans l'écran nano, rajouter les lignes suivantes
et, sur la dernière ligne qui fixe secure_file_priv,
​  remplacez votrenomdutilisateur par votre nom d'utilisateur Mac comme sur l'écran ci-contre

• [mysqld]
• secure_file_priv = /Users/Shared
• sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

Fermer nano en tapant Ctrl-X
puis Y pour valider les changements
puis Enter ​

B. Contrôle des modifications
Redémarrez votre Mac pour prendre en compte les changements
Après le redémarrage, ​se reconnecter à MariaDB avec votre nouveau compte pour vérifier qu'il a bien été créé

• mysql -u DrNewUser -p

donner le mdp

• newmdp

Vérifiez que vos changements ont été pris en compte
​Tapez

• SHOW VARIABLES LIKE "secure_file_priv";

vous devez obtenir en réponse /Users/votrenomdutilisateur/Documents/Rufus/

• SHOW VARIABLES LIKE "bind-address";

vous devez obtenir en réponse Empty set

6. Partage du fichier Users/Shared sur le réseau

Cette manipulation est indispensable si des ordinateurs doivent se connecter sur le réseau et utiliser les données de Rufus
Il faut donc partager sur le réseau le dossier /Users/shared où se trouvent les documents d'imagerie de Rufus
​Pour cela Menu /Pomme/Préférences/ Onglet Général
Cliquer sur le curseur en face de Partage de fichiers pour que celui-ci devienne bleu

Cliquez sur le point i en regard du curseur Partage de fichiers
Choisir le dossier /Users/Shared ​dans l'écran qui suit

Vérifier dans l'écran qui apparait que le dossier /Users/Shared (classiquement le dossier Partagé) de votre ordinateur est bien partagé avec les même autorisations que celles que l'on voit dans la fenêtre ci-contre

7. Facultatif mais ô combien pratique. Installation de DBeaver

• Rendez vous sur la page DBeaver Community pour télécharger DBeaver
• Sélectionner votre système d'exploitation (en l'occurence macOS)

On peut aussi utiliser MySQL Workbench  qui est la référence en matière de visualisateur de bases de données MySQL, mais ce programme est assez instable...

 Plus d'infos sur le fichier 50-server.cnf
ce fichier sert à effectuer certains réglages sur le serveur mySQL et contient donc 4 instructions indispensables au fonctionnement correct de Rufus dans sa section [mysqld]
​Quelques explications

• ​secure_file_priv = ""
  

Définit les dossiers où se trouvent les fichiers que MySQL peut utiliser.
Il est donc déconseillé de laisser ce paramètre à "" car MySQL a alors accès à tous les dossiers de l'ordinateur, ce qui diminue la sécurité.
Dans le cas de Rufus, on indique donc le répertoire où sont stockées les images (OCT, RNM,...etc...)

• sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION 
  

définit des paramètres du serveur éxigés par Rufus pour son bon fonctionnement

​Ouf! La configuration du serveur MySQL est vraiment terminée.
Vous avez fait 95% du travail d'installation de Rufus
​Reportez-vous maintenant à la page Installation d'un poste Rufus sous MacOS ou Installation d'un poste Rufus sous Linux Ubuntu suivant le système d'exploitation du poste