OpenSimulator · FR

Installation Standalone de A à Z

Une première région et un premier avatar, avec le minimum de services à maintenir.

Parcours pédagogique pour OpenSimulator 0.9.3.1 / .NET 8. Adaptez les domaines, les secrets, les versions et les ports à votre installation. Vérifiez toujours les sources avant la production.

À qui s'adresse ce parcours ?

Choisissez Standalone pour tester OpenSimulator, accueillir un petit monde indépendant ou apprendre les réglages sans ROBUST séparé. Pour plusieurs simulateurs hébergeant une même grille, préférez l'architecture Grid.

Installation de base

Suivez d'abord le chapitre « Commencer ici » pour les prérequis .NET 8 et la compilation. Travaillez sur la copie bin produite par la compilation, sous un compte sans privilège. Sauvegardez les fichiers .ini avant chaque modification.

Copier les deux modèles requis

Les instructions de BUILDING.md demandent de créer OpenSim.ini à partir de OpenSim.ini.example et StandaloneCommon.ini à partir de son modèle. Vérifiez l'absence de ces fichiers avant de copier pour ne pas écraser une installation existante.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

cd bin
test ! -e OpenSim.ini && cp OpenSim.ini.example OpenSim.ini
test ! -e config-include/StandaloneCommon.ini && cp config-include/StandaloneCommon.ini.example config-include/StandaloneCommon.ini

Sélectionner Standalone

Dans [Architecture] de OpenSim.ini, une seule ligne Include-Architecture doit être active. Choisissez Standalone.ini sans Hypergrid pour la première installation. Si vous voulez Hypergrid, utilisez le modèle StandaloneHypergrid.ini et vérifiez les exigences réseau.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

[Architecture]
Include-Architecture = "config-include/Standalone.ini"

SQLite pour commencer

Le modèle StandaloneCommon.ini.example indique SQLite comme configuration de stockage initiale. Cela permet un premier démarrage sans compte MySQL supplémentaire. MySQL peut être choisi ensuite pour des besoins d'exploitation, mais la migration des données exige une procédure distincte.

Option : MySQL, pas obligatoire

Si vous choisissez MySQL dès le départ, créez une base dédiée et un compte à droits limités ; configurez StorageProvider et ConnectionString dans la section [DatabaseService] du fichier StandaloneCommon.ini réellement chargé. Vérifiez la compatibilité du mode d'authentification avec votre client MySQL. Ne copiez jamais un mot de passe de documentation en production.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

[DatabaseService]
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=REPLACE_WITH_PRIVATE_SECRET;Old Guids=true;"

Ports, accès et DNS

Pour un premier test sur la même machine, l'exemple du dépôt utilise l'URI de connexion locale sur le port 9000. Si un avatar doit se connecter depuis l'extérieur, les adresses annoncées par la région et les ports TCP/UDP réellement utilisés doivent être accessibles ; ne confondez pas IP de liaison interne et IP externe.

Premier démarrage interactif

Démarrez OpenSim depuis bin. Le logiciel peut demander nom de région, coordonnées, port, domaine, puis propriétaire du domaine. Conservez en lieu sûr les identifiants du propriétaire. Ne forcez pas des valeurs publiques tant que DNS et pare-feu ne sont pas prêts.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

cd bin
./opensim.sh

Vérifier la console

Un prompt du type Region (nom de région) # indique que la boucle de démarrage est arrivée à la console. Ce n'est pas encore une preuve qu'un client externe pourra se connecter : vérifiez l'URI et les logs puis passez au guide de première connexion.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

help
show region
stats show

Faire évoluer son monde

Pour une migration vers Grid, ne vous contentez pas de changer Include-Architecture : cela modifie l'emplacement des services et bases de données. Planifiez sauvegardes OAR, IAR, comptes utilisateurs, assets, régions et retour arrière.

Étapes suivantes et références

Passer de Standalone à Standalone Hypergrid