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

+++ SI VOUS POSSEDEZ UN MAC NOUVELLE GENERATION A PUCE APPLE SILICON M1/M2,
IL N'EST PAS POSSIBLE D'INSTALLER UN SERVEUR MYSQL 5.7.
VOUS DEVEZ INSTALLER UN SERVEUR MARIADB (ou MYSQL 8.0 mais la procédure n'est pas décrite ici)
REPORTEZ VOUS A LA PAGE -> Installation du serveur MariaDB sous MacOS

-- page mise à jour le 7 mai 2023 --
​
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.
Rufus fonctionne correctement à partir de la version Sierra de MacOs et il n'est donc pas utile d'avoir les dernières versons de MacOS pour avoir une solution fonctionnelle.
​
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 downloads.mysql.com/archives/community/

​Dans l'écran qui apparaît, cliquer sur « Product version » et choisir la version 5.7.31. C'est la dernière version de MySQL 5.7 compatible avec MacOS
On peut utiliser la version MySQL 8.0 mais elle ne fonctionne pas avec des Mac trop anciens.

Choisir le fichier .dmg (le premier de la liste) puis

Installer en double-cliquant sur le fichier mysql-5.7.31-macos10.14-x86_64.dmg dans le dossier téléchargements
​puis double clic dans la fenêtre suivante sur le fichier mysql5.7.31-macos10.14-x86_64.pkg

En général, ce message apparait

​Cliquez sur OK et Ouvrir Pomme/Paramètres système.
Choisisr Sécurité et confidentialité et cliquez sur ouvrir quand même

Un nouvel écran d'alerte apparait. Cliquez sur Ouvrir

Suivez la procédure d'installation en acceptant tous les choix par défaut et en l'autorisant avec votre mot de passe de l'ordinateur

Noter soigneusement le mot de passe cabalistique que MySQL vous donne à la fin de son installation.
Ici, il s'agit de it*8J-adeaoi
Si vous le perdez, il faudra désinstaller MySQL et le réinstaller.

Fermer la fenêtre du programme d'installation, conserver le fichier au cas où.
​Redémarrer l'ordinateur.

2. Modification de la variable d'environnement et création du dossier Rufus

A. 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/Préférences système et cliquer sur MySQL en bas.
Si vous lisez le mot "stopped" écrit en rouge, le serveur MySQL n'a pas démarré. Cliquer alors sur "start MySQL Server". Entrer votre mot de passe Mac. Laisser cochée la case démarrage automatique.
Vous devez obtenir le message "The MySQL Server instance is running".
Fermer la fenêtre.

• 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 copier-coller la ligne suivante dans la fenêtre du Terminal, suivie de Enter.​​

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 « : ».

B. Création du dossier Rufus et du dossier Imagerie
Pour finir, créez un dossier Rufus dans le dossier Documents de votre compte utilisateur.
Puis, créez un dossier Imagerie dans le dossier Rufus.

Donnez les droits d'accès à votre dossier Documents à MySQL. Pour cela, dans le terminal, taper

• sudo chmod -R 766 ~/Documents

​​Entrez votre mot de passe mac et tapez Enter

• Détail technique qui m'a bien fait galérer
• Si vous faites
  • sudo chmod -R 766 ~/Documents/Rufus
• ​Cela ne marchera pas. Vous donnerez effectivement les droits d'accès au dossier Rufus à MySQL mais le dossier Documents qui est au-dessus bloque ces droits
• Et il n'autorisera pas le groupe staff, dont fait partie MySQL, à accéder aux  dossiers qu'il contient.
• La commande chmod aura beau donner le droit d'accès à /Documents/Rufus pour MySQL celui-ci ne pourra pas y accéder.
• Documents ne le laissera pas passer - impénétrables voies de MacOs.

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

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

• ​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

Jusqu'à Monterey , c'est cet écran

Depuis 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. 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/votrenomdutilisateur/Documents/Rufus/
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 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]
​sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION
max_allowed_packet = 8M
secure_file_priv = /Users/votrenomdutilisateur/Documents/Rufus 

 +++ les 2 conditions suivantes doivent être remplies sinon MySQL refusera de se lancer

• ​le dossier /Users/votrenomdutilisateur/Documents/Rufus existe
• ce dossier est accessible à n'importe quel utilisateur - pour cela,  dans le terminal​​, vous devez avoir entré la commande 

​sudo chmod -R 766 /Users/votrenomdutilisateur/Documents

• ​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/votrenomdutilisateur/Documents/Rufus/

6. Partage du dossier d'imagerie sur le réseau

• Vous devez indiquer au serveur que le dossier d'archivage de l'imagerie doit être partagé sur le réseau afin que les autres ordinateurs du réseau ainsi que les appareils d'imagerie puissent écrire et lire les documents d'imagerie. Il s'agit donc encore une fois du dossier 

/Users/votrenomdutilisateur/Documents/Rufus/

• Cliquez sur Pomme/Préférences système
• Ouvrez Partage
• ​Dans la colonne de gauche, cochez la case Partage de fichiers
• ​Dans la colonne du milieu, cliquez sur plus et dans la fenêtre qui s'affiche, choisir le dossier /Users/votrenomdutilisateur/Documents/Rufus/
• Cliquez ensuite sur le bouton Options et cocher la case partager les fichiers et les dossiers via SMB

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

• sql_mode = STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

règle certains paramètres d'accès aux tables

• max_allowed_packet = 8M

Rufus stocke de façon provisoire les images avant de les enregistrer sur le disque.
Ce paramètre définit la taille maximale des images stockées dans la base Rufus.
Vous pouvez le modifier si vous envisagez de stocker des images de taille plus importantes mais cela alourdit la taille des tables

• ​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...)

​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