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

-- page mise à jour le 7 novembre 2024 --

L'installation de Rufus en lui même est extrêmement simple. Elle implique qu'on ait au préalable installé et configuré un serveur MySQL, ce qui est un peu long mais à la portée d'un neophyte si on suit à la lettre les instructions qui suivent.
Ce tutoriel est donc consacré à l'installation du serveur.

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

• installer le programme serveur lui même, MySQL
• 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

​Si MySQL 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 MySQL 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.

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 MySQL

1. Télécharger MySQL Community Server en cliquant ici dev.mysql.com/downloads/mysql/

​Dans l'écran qui apparaît, cliquer sur « Product version » et choisir la version 8.4.3 LTS. Les versions ultérieures n'ont pour l'instant pas été testées avec Rufus.
​Choisir le fichier dmg à télécharger en fonction de votre Mac

• Mac récent à processeur ARM Silicon -> version ARM 64 bit
• Mac plus ancien à puce Intel -> version x86 64 bit

Sur un Mac sous Monterey, il faudra fouiller dans les archives et télécharger la version 8.0.34 de MySQL.

Installer en double-cliquant sur le fichier
mysql-8.4.3-macos14-xxxx.dmg
​dans le dossier Téléchargements

​puis double clic dans la fenêtre suivante sur le fichier
mysql-8.4.3-macos14-xxxx.pkg

En général, ce message apparait

​Cliquez sur Autoriser

Suivez la procédure d'installation en acceptant la licence

Choisir Installer pour tous les utilisateurs de cet ordinateur

Fournir votre mot de passe quand l'installateur vous le demande.

Choisissez et entrez un mot de passe pour l'utilisateur root qui est l'utilisateur principal par défaut de MySQL
Cliquer sur Finish

​Confirmer une nouvelle fois le démarrage automatique de MySQL en fournissant le mot de passe de votre Mac

2. Modification de la variable d'environnement

Vérifier que le serveur MySQL s'est bien lancé automatiquement au démarrage du Mac.
Pour cela, aller dans Pomme/Réglages système et cliquer sur MySQL en bas.
2 points verts doivent figurer devant les mots MySQL 8.4.3, attestant que le programme MySQL est bien démarré.
Si ces points sont rouges, cliquez sur Start MySQL Server pour démarrer le serveur.
Si le serveur ne démarre pas, réessayez après avoir redémarrer votre ordinateur.
Si malgré cela, opportunité rare, le serveur ne marche toujours pas, c'est qu'il y a un problème de configuration sur votre machine. Désinstallez totalement MySQL Server et essayez de le réinstaller.

• Bien , l'installation de MySQL est terminée et il faut maintenant effectuer quelques réglages.
  
• Pour cela, lancer un programme appelé Terminal.
  
• ->  Applications/Utilitaires/Terminal ou LaunchPad/Autre/Terminal

• ​​​Changer la variable d'environnement permet de simplifier le lancement de MySQL.
  • Pour cela modiifer le fichier /etc/paths depuis le Terminal en entrant la ligne

sudo nano /etc/paths
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 le fichier paths en ajoutant une valeur nouvelle à la variable d'environnement.
• Dans l'écran nano, rajouter à la fin la ligne

/usr/local/mysql/bin

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

• Vous avez quitté nano et êtes revenu dans le terminal.

​Redémarrez le Mac pour que le système enregistre les modifications de /etc/paths

• Vérifier que la variable PATH a bien été actualisée

echo $PATH

• le chemin /usr/local/mysql/bin doit apparaître dans la réponse de terminal, au milieu d'autres chemins séparés par « : ».

3. Configuration des versions de macOS (inutile sur les versions antérieures)

A partir de la version Monterey de MacOS, il faut autoriser MySQL à accéder aux documents stockés sur le disque.
Pour Monterey

• ​Menu Pomme/Préférences Système
• Icône Sécurité et confidentialité
• Onglet Confidentialité
• Clic sur le cadenas en bas à droite pour modifier et entrer le mot de passe administrateur
• Faire défiler la colonne de gauche et choisir Accès complet au disque
• Faire défiler le tableau de droite et cocher la case mysqld

Il est posssible que le programme mysqld n'apparaisse pas dans la liste. Voir plus bas

A partir de Ventura,  L'écran est différent.
Ouvrir Pomme Réglages du système - descendre jusqu'à Confidentialité et sécurité - Dans la partie droite de l'écran, cliquer sur accès complet au disque

Il est possible que le programme mysqld n'apparaisse pas dans la liste.
Cliquer sur la case + après avoir déverrouillé en cliquant sur le cadenas et en donnant votre mot de passe administrateur Mac
​Un écran qui va permettre de retrouver le fichier mysqld apparait

Cependant, cet écran n'affiche pas les dossiers et fichiers cachés de l'ordinateur.
Appuyer sur les touches Command-Shift-. (point) en même temps pour faire apparaître ces fichiers et naviguer jusqu'à /usr/local/mysql/bin et choisir le fichier mysqld (pas mysql)
​Cliquer sur Tansférer
​

Le programme mysqld apparait maintenant dans la liste. Faites glisser le curseur vers la droite en face de son nom pour autoriser ce programme à avoir accès aux fichiers du disque (ou cocher la case pour Monterey et les versions antérieures)

4. Paramètrage de MySQL et création du premier utilisateur

•  Depuis le terminal, démarrez une session MySQL en vous connectant comme utilisateur root

mysql -u 'root' -p

• la machine vous demande le mot de passe de connexion à MySQL.
• Entrez le mot de passe compliqué semblable à it*8J-adeaoi que MySQL vous a donné au moment de son installation et que vous avez noté (attention, il n'y a pas d'echo à ce que vous tapez quand il s'agit d'un mot de passe – rien n'apparait à l'écran) puis validez par Enter
• mysql doit vous accueillir par une confirmation Welcome to the mysql monitor... etc... et vous êtes maintenant dans la console mysql. Ce qui signifie qu'à partir de maintenant, les commandes que vous entrez dans le Terminal ne sont plus interprétées par le Terminal mais par MySQL. Chaque commande  doit se terminer par un point-virgule. Si la commande est correctement exécutée, MySQL le confirme par le message Query OK... Pour quitter le serveur MySQL et revenir au Terminal, il faudra taper la commande exit.

• Changer le mdp de root pour n'importe quoi, ici nouveaumdp

set password = 'nouveaumdp'; (attention à bien noter les apostrophes dans chaque instruction)

• ​MySQL doit donc vous répondre par Query OK... 

• 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 MySQL pour revenir au Terminal.

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 à MySQL 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 MySQL monitor... de MySQL
• Bien, c'est maintenant 'DrNewUser' qui est connecté à la base MySQL 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' 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;
• Vous pouvez maintenant détruire l'utilisateur root (facultatif mais conseillé)

drop user root@localhost;

• ​quitter MySQL

exit

5. 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

5. Création et optimisation du fichier de configuration de MySQL

Configuration du fichier /etc/my.cnf
Par défaut, MySQL 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 MySQL, secure_file_priv, indique les dossiers que MySQL 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 /etc/my.cnf
Relancez nano en éditant /etc/my.cnf cette fois ci
sudo nano /etc/my.cnf

• confirmez avec votre mot de passe MacOS​
• Ajoutez les lignes suivantes

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

• ​Relancer l'ordinateur ou relancez MySQL depuis le panneau de Preferences Système.​
• vérifiez la valeur enregistrée de la variable
  • relancer le Terminal et se reconnecter à MySQL avec votre compte
  • mysql -u DrNewUser -p
  • donner le mdp
  • newmdp
  • vous devez obtenir la réponse Welcome to the MySQL monitor... de MySQL
  • ​Tapez
  • SHOW VARIABLES LIKE "secure_file_priv";
  • vous devez obtenir en réponse /Users/Shared/

6. Facultatif mais ô combien pratique. Installation de MySQL Workbench

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

 Plus d'infos sur le fichier my.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 en lecture comme en écriture
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