OpenSimulator · FR

MySQL et MariaDB : exploiter la base OpenSimulator

Connexions, InnoDB, sauvegarde, performance et résolution des incidents SQL, sans confondre les services.

Ces procédures illustrent des cas courants d’administration OpenSimulator. Vérifiez les paramètres de votre version et préparez une sauvegarde avant toute modification.

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

Pour aller plus loin

Code source et références