OpenSimulator · FR

Fichiers INI : lecture et priorité

Comprendre exactement d’où vient une valeur dans OpenSimulator et comment la modifier sans casser les services.

Reconnaître une section

Une ligne entre crochets ouvre une section. Les paramètres suivants appartiennent à cette section jusqu’à la prochaine ligne entre crochets. Deux sections différentes peuvent contenir une clé de même nom sans contrôler la même fonction.

Exemple : adaptez les chemins et valeurs à votre installation.

[Startup]
physics = ubODE

[Const]
BaseHostname = "127.0.0.1"

Commentaires et valeurs actives

Dans les exemples fournis, un point-virgule commente une ligne. La présence d’une option précédée de ; ne signifie donc pas que cette option est active. Pour modifier un réglage, retirez le point-virgule de la ligne pertinente.

Exemple : adaptez les chemins et valeurs à votre installation.

; physics = BulletSim
physics = ubODE

OpenSimDefaults.ini

Ce fichier fournit des paramètres de base. Évitez d’y placer des personnalisations propres à votre serveur : elles risquent d’être écrasées lors des mises à jour. Préférez un fichier prévu pour vos surcharges.

OpenSim.ini.example et OpenSim.ini

Le suffixe .example indique un modèle. Pour une installation depuis les sources, copiez le modèle OpenSim.ini.example sous le nom OpenSim.ini, puis adaptez notamment [Const] et [Architecture] à l’architecture choisie.

[Const] et substitutions

La section [Const] permet de définir un nom de domaine ou une URL de base réutilisable dans d’autres paramètres avec la syntaxe ${Const|Name}. Elle facilite la maintenance, mais une valeur erronée peut affecter plusieurs services simultanément.

Exemple : adaptez les chemins et valeurs à votre installation.

[Const]
BaseHostname = "127.0.0.1"
BaseURL = "http://${Const|BaseHostname}"

[Architecture] et fichiers inclus

Le mode de déploiement du simulateur dépend de ses fichiers d’architecture. Les modèles GridCommon.ini et StandaloneCommon.ini correspondent à des architectures différentes : vérifiez les services et ports attendus avant de les copier.

Surcharges personnelles dans bin/config/

Le dossier de fichiers supplémentaires peut contenir vos personnalisations. Une clé peut être présente dans plusieurs fichiers ; la valeur finale dépend de l’ordre réel du chargement, et pas uniquement de leur emplacement apparent.

Vérifier avec config show

La commande de console config show affiche les paramètres agrégés. Elle permet de voir si la valeur désirée a réellement été chargée et aide à débusquer une surcharge oubliée.

Exemple : adaptez les chemins et valeurs à votre installation.

config show

ROBUST n’est pas un simulateur

ROBUST dispose d’une configuration distincte, couramment Robust.ini ou Robust.HG.ini, et d’un mécanisme de fichiers modulaires configurable. Ne copiez pas mécaniquement des sections de région dans ROBUST.

Paramètres sensibles

Les mots de passe SQL, les clés de services, les URL internes et les jetons ne doivent pas apparaître dans un dépôt public ou une capture d’écran. Les exemples du site sont fictifs, pas des valeurs à utiliser en production.

Procédure de modification sûre

1. Sauvegardez le fichier. 2. Notez la section et la valeur courante. 3. Vérifiez les surcharges. 4. Changez un seul réglage. 5. Redémarrez uniquement si nécessaire. 6. Contrôlez les journaux et config show. 7. Revenez à l’ancienne valeur si le changement n’a pas l’effet attendu.

Références et code source