Cours MariaDB / Installer MariaDB sous Ubuntu et démarrer le serveur
Sur Ubuntu, installez MariaDB Server et son client avec APT, puis vérifiez le service et une connexion administrateur. Une installation neuve utilise généralement l’authentification par socket Unix pour l’administration locale : la procédure ci-dessous ne demande donc pas de créer systématiquement un mot de passe MariaDB pour root.
Vérifier Ubuntu et rechercher une installation existante
Les commandes de ce guide concernent une nouvelle instance d’apprentissage sur Ubuntu 24.04 LTS, avec systemd, un accès aux dépôts et un compte du système autorisé à utiliser sudo. Un conteneur minimal ou un environnement sans systemd ne suit pas nécessairement cette procédure de gestion du service. Si vous utilisez Windows directement, suivez plutôt le guide d’installation MariaDB avec le MSI Windows.
Avant d’installer un paquet, identifiez le système, le programme client éventuel et le service :
cat /etc/os-release
command -v mariadb
systemctl status mariadb --no-pager
cat /etc/os-release affiche les informations de la distribution. command -v mariadb recherche le client dans le chemin des commandes. systemctl status consulte l’état du service. Sur une machine neuve, une commande introuvable ou une unité absente est normale ; cela ne signifie pas qu’il faut supprimer des fichiers.
Si un serveur existe déjà, examinez son usage, ses données et sa configuration avant de continuer. Une installation en production n’est pas un environnement d’exercice vide. Le rôle du serveur et du client MariaDB permet aussi de comprendre qu’un client présent ne prouve pas qu’un serveur local est installé ou démarré.
Installer les paquets de la distribution et contrôler le service
Dans le terminal Ubuntu, actualisez les informations des dépôts, consultez le paquet proposé, puis demandez l’installation du serveur et du client :
sudo apt update
apt-cache policy mariadb-server
sudo apt install mariadb-server mariadb-client
apt update actualise les listes de paquets ; cette commande n’effectue pas à elle seule une mise à niveau de tout le système. apt-cache policy mariadb-server indique notamment la version candidate et les dépôts qui la fournissent. Lisez cette sortie avant de poursuivre : une version candidate absente demande de vérifier les dépôts configurés et le succès de l’actualisation.
La version des paquets Ubuntu peut différer de celle du téléchargement fourni par MariaDB. Il n’est pas nécessaire d’ajouter un dépôt tiers pour effectuer les premiers exercices SQL. La fiche du paquet MariaDB Server pour Ubuntu 24.04 LTS identifie le paquet de la distribution, et le guide officiel d’installation de MariaDB présente les méthodes disponibles.
Lisez la liste des paquets ajoutés ou modifiés avant de confirmer l’installation. La présence d’une dépendance liée à Galera ne signifie pas que vous devez configurer un cluster. Après l’installation, distinguez la version du client, l’état actuel du service et son démarrage automatique :
mariadb --version
systemctl is-active mariadb
systemctl is-enabled mariadb
| Contrôle | Ce qu’il permet de conclure |
|---|---|
mariadb --version |
Le programme client est accessible et indique sa version ; ce n’est pas la version d’un serveur auquel il serait connecté. |
systemctl is-active mariadb |
La réponse active signifie que le service fonctionne maintenant. |
systemctl is-enabled mariadb |
La réponse enabled indique que l’unité est activée pour le démarrage automatique. |
Un service peut fonctionner sans être activé au démarrage, ou être activé tout en étant actuellement arrêté. Si le nouveau service d’apprentissage est arrêté, démarrez-le :
sudo systemctl start mariadb
Pour qu’il démarre automatiquement après le redémarrage de la machine, activez-le explicitement :
sudo systemctl enable mariadb
Relisez ensuite les états avec les commandes de contrôle précédentes. En cas d’échec du démarrage, consultez les journaux avant de modifier les comptes : une erreur de service et un refus d’authentification sont deux problèmes différents.
Ouvrir une connexion administrateur par socket local
Dans l’installation neuve décrite ici, connectez-vous par le socket Unix local avec les droits d’administration du système :
sudo mariadb --protocol=socket
Le mot de passe éventuellement demandé par sudo est celui qui autorise l’élévation des droits du système, selon sa configuration. Ce n’est pas une demande de mot de passe MariaDB produite par l’option --password. Lorsque l’invite MariaDB apparaît, saisissez les instructions SQL suivantes dans le client :
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user, CURRENT_USER() AS privilege_account;
SELECT 1 + 1 AS result;
La première sortie donne la version du serveur réellement connecté. La deuxième permet de distinguer l’identité de connexion, affichée par USER(), du compte retenu pour les privilèges, affiché par CURRENT_USER(). Dans une connexion d’administration locale neuve de ce type, le compte de privilèges est normalement root@localhost. La dernière requête doit renvoyer 2.
Avec l’authentification unix_socket, MariaDB s’appuie sur l’identité du processus du système connecté par le socket. Un accès réussi avec sudo mariadb ne prouve donc pas qu’un mot de passe vide pour root serait accepté par TCP. L’adresse 127.0.0.1 et un fichier socket désignent des chemins de connexion différents.
La documentation du plugin unix_socket décrit ce mécanisme, et la présentation de l’authentification depuis MariaDB 10.4 explique les comptes et les méthodes possibles. Une installation existante peut être configurée autrement. Ne réinitialisez pas une méthode administrateur connue uniquement pour reproduire le fonctionnement du guide Windows.
Évaluer les questions de configuration de sécurité facultatives
Quittez le client avec EXIT; avant de lancer l’utilitaire suivant dans le terminal du système :
sudo mariadb-secure-installation
Cet utilitaire propose des opérations de nettoyage initial. Il ne faut pas répondre automatiquement « oui » à toutes ses questions. Leur ordre et leur libellé peuvent varier selon le paquet et la version ; préservez en particulier la méthode d’administration que vous venez de vérifier.
| Question ou opération | Critère de décision |
|---|---|
| Mot de passe root actuel | Une installation neuve avec authentification par socket peut ne pas avoir de mot de passe root à saisir. |
| Passer à l’authentification par socket | Vérifiez si cette méthode est déjà utilisée avant de la modifier. |
| Modifier le mot de passe root | Ne remplacez pas une authentification fonctionnelle sans besoin identifié. |
| Supprimer les comptes anonymes | Approprié sur une nouvelle instance d’exercice qui n’en a pas besoin. |
| Interdire root à distance | Conservez l’administration locale pour cet exercice. |
| Supprimer la base de test | Ne supprimez que la base d’installation inutilisée concernée par la question ; ce n’est pas shopcourse. |
La référence de mariadb-secure-installation précise que plusieurs raisons historiques d’utiliser le script ne s’appliquent plus de la même façon avec l’authentification par socket. L’outil est facultatif dans cette démarche ; comprendre l’instance et disposer d’une connexion administrateur fonctionnelle restent les conditions nécessaires avant de créer le compte d’exercice.
Si la machine héberge déjà des bases, évaluez chaque suppression ou changement avant de l’accepter. Après une modification, reconnectez-vous par la méthode prévue et vérifiez de nouveau la version et l’identité du compte. Ne confondez pas une confirmation de nettoyage avec une validation complète de tous les réglages du serveur.
Créer le compte d’exercice TCP et l’utiliser
Reconnectez-vous comme administrateur avec sudo mariadb --protocol=socket. Recherchez d’abord les comptes portant le nom retenu pour les exercices :
SELECT User, Host FROM mysql.user WHERE User = 'course_user';
Sur une nouvelle instance, aucun compte de ce nom n’est attendu. Si une ligne apparaît, inspectez son hôte et son rôle avant de continuer ; ne recréez pas un compte existant à l’aveugle. Pour un nouveau compte du cours, remplacez le texte CHANGE_THIS_TO_YOUR_OWN_PASSWORD par votre propre mot de passe robuste, puis exécutez :
CREATE USER 'course_user'@'127.0.0.1'
IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';
GRANT ALL PRIVILEGES ON shopcourse.*
TO 'course_user'@'127.0.0.1';
SHOW GRANTS FOR 'course_user'@'127.0.0.1';
L’hôte fait partie de l’identité du compte MariaDB. Le compte course_user@127.0.0.1 correspond ici à la connexion TCP explicite qui suit. Un compte de même nom avec un autre hôte ne doit pas être considéré comme équivalent ; ne remplacez pas l’hôte par % pour contourner un refus de connexion.
Le périmètre shopcourse.* autorise les opérations d’apprentissage dans cette base, y compris sa création, sans accorder des privilèges globaux ni le droit de distribuer ces privilèges à d’autres comptes. L’octroi peut être effectué avant que la base existe. Une éventuelle ligne USAGE ON *.* dans SHOW GRANTS ne signifie pas que toutes les bases deviennent accessibles. Ces instructions ne demandent pas de FLUSH PRIVILEGES supplémentaire.
Les références CREATE USER et GRANT détaillent la définition d’un compte et les niveaux de privilèges. Pour une application réelle, choisissez des droits plus limités si son fonctionnement n’exige pas toutes les opérations de ce cours.
Exécutez EXIT;, puis saisissez cette commande dans le terminal Ubuntu :
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
--protocol=tcp choisit TCP, --host=127.0.0.1 vise cette machine et --port=3306 doit correspondre au port de l’instance. L’option --password sans valeur demande le mot de passe du compte d’exercice de façon interactive. Il ne s’agit pas du mot de passe demandé par sudo. Si l’instance utilise un autre port, adaptez la commande.
Dans la nouvelle connexion, vérifiez le compte qui fournit les privilèges :
SELECT CURRENT_USER() AS privilege_account;
La valeur attendue est course_user@127.0.0.1. À partir de ce point, les exercices SQL utilisent ce compte plutôt que root. Si la valeur diffère ou que la connexion est refusée, examinez le compte, son hôte et la commande exacte avant de modifier les autorisations.
Diagnostiquer une erreur et revenir sur un changement de configuration
Si le démarrage échoue, consultez l’état détaillé du service et ses derniers messages de journal :
systemctl status mariadb --no-pager
sudo journalctl -u mariadb -n 80 --no-pager
- Connexion impossible ou refusée : contrôlez le service en cours d’exécution, le port et le chemin de connexion choisi, TCP ou socket.
- Message Access denied : vérifiez l’utilisateur, l’hôte, le mot de passe et la méthode d’authentification. Relancer l’installation ne résout pas nécessairement ce problème.
- Version inattendue : comparez le paquet proposé par APT, la version du client et la sortie de
SELECT VERSION()sur le serveur connecté.
Les fichiers de configuration des paquets se trouvent couramment sous /etc/mysql/mariadb.conf.d/, mais confirmez les fichiers réellement lus par votre installation. Avant de les modifier, sauvegardez le fichier concerné et notez son chemin. Changez un seul réglage, redémarrez uniquement l’instance d’exercice et contrôlez le résultat ; si le démarrage échoue après ce changement, rétablissez le fichier sauvegardé.
Pour arrêter ce service, utilisez sudo systemctl stop mariadb. Pour retirer son activation automatique au démarrage, utilisez sudo systemctl disable mariadb. La première commande agit sur son fonctionnement actuel, la seconde sur son activation ; aucune des deux ne supprime les bases. Purger des paquets ou effacer un répertoire de données n’est pas une réparation ordinaire d’un problème de connexion.




