Fichiers de configuration

La configuration d'un simulateur se fait par des fichiers ini.

Ordre de chargement des fichiers .ini :

  1. OpenSimDefaults.ini
  2. OpenSim.ini
  3. Tous les fichiers *.ini se trouvant dans le dossier "addons-modules/*/config/"
  4. GridHypergrid.ini
  5. GridCommon.ini
  6. FlotsamCache.ini

Note: les parametres peuvent être écrits dans n'importe lequel de ces fichiers de configuration (éviter d'écrire dans OpenSimDefaults.ini et GridHypergrid.ini) et selon leur ordre de chargement, la dernière valeur écrase la précédente (par exemple, si on active les npc dans OpenSim.ini et qu'on les désactive dans GridCommon.ini, ils seront désactivés car GridCommon.ini est chargé apres OpenSim.ini).

Description des fichiers de configuration

OpenSimDefaults.ini

Ce fichier contient tous les réglages par défaut de OpenSimulator. Les développeurs recommandent de ne surtout pas y toucher.

OpenSim.ini

Ce fichier contient tous les réglages personnalisés du simulateur.

Addons-modules/*/config

Ces fichiers concernent les réglages tous les modules de région optionnels.

GridHypergrid.ini

Ce fichier contient tous les réglages par défaut concernant la connexion d'un simulateur sur une grille. Les développeurs recommandent de ne surtout pas y toucher.

GridCommon.ini

Ce fichier contient tous les réglages personnalisés concernant la grille sur laquelle le simulateur va se connecter.

FlotsamCache.ini

Ce fichier contient tous les réglages personnalisés du système de cache par défaut.

Anatomie des fichiers de configuration

Les fichiers de configuration sont organisés sous forme de "sections".
Une section est un ensemble de parametres et commence par un nom entouré de crochers (exemple : [Network] )

Chaque paramètre est forcément dans la section correspondante.
Si on modifie un parametre dans un fichier sans le mettre dans la bonne section, il ne sera pas pris en compte.

Recommandations pour plusieurs simulateurs

Si on héberge plusieurs simulateurs sur le même serveur, il est possible d'utiliser des paramètres communs pour tous les simulateurs.

Voici ce que nous recommandons :

  • Ne pas toucher au OpenSimDefaults.ini
  • Faire un alias du fichier ini commun dans un dossier quelconque de addon-modules (exemple : addon-modules/francogrid/config/francogrid.ini )
  • Ajouter les paramètres communs à tous les simulateurs dans ce fichier
  • Mettre seulement les paramètres concernant le simulateur dans OpenSim.ini

Vous trouverez dans les "pages en relation" des exemples de fichiers de configuration recommandés par FrancoGrid.

Normalement, seul le GridCommon.ini est nécéssaire.