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

-- page mise à jour le 15  janvier 2025 --

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 4 objectifs fondamentaux et un facultatif mais qui simplifie grandement la vie par la suite

1. installer le programme serveur MySQL
2. configurer le serveur MySQL en créant un utilisateur qui aura tous les droits d'administration
3. créer un dossier pointé par la variable secure-file-priv du serveur MySQL et qui servira de stockage aux documents générés par les appareils d'imagerie
4. ​partager ce dossier d'imagerie sur le réseau
5. installer facultativement un gestionnaire graphique de la base de données

Votre version d'Ubuntu doit être égale ou ultérieure à 22.04

Dans ce dossier, la configuration d'un serveur MariaDB est décrite mais on peut parfaitement, en l'adaptant, utiliser un serveur MySQL 8.0.

Ce tutoriel est donc consacré à l'installation du serveur sous Linux Ubuntu.
L'installation du serveur sous Ubuntu est plus complexe que sous Mac et cette page considère que vous avez un minimum de connaissances en informatique, en particulier que vous connaissez le programme Terminal, même si vous ne savez pas très bien l'utiliser.
​
Il est supposé que vous disposez d'une machine sur laquelle Ubuntu Desktop 22.04 LTS vient d'être installé, sans ajout d'autres logiciels. A télécharger ici https://releases.ubuntu.com/focal/
+++ NE PAS UTILISER Ubuntu 20.04 LTS qui présente des problèmes de mise en réseau avec les postes sous macOS
On utilise avec Ubuntu MySQL dans sa version 8.0.36.
On peut aussi utiliser un clone open source de MySQL, MariaDB. La procédure n'est pas décrite sur le site mais la démarche est la même pour la configuration du serveur quoiqu'un peu plus compliquée.

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 (clic droit-Copier pour copier – clic droit-Coller pour coller).
Cette installation, téléchargement de MariaDB non comprise, demande environ 15 minutes.

+++ Quelques précisions

​A plusieurs reprises, le terminal d'Ubuntu 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.

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. Création du dossier d'imagerie

1. A l'aide du terminal, créez un dossier /Users/Shared/Rufus et un dossier Imagerie dans ce dossier Rufus

• ​sudo mkdir -p /Users/Shared/Rufus/Imagerie

2. Donnez les droits d'accès à votre dossier /Users/Shared à MariaDB/MySQL. Pour cela, dans le terminal, taper

• sudo chmod -R 755 /Users/Shared

3. puis

• sudo chown -R votrenomdutilisateur /Users
  

​​Entrez votre mot de passe et tapez Enter
Explication: ce dossier (Users/Shared/ (sous MacOS et Linux - C:\Users\Public sous Windows) est  essentiel au fonctionnement de Rufus et existe par défaut sous MacOS ou Windows mais pas sous Linux. Il faut donc le créer et donner à MySQL ou d'autres programmes le droit d'y accéder avec chmod puis chown

 2. Installation de MariaDB ou MySQL

Installation du serveur
Ouvrez le programme terminal
Tapez la commande
sudo apt-get update
puis
sudo apt-get upgrade
répondez O à la question, l'ordinateur va pédaler un temps certain, puis
sudo apt-get install mysql-server (ou mariadb-server si vous préférez)
répondez O à la question, repédalage...

3. Création du premier utilisateur

• sur un pc classique ou un Mac sous Ubuntu (pas un raspberry)
  • ​démarrer une session MySQL en se connectant comme utilisateur root
    • sudo mysql -u root -p
  • la machine vous demande le mot de passe de l'ordinateur
  • Entrez votre mot de passe administrateur
• ​mysql doit vous accueillir par une confirmation Welcome to the MariaDB monitor... etc... et vous êtes maintenant dans la console MariaDB. Ce qui signifie qu'à partir de maintenant, les commandes que vous entrez dans le Terminal ne sont plus interprétées par Linux mais par MariaDB. Chaque commande  doit se terminer par un point-virgule. Si la commande est correctement exécutée, MariaDB le confirme par le message Query OK... Pour quitter le serveur MariaDB et revenir au terminal, il faudra taper la commande exit.

• ​Créer un nouvel utilisateur avec l'identifiant que vous souhaitez et votre propre mot de passe.

• Dans cet exemple j'ai pris pour login "DrNewUser" et pour mot de passe "newmdp"
  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. cf fenêtre ci-contre ------->>>>>>>>>>>
  ​​Si ces règles ne sont pas respectées, Rufus refusera de démarrer.

create user DrNewUser@localhost identified by 'newmdp';

• donnez lui tous les droits...

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

+++ pour les geeks un peu trop pressés,
​et parce que près de 80% des problèmes d'installation viennent de là.
Si vous oubliez de préciser with grant option dans cette ligne de commande,
Rufus ne pourra pas initialiser correctement la base de données et ne fonctionnera pas
​​parce qu'il ne pourra pas accorder de droits à l'utilisateur Rufus qu'il va créer

• ​quitter la console MariaDB pour revenir à Linux.

exit (sans point virgule)

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

• 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... de MariaDB
• 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' IDENTIFIED BY PASSWORD "un truc cabalistique vraiment très très long" 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;
• ​quitter MySQL

exit

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

4. Configuration du serveur

1. Configuration du fichier /etc/mysql/my.cnf

• ​Si, pour une raison ou pour une autre, vous avez configuré un fichier /etc/mysql/my.cnf dans une installattion précédente, il va falloir le remettre dans son état initial
• Si vous ne l'avez pas modifié, ne faites rien et sautez ce paragraphe pour aller au 2. Configuration du fichier /etc/mysql/mariadb.conf.d/50-server.cnf
• Pour le modifier, tapez la commande

sudo nano /etc/mysql/my.cnf

• Remplacez le contenu du fichier par ces lignes​

Si vous utilisez MariaDB
​[client-server]
​!includedir /etc/mysql/conf.d/
!includedir /etc/mysql/mariadb.conf.d/
​
Si vous utilisez MySQL
!includedir /etc/mysql/conf.d/
!includedir /etc/mysql/mysql.conf.d/
[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 ​​

2. Configuration du fichier /etc/mysql/mariadb.conf.d/50-server.cnf  (uniquement pour MariaDB)

• Vous devez configurer le fichier /etc/mysql/mariadb.conf.d/50-server.cnf
• Ce fichier est le principal fichier de configuration de MariaDB
• Il est divisé en sections, chaque section commençant par son nom entouré de crochets, par exemple [mysqld]
• Tapez la commande 
• ​​sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
• ​dans ce fichier, cherchez la section [mysqld]
• toutes les lignes commençant par # ne sont pas lues par MariaDB et peuvent être effacées
• rajoutez les lignes n'importe où dans cette section

secure_file_priv = /Users/Shared
sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

• vers le milieu, vous trouverez la ligne

bind-address            = 127.0.0.1

• ​remplacer 127.0.0.1 par *

bind-address            = * 

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

Un exemple du contenu du fichier 50-server.cnf convenable pour Rufus
en rouge, les lignes modifiées ou ajoutées

[mysqld]
secure_file_priv = /Users/Shared
sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION
user  = mysql
pid-file  = /run/mysqld/mysqld.pid
socket  = /run/mysqld/mysql.sock
port = 3306
basedir = /usr
datadir = /var/lib/mysql
tmpdir = /tmp
lc-messages-dir = /usr/share/mysql
bind-address = *
query_cache_size = 16M
log_error = /var/log/mysql/error.log
expire_logs_days = 10
character-set-server  = utf8mb4
collation-server = utf8mb4_general_ci

3. Contrôle des modifications

• arrêtez le serveur MySQL puis redémarrez le pour que les modifications que vous venez d'effectuer soient prises en compte

• Il faut recharger maintenant les fichiers de configuration de Mariadb
• arrêter MySQL

sudo systemctl stop mysql

• recharger les fichiers de configuraion

systemctl daemon-reload

• relancer MySQL

sudo systemctl start mysql

• pour vérifier si ce que vous avez modifié est bon,  se reconnecter à MariaDB avec votre nouveau compte pour vérifier qu'il a bien été créé

mysql -u DrNewUser -p

• donner le mdp
• ne fois connecté, taper

show variables like 'secure_file_priv';

• la réponse doit être

/Users/Shared
puis
​ show variables like 'bind_address';

• la réponse doit être

* ou Empty set

• quitter la console MySQL

exit

5. Désactivation de apparmor

Apparmor est un utilitaire de protection des fichiers fourni avec Ubuntu et qui limite l'accès aux fichiers de l'ordinateur par certains programmes, dont MySQL.
Pour ce qui concerne Rufus, Apparmor va bloquer la lecture des fichiers d'imagerie par MySQL.
La lecture des fichiers d'imagerie par MySQL est utilisée par Rufus pour leur affichage par les postes Rufus en accès distant.

• dans le terminal toujours

sudo ln -s /etc/apparmor.d/usr.sbin.mysqld /etc/apparmor.d/disable/

• puis

sudo apparmor_parser -R /etc/apparmor.d/usr.sbin.mysqld

• vérifiez

sudo aa-status

• la section "processes are in enforce mode" de la réponse
  

5 processes are in enforce mode.
   /sbin/dhclient (781)
   /usr/sbin/cups-browsed (28060)
   /usr/sbin/cupsd (27833)
   /usr/sbin/cupsd (27878)
   /usr/sbin/cupsd (28075)
​ne doit pas contenir le terme mysql

6. Ouverture du port 3306 du firewall

• dans le terminal toujours

sudo ufw allow 3306

• puis

sudo service ufw restart

7. Installation et configuration de samba

​Samba permet aux autres ordinateurs du réseau d'enregistrer directement sur le serveur les images qu'ils produisent (RNM, OCT, courriers scannés...etc...)Samba permet aux autres ordinateurs du réseau d'enregistrer directement sur le serveur les images qu'ils produisent (RNM, OCT, courriers scannés...etc...)

Installer samba
dans le terminal toujours
sudo apt-get install samba
on crée un nom d'utilisateur et son mot de passe. On peut reprendre son login et son mdp Ubuntu
sudo smbpasswd -a lenomdutilisateurquevousvoulez
entrez et confirmez le mot de passe samba que vous voulez

Créer le partage

• En mode texte, dans le terminal, modifiez directement le fichier de configuration de samba
  • éditez le fichier de configuration
    • sudo nano /etc/samba/smb.conf
  • dans la partie [homes]. Si vous souhaitez pouvoir écrire (envoyer des fichiers) et naviguer dans les dossiers utilistateurs, vérifiez bien que le fichier contient les lignes:
    • read only = no
    • browseable = yes
  • en bas du fichier, rajouter les lignes. Ces lignes permettent de signaler à la machine de partager le dossier /Users/Shared/Rufus/Imagerie afin qu'il soit visible par les autres ordinateurs du réseau
    
    • [imagerie]
    • comment= Imagerie
    • path = /Users/Shared/Rufus/Imagerie
    • create mask = 0755
    • directory mask = 0755​
    • read only = no
    • browseable = yes
  • fermez le fichier en le sauvegardant

• Autre méthode, plus rapide mais ne marche pas sous Ubuntu 20.04 et aleatoirement sous 22.04
  •  ouvrir le gestionnaire de fichiers (Nautilus), se rendre dans le dossier /Documents/Rufus
  • Dans la partie droite de la fenêtre, clic droit sur le dossier Imagerie, choisir Propriétés
  • Dans la fenêtre qui apparaît, choisir onglet Partage de réseau local
  • cocher les cases
    • Partager ce dossier
    • Permettre à d'autres de créer et supprimer des fichiers dans ce dossier
  • cliquer sur Créer le partage
  • Dans la fenêtre qui suit, cliquer sur Ajouter les permissions automatiquement
  • Nautilus, le gestionnaire de fichier, présente un bug sur certains ordinateurs et n'arrive parfois pas à créer les partages. Si c'est le cas et que Nautilus vous renvoie un message d'erreur cabalistique, vous pouvez essayer de créer le partage dans le terminal de la façon suivante

• Autre méthode, en mode texte, dans le terminal, entrez la ligne de commande suivante​
  • ​net usershare add DossierEchange /Users/Shared/Rufus/Imagerie  votrenomdutilisateursamba:F guest_ok=n
    • où
      • DossierEchange représente le nom du dossier partagé tel qu'il apparaîtra pour les autres ordinateurs du réseau
      • /home/votrenomdutilisateur/Documents/Rufus/Imagerie/DossierEchange représente le chemin vers le dossier partagé
      • votrenomdutilisateursamba est votre nom d'utilisateur Samba que vous avez défini par la commande smbpasswd

• redémarrez samba
  • sudo /etc/init.d/smbd restart
    

FACULTATIF - Autoriser les protocoles Samba pour les anciens appareils NIDEK (ne marche plus avec les dernières versions de Samba - demandez une mise à jour du code de votre appareil à Nidek - c'est parfois possible)

• Pour pouvoir permettre aux premiers appareils de réfraction Nidek qui le permettent (ARK1..., TonorefIII...etc...) d'enregistrer leurs mesures sur un dossier du serveur par le biais du réseau, il vous faut autoriser le protocole SMB1, aujourd'hui obsolète et désactivé par défaut. Pour cela, modifiez la section [global] du fichier smb.conf.
  • ​éditez le fichier de configuration smb.conf
    • sudo nano /etc/samba/smb.conf
  • dans la partie [global], rajoutez la ligne suivante :
    • server min protocol = NT1
      
  • fermez le fichier en le sauvegardant et redémarrez samba
    • sudo service smbd restart
      
• Cette manip ne fonctionne pas avec les dernières versions de Samba et dans ce cas, mieux vaut connecter son appareil par le port COM qui fonctionne parfaitement.

8. Rendre le serveur visible sur le réseau pour les ordinateurs Windows

A partir de la version 20.04 d'Ubuntu, les PC sous Windows ne voient pas les dossiers partagé par les PC sous Ubuntu.
Pour rendre ces dossiers visibles depuis un PC Windows du réseau, sur le terminal du serveur Ubuntu, entrer la commande
sudo apt install wsdd

9. Facultatif mais ô combien pratique - installation de Mysql-Workbench

• Démarrez le centre d'applications en cliquant sur son icône dans la barre latérale
  

• Le gestionnaires d'applications s'ouvre dans la barre de recherche en haut de la fenêtre
  
• Rechercher MySQL Workbench
  
• Cliquer sur Installer
  

10. Au secours! Je suis perdu et rien ne marche

Bon, rien ne marche.
Vous n'arrivez plus à vous connecter et recevez des messages d'erreur cabalistiques.
Vous avez très probablement fait une erreur dans la procédure d'installation.
Le mieux est de tout reprendre à zéro et de désinstaller totalement MariaDB.
Pour cela , dans le terminal, détruisez toutes les traces de MariaDB
sudo apt-get remove --purge  mariadb* (ou mysql*)
Le programme vous proposera de détruire toutes les données MySQL ou MariaDB existant sur le disque de l'ordinateur. Acceptez
sudo apt autoremove
puis
sudo apt autoclean
Vous pouvez reprendre la procédure d'installation en suivant les paragraphes 2, 3 et 4
2. Installation de MariaDB ou MySQL
3. Création du premier utilisateur
4. Configuration du serveur

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