Konfiguration der Datei OpenSim.ini

In der OpenSim.ini können wirklich sehr viele Einstellungen verändert werden, es ist die umfangreichste Konfigurationsdatei. Als Basis kann die Beispieldatei „OpenSim.ini.example“ genommen werden, die mit OpenSim Arriba mitgeliefert wird.

Wichtiger Hinweis: Setze dich für die korrekte Konfiguration unbedingt mit den Admins des jeweiligen Grids in Verbindung, denn OpenSim 0.8 oder Arriba wird nur noch sehr selten verwendet! Jetzt wird trotzdem durch die Datei gehechelt, um etwas zu lernen…

Wir beginnen mit den notwendigen Einstellungen, später kommen dann noch einige interessante optionale Zusatzeinstellungen.

In OpenSim Arriba ist die Physikengine „BulletSim“ als Default eingestellt. Die alte Original-ODE ist heute nicht mehr empfehlenswert. Webadressen, die sich an vielen Stellen wiederholen, können als Konstanten vorbelegt werden, wovon hier in der Anleitung Gebrauch gemacht wird. Die URL und Ports (mit „http://“) werden vom Grid vorgegeben.

[Const]
  BaseURL = "http://example-grid.org"
  PrivateBaseURL = "${Const|BaseURL}"
  PublicPort = 8002
  PrivatePort = 8003

Nun folgt der TCP-Port von OpenSim. Bitte verwechselt das nicht mit den UDP-Ports der Regionen! Es kann eine Region durchaus die selbe Portnummer haben, weil TCP und UDP verschiedene Protokolle sind und sich gegenseitig nicht stören. Default ist 9000. Wenn mehrere Instanzen von OpenSim mit der selben IP-Adresse betrieben werden, dann müssen die Programme unterschiedliche TCP-Ports verwenden (und sowieso jede Region einen eindeutigen UDP-Port).

[Network]
  ; http_listener_port = 9000

Nur erforderlich, wenn Scripte auf den Regionen als Webserver agieren: Die Funktion llRequestURL benötigt hier die von extern erreichbare Webadresse oder Domain (ohne „http://“). Wenn das Feature nicht benötigt wird, setze hier zur Sicherheit die nur lokal erreichbare „127.0.0.1“.

[Network]
  ExternalHostNameForLSL = "127.0.0.1"
  ; ExternalHostNameForLSL = "my.external.domain.or.ipv4.address"

Zum Senden und Empfangen von IMs müssen URLs für das gewählte Grid eingetragen werden, je nach Grid müssen zusätzlich noch Module aktiviert werden. Leider gibt es inzwischen so einige Kombinationsmöglichkeiten von Modulen, so dass im Zweifel die Konfiguration des gewählten Grids erfragt werden muss!

[Messaging]
  ;; Benutze nur ein Message-Modul passend zum ausgewählten Grid!
  OfflineMessageModule = "Offline Message Module V2"
  OfflineMessageURL = "${Const|BaseURL}"

  ;; Benutze nur ein Mutelisten-Modul passend zum ausgewählten Grid!
  MuteListModule = "MuteListModule"
  MuteListURL = "${Const|BaseURL}"

DataSnapshot sorgt zusammen mit Search dafür, dass Objekte auf dem Land für die Suche markiert werden können. Auch hier muss der genaue Pfad in der URL für das gewählte Grid passend gemacht werden. Mit index_sims wird das Feature eingeschaltet. Wenn auf dem Server die Suche nach Objekten aktiviert ist, muss zyklisch das Land durchsucht und eine Objektliste ans Grid übertragen werden. Aus Performancegründen wird empfohlen, das Übertragungsintervall von 20 Minuten auf 10 Stunden zu erhöhen.

Hinweis: Wenn auf den Regionen keinerlei Vendoren oder kopierbare Objekte stehen, dann kann auch „index_sims = false“ gesetzt werden (was der Defaultwert ist). Dann werden keine Objekte „beworben“, wo versehentlich bei den Berechtigungen der Copy-Haken gesetzt ist – aber eben auch sonst keine Objekte.

[DataSnapshot]
  index_sims = true
  default_snapshot_period = 36000
  gridname = "Example Grid"
  data_services = "${Const|BaseURL}/register.php"

Nur für Voice-Chat erforderlich: Aktuelle Viewer unterstützen ohne Modifikation des Programmcodes weder Mumble noch FreeSwitch. Die Firma Vivox, die u.a. den Voice-Service für Second Life betreibt, schloss seit Anfang 2012 unkompliziert Verträge mit OpenSim Serverbetreibern ab. Leider sind keine Neuverträge mehr möglich. (Default ist „enabled = false“.)

[VivoxVoice]
  ; enabled = true
  ; vivox_server = www.foobar.vivox.com
  ; vivox_sip_uri = foobar.vivox.com
  ; vivox_admin_user = DeepThroat
  ; vivox_admin_password = VoiceG4te

Hier wird die Gruppenfunktion eingeschaltet und das passende Modul aktiviert. Außerdem muss wieder die richtige URL für das gewählte Grid eingetragen werden.

[Groups]
  ;; Beispiel für Grids, die "GroupsModule V2", "Groups HG Service
  ;; Connector" und "Groups Messaging Module V2" verwenden.
  ; Enabled = true
  ; Module = "Groups Module V2"
  ; ServicesConnectorModule = "Groups HG Service Connector"
  ; LocalService = remote
  ; GroupsServerURI = "${Const|PrivateBaseURL}:${Const|PrivatePort}/groups"
  ; GroupsExternalURI = "${Const|BaseURL}:${Const|PublicPort}/groups"
  ; MessagingModule = "Groups Messaging Module V2"

  ;; Beispiel für "GroupsModule", "XmlRpcGroupsServicesConnector"
  ;; und "Groups Messaging Module".
  ; Enabled = true
  ; Module = GroupsModule
  ; ServicesConnectorModule = "XmlRpcGroupsServicesConnector"
  ; GroupsServerURI = "${Const|BaseURL}/xmlrpc.php"
  ; MessagingModule = GroupsMessagingModule

NPC sind scriptgesteuerte Avatare. Diese Option kann pauschal aktiviert werden, auch wenn sie momentan nicht benötigt wird. Wer sicher ist keine NPC zu benötigen, braucht dies nicht auf „true“ setzen. (Default ist „false“.)

[NPC]
  Enabled = true

Abhängig vom jeweiligen Grid das passende Modul und die passende URL wählen…

;; Beispiel für ein Grid mit UserProfilesModule
[Profile]
  ; Module = "UserProfilesModule"

[UserProfiles]
  ; ProfileServiceURL = "${Const|PrivateBaseURL}:${Const|PrivatePort}/profiles" 

Abhängig vom jeweiligen Grid die passende URL wählen…

[XBakes]
  ; URL = ${Const|BaseURL}/xbakes"

Nur in Grids mit Maptile-Server: URL zur Abfrage von Maptiles aus dem Hypergrid.

[SimulatorFeatures]
  ;; Beispiel für ein Grid mit Maptile-Server
  ; MapTileURL = "${Const|BaseURL}/maptiles"

Passend zur Anleitung muss „GridHypergrid.ini“ gewählt werden, denn hier wird OpenSim an ein Grid angeschlossen und Hypergrid konfiguriert. Andere Architekturen passen nur eingeschränkt zu dieser Anleitung!

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

Das waren die notwendigen Einstellungen. Ein paar Seiten weiter folgen einige Tuning-Tipps.


Weiter: Erstmaliger Start der OpenSim Software

Nach oben