Installation Standalone de A à Z
Une première région et un premier avatar, avec le minimum de services à maintenir.
À 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.