MySQL et MariaDB : exploiter la base OpenSimulator
Connexions, InnoDB, sauvegarde, performance et résolution des incidents SQL, sans confondre les services.
Cartographier les bases avant toute action
ROBUST héberge généralement les services centraux ; les simulateurs peuvent utiliser leur propre base de région. Certains modules disposent aussi de bases séparées. Relevez les ConnectionString de Robust.ini, GridCommon.ini et modules additionnels, en masquant les secrets. Ne supposez pas que toutes les tables sont dans « opensim ».
Comptes SQL et droits
Utilisez des comptes applicatifs avec droits limités à leurs bases et contrôlez les hôtes autorisés. L'accès de l'application depuis une autre VM implique un hôte SQL et un réseau privé accessibles ; ne publiez pas 3306 sur Internet. Ne copiez jamais les mots de passe exemples des INI.
Exemple à adapter et à vérifier sur une instance de test.
-- Dans le client SQL, remplacez base, hôte et secret : CREATE DATABASE opensim CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'opensim'@'10.0.0.%' IDENTIFIED BY 'SECRET_FORT_A_REMPLACER'; GRANT ALL PRIVILEGES ON opensim.* TO 'opensim'@'10.0.0.%'; -- Vérifiez la compatibilité de la version OpenSimulator avant de choisir charset/collation.
InnoDB et surveillance des ressources
Le cache InnoDB, les connexions et les journaux peuvent influencer fortement la grille. Ajustez la mémoire allouée à MySQL selon la RAM réellement disponible et les autres processus ; n'appliquez pas de taille universelle de buffer pool. Mesurez avant/après et évitez les changements multiples simultanés.
Exemple à adapter et à vérifier sur une instance de test.
SHOW GLOBAL STATUS LIKE 'Threads_connected'; SHOW GLOBAL VARIABLES LIKE 'innodb_buffer_pool_size'; SHOW GLOBAL STATUS LIKE 'Innodb_buffer_pool_reads'; SHOW FULL PROCESSLIST;
Lenteurs SQL et requêtes
Recherchez les temps de réponse élevés et les blocages, puis analysez le plan d'exécution des requêtes concernées. Le slow query log est utile s'il est activé de façon maîtrisée. N'ajoutez pas arbitrairement des index aux tables OpenSimulator : vérifiez migrations et requêtes réellement exécutées.
Exemple à adapter et à vérifier sur une instance de test.
SHOW ENGINE INNODB STATUS; SHOW GLOBAL STATUS LIKE 'Slow_queries'; -- Sur une requête confirmée, analyser : EXPLAIN SELECT * FROM fsassets WHERE id = 'UUID_REEL';
Déconnexion MySQL après un redémarrage
Une connexion perdue peut être signalée dans Robust.log ou OpenSim.log, mais l'échec de reconnexion dépend du client et du module. Vérifiez la chronologie SQL/ROBUST/régions et si chaque composant a réellement récupéré. Un redémarrage des régions peut masquer le problème sans corriger la reconnexion du module.
Exemple à adapter et à vérifier sur une instance de test.
journalctl -u mysql --since '2 hours ago' --no-pager journalctl -u mariadb --since '2 hours ago' --no-pager # Adapter le journal OpenSimulator : grep -nEi 'mysql|database|connection|timeout|exception' /chemin/vers/Robust.log | tail -n 120
Compatibilité MySQL et MariaDB
Les modèles INI du fork mentionnent mysql_native_password pour certains anciens clients MySQL. Cette instruction historique ne doit pas être copiée automatiquement dans les versions récentes de MySQL : l'authentification disponible varie selon le serveur et le connecteur. Vérifiez la combinaison exacte avant toute modification globale.
Sauvegarde cohérente des bases
Une sauvegarde SQL seule ne protège ni FSAssets sur disque ni les régions exportées en OAR. Pour les données InnoDB, mysqldump --single-transaction permet un instantané transactionnel sous certaines conditions ; pour une grille vivante, coordonnez aussi les écritures sur fichiers, configurations et modules tiers. Testez une restauration isolée.
Exemple à adapter et à vérifier sur une instance de test.
# À lancer avec un accès SQL autorisé ; le dossier destination doit exister : mysqldump --single-transaction --routines --triggers --events --databases opensim > /backup/opensim.sql # Vérifier code retour, taille, intégrité et restauration d'essai.
Logs SQL : première source de preuve
Lors d'une erreur de base, confrontez l'horodatage du journal SQL aux logs ROBUST et simulateur. Cherchez refus d'accès, saturation de connexions, timeouts, crash, manque d'espace et reprises après incident. Les noms de service systemd varient entre mysql et mariadb.
Exemple à adapter et à vérifier sur une instance de test.
sudo systemctl status mysql --no-pager sudo journalctl -u mysql --since '1 hour ago' --no-pager # Si le service s'appelle mariadb, adapter les commandes.
Ne pas mélanger métadonnées FSAssets et autres tables
La table fsassets contient les identifiants, hashes et métadonnées, pas les contenus binaires stockés sur le disque. Son nombre de lignes ne correspond pas nécessairement au nombre de fichiers en raison de la déduplication. Les procédures de déplacement et de réparation des fichiers sont détaillées dans le chapitre FSAssets dédié.