move IT Home Base

Installation FreeSwitch

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Nov 2019 10:58:48 +0000

Installation FreeSwitch

Mit FreeSwitch können Sie die Voice-Funktion in OpenSIM nutzen um sich nicht nur über die Tastatur im Chat mit anderen Avataren zu unterhalten, sondern auch über ein Mikrofon mit Ihrer Stimme.

Erste Informationen zu FreeSwitch erhalten Sie auf der offiziellen Webseite: http://www.freeswitch.org

Linux Installation: Suse 32/64-bit

Installation und Konfiguration von Freeswitch für OpenSim unter Linux

Wichtige Links:

FreeSwitch ist eine Kommunikationsplattform die unter MLP 1.1 lizensiert ist. Der Vorteil ist der modulare Aufbau und die SIP-Funktionalität die wir hier nutzen um Voice (Sprachkommunikation) in OpenSim zu integrieren. Die native Unterstützung der gängigen Viewer ist dabei das Schmankerl. Auf die Kompilierung von FreeSwitch werde ich hier nicht näher eingehen da sie ausreichend auf der FreeSwitch Website erläutert wird. Es gibt auch je nach Distribution fertig kompilierte Pakete die sich einfacher installieren lassen. Bitte vorher alle Abhängigkeiten überprüfen damit ein reibungsloses kompilieren möglich ist. Beim installieren von FreeSwitch ist dringend auf folgende Einstellungen zu achten damit es erfolgreich funktioniert:

Herunterladen von Freeswitch

Ich empfehle die svn in folgendes Verzeichnis zu laden:

/opt/scr/

der Ordner scr muss noch angelegt werden da er meistens nicht vorhanden ist.

md scr

dann FreeSwitch herunterladen:

svn checkout http://svn.freeswitch.org/svn/freeswitch/trunk freeswitch

Der Quellcode befindet sich dann in:

/opt/scr/freeswitch

nach der Installation (make install) in:

/opt/freeswitch

Wichtige Schritte

Da FreeSwitch modular aufgebaut ist sind in der Grundkonfiguration nicht alle Module aktiviert. Manche werden auch erst nach der Aktivierung kompiliert. Für den reibungslosen Ablauf brauchen wir zwei dieser Module die nicht automatisch kompiliert werden:

codecs/mod_siren ←– siren 14 Codec (sozusagen die Sprachkomprimierung) xml_int/mod_xml_curl ←– Ein Modul um automatische Konfiguration von FreeSwitch über XML zu ermöglichen.

Nach dem Herunterladen von FreeSwitch und der Vorbereitung der Kompilierung:

./bootstrap.sh ./configure –prefix=/usr/local/freeswitch ←– entspricht dem Pfad der späteren Installierung

muss man diese Module in:

../freeswitch/conf/autoload_configs/modules.conf.xml

aktivieren indem man die „#“ vor den entsprechenden Modulen entfernt.

Danach kann man den Quellcode mit

make make install make sounds-install make moh-install make samples

kompilieren und installieren. Hat das alles soweit erfolgreich funktioniert müssen noch 3 Konfigurationsdateien angepasst werden:

../freeswitch/conf/autoload_configs/modules.conf.xml

Hier müssen die beiden Module die wir gerade kompiliert haben aktiviert werden. Dazu entfernt man einfach die Auskommentierung.

Vorher: <!– „<load module=„mod_xml_curl“/>–> <!– <load module=„mod_siren“/>/>–>

Nachher: <load module=„mod_xml_curl“/> <load module=„mod_siren“/>

Dann müssen wir noch den Codec aktivieren. Dazu müssen wir folgende XML editieren:

../ freeswitch/conf/vars.xml

In dieser XML gibt es eine Zeile

Vorher: <X-PRE-PROCESS cmd=„set“ data=„global_codec_prefs= G722,PCMU,PCMA,GSM“/> dieser fügt bitte folgendes hinzu G7221@32000h,G722

Nachher: <X-PRE-PROCESS cmd=„set“ data=„global_codec_prefs=G7221@32000h,G722,PCMU,PCMA,GSM“/>

Dann nur noch die Anbindung an OpenSim. Dazu editieren wir die XML:

../ freeswitch/conf/autoload_configs/xml_curl.conf.xml

Bitte ersetzt folgendes mit dem kompletten Inhalt und achtet darauf das Ihr die IP Eures OpenSim-Servers an den dafür vorgesehenen Platz einfügt.

Der Port 9000 ist natürlich auch an Eure Sim anzupassen falls dieser vom Standard abweicht. Danach könnt Ihr FreeSwitch starten.

../freeswitch/bin/./freeswitch

Der Freeswitch-Service sollte immer vor dem OpenSim-Service gestartet sein.

OpenSim Konfiguration

Hier müssen wir nur in der OpenSim.ini folgendes ergänzen:

[FreeSwitchVoice] enabled = true ;FreeSwitch server is going to contact us and ask us all ;sorts of things. freeswitch_server_user = freeswitch freeswitch_server_pass = password freeswitch_api_prefix = /api ;The IP address of your opensim voice region freeswitch_service_server = IP_Adresse_des_OpenSimServers ;the port your region is running on freeswitch_service_port = 9000 ;your freewitch IP address freeswitch_realm = IP_Adresse_des_FreeSwitch_Services freeswitch_sip_proxy = IP_Adresse_des_FreeSwitch_Services:5060 freeswitch_attempt_stun = false freeswitch_stun_server = IP_Adresse_des_FreeSwitch_Services freeswitch_echo_server = IP_Adresse_des_FreeSwitch_Services freeswitch_echo_port = 50505 freeswitch_well_known_ip = IP_Adresse_des_FreeSwitch_Services freeswitch_default_timeout = 5000 freeswitch_subscribe_retry = 120

Achtet auch hier bitte auf den Port Eurer Sim ! Danach einfach den OpenSim-Server starten.

WICHTIG

Der Freeswitch-Service ist nur in den aktuellsten Versionen von OpenSim möglich. Achtet darauf das beim starten von OpenSim im CLI ein [FreeSwitchVoice] Eintrag zu sehen ist. Dann nur noch InWorld auf der Region bei den Landeinstellungen Voice aktivieren und dann solltet Ihr diesen putzigen Punkt über dem Kopf sehen und wenn Ihr alleine auf der Region seit eine Warteschleifenmusik hören. Zum testen empfand ich diese als sehr hilfreich. Diese kann man folgendermassen ausschalten:

../ freeswitch/conf/autoload_configs/conference.conf.xml

einfach die Sounds auskommentieren:

[…] <!– File to play if you are alone in the conference –> <!– <param name=„alone-sound“ value=„conference/conf-alone.wav“/> –> […] <!– File to play when you're alone (music on hold)–> <!– <param name=„moh-sound“ value=„$${hold_music}“/> –> <!– File to play when you join the conference –> <!– <param name=„enter-sound“ value=„tone_stream:%(200,0,500,600,700)“/> [^] –> <!– File to play when you leave the conference –> <!– <param name=„exit-sound“ value=„tone_stream:%(500,0,300,200,100,50,25)“/> [^] –> <!– File to play when you ae ejected from the conference –> <!– <param name=„kicked-sound“ value=„conference/conf-kicked.wav“/> –> […]

Natürlich auch an die Firewall denken um die von FreeSwitch benötigten Ports zu öffnen:

Port(s)	Protokoll	Bezeichnung
1719	UDP	H.323 Gatekeeper RAS-Port
1720	TCP	H.323 Call Signalling
3478	UDP	STUN Service, für NAT traversal
3479	UDP	STUN Service, für NAT traversal
5002	TCP	MLP Protocol Server
5003	UDP	Neighborhood Service
5060	UDP & TCP	SIP UAS, für SIP Signalisierung (Standard SIP-Port, für default intern Profil)
5070	UDP & TCP	SIP UAS, für SIP Signalisierung (für default „NAT“ Profil)
5080	UDP & TCP	SIP UAS, für SIP Signalisierung (für default „External“ Profil)
16384-32768	UDP	RTP/RTCP Multimedia Streaming, für Audio/Video Daten in SIP und anderen Protokollen

Linux Installation: Ubuntu 32-bit

1. Vorbereitung

apt-get update

apt-get install -y autoconf automake libtool build-essential subversion libxml2 apt-get install -y libxml2-dev libtiff4 libtiff4-dev php5 php5-cli apt-get install -y php5-common php5-mcrypt php5-mysql php5-gd php5-pgsql php-pear php-db apt-get install -y libmysqlclient15-dev curl sox libssl-dev libncurses5-dev bison apt-get install -y libaudiofile-dev libnewt-dev libcurl4-gnutls-dev apt-get install -y libnet-ssleay-perl openssl ssl-cert libauthen-pam-perl apt-get install -y libio-pty-perl libmd5-perl apt-get install -y libpg-perl libdbd-pg-perl sqlite3 apt-get install -y libsqlite3-dev openssl ssl-cert apt-get install -y libapache2-mod-php5 libmcrypt-dev

mkdir /home/opensim/freeswitch cd /home/opensim/freeswitch

2. FreeSwitch Installation

svn checkout http://svn.freeswitch.org/svn/freeswitch/trunk freeswitch

cd freeswitch cd build cp modules.conf.in modules.conf

vi modules.conf

Suchen Sie die Zeile:

#codecs/mod_siren

und entfernen Sie das # Zeichen.

Suchen Sie die Zeile:

#xml_int/mod_xml_curl

und entfernen Sie das # Zeichen.

Speichern Sie die Datei.

cd .. AUTOCONF=/usr/bin/autoconf ./bootstrap.sh

Warten Sie bis die Operationen abgeschlossen sind, dann weiter mit:

./configure –prefix=/usr/local/freeswitch

Warten Sie wieder bis alles abgeschlossen ist, dann weiter mit:

make

Warten Sie wiederrum bis alles abgeschlossen ist, dann weiter mit:

make install make mod_siren-install

make mod_xml_curl-install make sounds-install

make sounds-install

make moh-install make moh-install

Bitte beachten Sie das die obige Wiederholung des Kommandos kein Fehler ist ! Dann weiter mit:

make samples

3. FreeSwitch Konfiguration für OpenSIM

Wir nehmen bei der folgenden Konfiguration folgendes an. Bei Abweichungen auf Ihrem Computer und Netzwerk müssen Sie entsprechend anders konfigurieren. Dies ist quasi nur ein Beispiel von vielen möglichen Konfigurationen:

der Server ist direkt an das Internet angeschlossen und verfügt über die öffentliche IP-Adresse 192.111.222.33
es gibt keine Firewall die den ein- und ausgehenden Datenfluss irgendwie einschränkt
OpenSIM läuft auf dem TCP-Port 9000 und ist auf demselben Computer installiert wie FreeSwitch

Geben Sie nun folgendes ein:

cd /usr/local/freeswitch/conf/autoload_configs/

vi modules.conf.xml

Suchen Sie die Zeile:

<!– <load module=„mod_xml_curl“/> –>

und ändern Sie diese in:

Suchen Sie die Zeile:

<!–<load module=„mod_siren“/>–>

und ändern Sie diese in:

Speichern Sie die Datei. Weiter mit:

cd /usr/local/freeswitch/conf/autoload_configs

vi xml_curl.conf.xml

Gehen Sie eine Zeile unter diese:

und tauschen die dort noch vorhandene Beispiel-Konfiguration mit Ihrer Konfiguration:

Tauschen Sie die oben verwendete Beispiel IP-Adresse 192.111.222.33 mit Ihrer eigenen öffentlichen IP-Adresse aus. Falls Sie einen anderen Port als den Standard-Port 9000 verwenden, passen Sie auch diesen an den bei Ihnen verwendeten Port an.

Speichern Sie die Datei. Weiter geht es mit:

cd /usr/local/freeswitch/conf/

vi vars.xml

Suchen Sie die Zeile:

<X-PRE-PROCESS cmd=„set“ data=„global_codec_prefs=G722,PCMU,PCMA,GSM“/>

und ändern Sie diese in:

<X-PRE-PROCESS cmd=„set“ data=„global_codec_prefs=G7221@32000h,G722,PCMU,PCMA,GSM“/>

4. Starten von FreeSwitch

screen -S voice

cd /usr/local/freeswitch/bin/ ./freeswitch

Ignorieren Sie die rot markierten Fehlermeldungen und Warnungen. Weiter mit:

[CTRL][A][D]

5. OpenSIM-Konfiguration

Editieren Sie die OpenSIM-Konfigurationsdatei und fügen Sie am Ende der Datei folgende Zeilen ein:

[FreeSwitchVoice]
   enabled = true
   ;FreeSwitch server is going to contact us and ask us all
   ;sorts of things.
   freeswitch_server_user = freeswitch
   freeswitch_server_pass = password
   freeswitch_api_prefix = /api
   ;The  IP address of your opensim voice region
   freeswitch_service_server = IP_Adresse_des_OpenSimServers
   ;the port your region is running on
   freeswitch_service_port = 9000 
   ;your freewitch IP address
   freeswitch_realm = IP_Adresse_des_FreeSwitch_Services
   freeswitch_sip_proxy = IP_Adresse_des_FreeSwitch_Services:5060
   freeswitch_attempt_stun = false
   freeswitch_stun_server = IP_Adresse_des_FreeSwitch_Services
   freeswitch_echo_server = IP_Adresse_des_FreeSwitch_Services
   freeswitch_echo_port = 50505
   freeswitch_well_known_ip = IP_Adresse_des_FreeSwitch_Services
   freeswitch_default_timeout = 5000
   freeswitch_subscribe_retry = 120

Starten Sie jetzt den OpenSIM-Server. Ab diesem Moment ist Voice in OpenSIM grundsätzlich möglich. Um aber Voice nutzen zu können muß in den Estate-Einstellungen und den Region-Einstellungen auch Voice aktiviert werden. Ausserdem müssen die Avatare einen 3D-Viewer ab Version 1.22 oder später benutzen.

Sollte es dennoch nicht funktionieren haben Sie möglicherweise eine zu alte OpenSIM-Server Version. Voice wird derzeit nur in sehr aktuellen Trunk-Versionen unterstützt.

Natürlich auch an die Firewall denken um die von FreeSwitch benötigten Ports zu öffnen:

Port(s)	Protokoll	Bezeichnung
1719	UDP	H.323 Gatekeeper RAS-Port
1720	TCP	H.323 Call Signalling
3478	UDP	STUN Service, für NAT traversal
3479	UDP	STUN Service, für NAT traversal
5002	TCP	MLP Protocol Server
5003	UDP	Neighborhood Service
5060	UDP & TCP	SIP UAS, für SIP Signalisierung (Standard SIP-Port, für default intern Profil)
5070	UDP & TCP	SIP UAS, für SIP Signalisierung (für default „NAT“ Profil)
5080	UDP & TCP	SIP UAS, für SIP Signalisierung (für default „External“ Profil)
16384-32768	UDP	RTP/RTCP Multimedia Streaming, für Audio/Video Daten in SIP und anderen Protokollen

Performance

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Nov 2019 10:58:50 +0000

Performance

Hardwareseitige Performance-Beeinflussungen

Um die Geschwindigkeit des OpenSIM-Servers zu erhöhen sind folgende Punkte mit am wichtigsten:

Viel Arbeitsspeicher (RAM)

Optimal ist DDR2-RAM ab 2 GB, mehr ist auch nicht verkehrt. OpenSIM verbraucht im laufenden Betrieb locker hundert und mehr Megabyte RAM (je nach Konfiguration von OpenSIM), daher ist viel RAM eines der wichtigsten Punkte. Als absoluter Mindestwert kann man kurzzeitig 512 MB RAM verwenden, wesentlich besser läuft es bereits mit 1 GB, optimal ab 2 GB RAM. Es hängt allerdings auch davon ab welches Betriebssystem man einsetzt, denn nicht jedes Betriebssystem verbraucht gleichviel RAM. Da die RAM-Preise momentan sehr niedrig liegen sollte man mit RAM nicht geizen und reinpacken was an freien Slots vorhanden ist.

Schneller Prozessor (CPU)

Am besten leistungsstarke Dual-Core oder Quad-Core Prozessoren ab 2 GHz Taktfrequenz pro Prozessorkern. Die Geschwindigkeit der CPU ist für OpenSIM sehr entscheidend. Als absoluter Mindestwert kann man kurzzeitig eine CPU mit 1 GHz einsetzen, die dann aber im Betrieb möglicherweise extrem ausgelastet sein wird und OpenSIM träge macht. Wesentlich besser sieht es mit doppelt soviel CPU-Power aus. Leistungsstarke Quad-Core Prozessoren wie man Sie in richtigen Servern findet sind für OpenSIM der Idealfall. Allerdings geht das ziemlich auf die Stromrechnung Nicht empfehlenswert sind abgespeckte, leistungsschwache CPU´s wie sie in manchen Notebooks oder billigen PC´s verbaut werden und die auf Stromsparen optimiert worden sind und nicht auf Geschwindigkeit.

Schnelle Festplatte

SCSI-Festplatten mit RAID-5 (ab 3 Stück) haben mehr Datendurchsatz als eine Single-IDE oder SATA-Festplatte. Dazu kommt noch daß viele Consumer-Festplatten die in den PC stecken nicht für den Dauerbetrieb ausgelegt sind. Moderne PC haben aber normalerweise ausreichend Festplatten-Datendurchsatz, sodaß dieser Punkt nicht allzu kritisch ist. Planen Sie bei der Festplattengrösse nicht zu knapp. Wenn OpenSIM auf der selben Festplatten-Partition wie das Betriebssystem installiert ist nehmen Sie mindestens 100 GB, mehr sind nie verkehrt. Wenn Sie den Datendurchsatz steigern möchten, dann installieren Sie die Datenbank von OpenSIM auf einer separaten Festplatte mit eigener Partition, damit gleichzeitig ablaufende Festplattenzugriffe durch das Betriebssystem nicht störende Auswirkungen haben.

Und wo wir schon beim Thema Festplatte sind: regelmäßig Datensicherungen (Backups) machen nicht vergessen ! Totalverlust aller Daten ist immer sehr ärgerlich und lässt sich nur durch konsequentes Datensichern auf externen Medien verhindern. Merke: auch Festplatten können mal kaputtgehen und insbesonders ständig laufende Festplatten wie beim Serverbetrieb mit der OpenSIM-Software, die aber nicht für den Dauerbetrieb ausgelegt sind, verabschieden sich häufig mit einem sehr nachhaltigen Erlebnis.

Wir zählen mittlerweile ganze Stapel von defekten, externen USB-Festplatten die erstens in den Metallgehäusen viel zu schlecht gekühlt waren (wenn man eine Passivkühlung durch das Ableiten der Wärme überhaupt als richtige Kühlung ansehen darf), zweitens oft miserabel konstruierte Controller enthielten die gerne schnell defekt gehen und drittens sich gerne mal nach ein paar Wochen Dauerbetrieb mit einem lauten „Klack“ (Headcrash) für immer verabschiedet haben. Wenn da dann wichtige Datensicherungen drauf waren …

Schnelle Datenbank

Eine mySQL-Datenbank ist SQLite zu bevorzugen. Die Performance der verwendeten Datenbank ist aber erst mit steigender Anzahl der Avatare kritisch, da viele gleichzeitige Operationen ausgeführt werden müssen und eine SQLite-Datenbank damit auch mal gerne überfordert sein kann. Für viele gleichzeitige Datenbankzugriffe ist die kostenlose mySQL-Datenbank am besten geeignet. Wer sich mit mySQL gut auskennt und mehr als die Standard-Konfiguration haben möchte, verwendet die im WWW sehr zahlreich zu lesenden Tricks um aus einer mySQL-Datenbank das maximale Potential herauszuholen. Viele Einstellungen lassen sich sehr einfach in der mySQL-Konfigurationsdatei vornehmen.

Schnelle Internetanbindung

Je mehr Avatare sich auf der eigenen Sim einloggen möchten, umso mehr Internetbandbreite wird benötigt. Kleine Gruppen lassen sich möglicherweise noch auf dem heimischen PC verwalten. Bei grösseren Gruppen wird es nötig werden entweder seinen Server bei einem grossen Hoster mit grosser Internetanbindung unterzustellen, oder einen Root-Server bei einem Hoster zu mieten (Preise ab ca. 80 Euro/Monat). Wer OpenSIM bei sich zuhause betreiben möchte, sollte einen Upstream von mindestens 1 MBit haben, also etwa ADSL mit 16.000 kBit/sec. aufwärts. Je höher der Upstream, desto besser. Ideal und vom Kosten-/Nutzen-Verhältnis am sinnvollsten ist derzeit VDSL mit 50 MBit Downstream und 10 MBit Upstream.

Grafikkarte

Die verwendete Grafikkarte im OpenSIM-Server ist hingegen völlig nebensächlich wenn dieser Computer nur als Server dient und nicht gleichzeitig auf diesem auch noch ein 3D-Viewer zum einloggen ausgeführt wird. Da wir davon ausgehen daß Sie nur einen Server betreiben, gehen wir auf den Punkt Grafikkarte nicht weiter ein.

Softwareseitige Performance-Beeinflussungen

Softwareseitig sind extrem viele, unterschiedliche OpenSIM-Werte an der vom Avatar „gefühlten“ Geschwindigkeit der Sim beteiligt. Hauptsächlich sind dies die Menge der auf einer Sim gleichzeitig eingeloggten Avatare, die auf einer Sim laufenden Scripts und physische Prims, neben einer ganzen Reihe anderer Faktoren.

Performance-Messung Inworld OpenSIM

Mit der Tastenfolge STRG-SHIFT-1 die Statusanzeige einschalten.

Time Dilation: sollte möglichst bei 1.0 liegen (Echtzeitbetrieb). Je niedriger der Wert umso zeitversetzter läuft alles ab. Ab einem Wert von 0.7 wird es extrem träge.

Sim FPS: FPS = Frames per Second (Bilder pro Sekunde). Maximal 45 sind möglich, 30 ist gut, unter 20 ruckelt es heftigst.

Time: sagt genau warum die beiden Werte oben evtl. schlecht sind. Eine Sim erreicht maximal 45 FPS, d.h. pro Frame 1/45 = 22ms Zeit.

Total Frame Time: sollte am besten bei 12 ms, möglichst aber noch unter 22 ms liegen. Steigt die Zeit pro Frame darüber, wird der Frame eben länger, und es kommt zu Lags, Time Dilation sinkt und natürlich analog der Sim FPS-Wert. Die Total Frame Time setzt sich zusammen aus verschiedenen Unterzeiten:

Sim Time (Physics): Wenn jemand tausende von fliegenden physischen Würfeln rezzt, braucht der Simulator irsinnig lange, um das in Havok4 alles zu berechnen, dann geht die Zeit extrem hoch. → Physics Lag
Script Time: sollte möglichst unter 12 ms sein. Wenn sehr viele Scripte laufen und richtig was tun, dann geht diese Zeit hoch. Script-Lag ist tückisch, weil er sich gar nicht so in der Time Dilation und Sim FPS ablesen lässt. Seit Havok4 funktionieren physische Bewegungen trotz Script-Lag oft noch recht gut, aber die Scripte werden sehr langsam. Kann man fast nur an diesem Wert ablesen.
Agent Time: Weiter oben unter Simulator gibts die „Main Agents“. Viele Avatare in der Sim bedeuten hohe Agent Time (viel Lag). Child Agents sind diejenigen die aus einer Nachbar-Region oder Sim theoretischen Sichtkontakt haben. Viele Child Agents stören aber kaum.

Performance-Optimierungen

Wie schon geschildert gibt es Inworld eine Menge Potential die Performance einer Sim zu verbessern. Dazu gehören zum Beispiel:

- animierte Bäume und Pflanzen nur sparsam einsetzen, denn diese verringern die Simulator Framerate (Bilder pro Sekunde) und machen die Sim auch träger (Ping-Wert verschlechtert sich).

- auch Scripte schlucken - je nach Art und Programmierung des Scripts - durch die benötigte Rechenzeit einiges an Performance und sollten nicht übermäßig stark eingesetzt werden.

Fazit

Passende PC für OpenSIM bekommt man ab etwa 300 Euro zu kaufen, z.B. über diesen Online-Shop mit sehr preiswerten Angeboten. Wer zukunftsweisend einkaufen möchte achtet insbesondere auf die verwendete CPU und das RAM und investiert lieber etwas mehr, bekommt dafür aber auch mehr Leistung.

Fehler

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Nov 2019 10:58:48 +0000

Fehler

Nach der Datenbankumstellung von SQLite nach mySQL ging zunächst alles gut, aber nach einem OpenSIM Neustart fingen plötzlich jede Menge unerklärliche Fehler an, deren Ursache unbekannt ist. Ich hab hier mal zusammengetragen welche Fehler bisher aufgefallen sind:

Eingeloggte Avatare werden plötzlich nur noch teilweise, oder gar nicht mehr in der Konsole mit „show users“ angezeigt. Ich vermute, bin aber nicht sicher, das dies die importierten User betrifft die Region-Owner sind und daher in den Region-XML Dateien gespeichert sind und nach der Migration nicht manuell wieder angelegt werden müssen.

Teilweise lässt sich OpenSIM nicht mehr starten und bleibt bei einem Script von XEngine hängen. Hier vermute ich auch die eigentliche Ursache der extrem vielen Programmabstürze von OpenSIM unter Windows. Angefangen hat es damit als ein Avatar ein Script hochlud und startete und sich darauf OpenSIM sofort verabschiedete. Anschliessend konnte sich der Avatar mit seinem Namen nicht mehr einloggen und musste einen neuen Namen annehmen. Das problematische Script aber verblieb im System.

Obwohl komplette Regionen mit „save oar“ gespeichert und mit „load oar“ wieder importiert wurden, fehlen teilweise Texturen.

Ein und diesselbe OpenSIM-Version verhält sich unter Linux komplett anders als unter Windows. Meine Erfahrung ist das eine 1:1 Kopie auf verschiedenen Betriebssystemen mehr Probleme macht als wenn man neu anfangen würde. Was unter Windows noch gut lief schmeisst auf Linux reihenweise Fehlermeldungen.

Mein Fehler war wohl auch daß ich zusammen mit dem Serverumzug auch gleich noch die OpenSIM-Version mit updaten wollte. Erst nach ewig langem suchen in der Konfiguration merkte ich daß eine ganze Reihe von Einstellungen umgestellt worden sind und nun gar nicht mehr passen. Es sind neue Bereiche in der Konfiguration hinzugekommen, andere müssen dafür nun weggelassen werden.

Der Linux-Server weigert sich unerklärlicherweise beharrlich die Startup-Kommandos auszuführen um Hypergrid-Regionen zu verlinken, was unter Windows einwandfrei funktioniert hat. Diese Link-Kommandos werden zwar in der Konsole angezeigt, aber nicht ausgeführt. Ursache unbekannt.

Der Linux-Server zeigt nicht die kompletten Web-Statistiken an. Die Sessions beispielsweise werden nicht angezeigt. Ich denke da wird irgendeine Komponente fehlen. Bisher kann sich dies aber keiner erklären, auch die Entwickler nicht.

OpenSIM unter Linux scheint instabiler als unter Windows XP/Vista/Win7 zu laufen. Beispiel: nach dem Kommando „restart“ trat in der Konsole ein Mono-Fehler auf und der OpenSIM-Serverprozess frierte ein. Nach einem Neustart war OpenSIM nicht mehr zu erreichen und musste neu installiert werden. Beim Beenden von OpenSIM per „quit“ oder „shutdown“ tritt regelmäßig ein Fehler „Application Exception Detected: System.UnhandledExceptionEventArgs“ auf. Dieser Fehler wird vermutlich durch das anschliessende Kommando „backup“ beim beenden von OpenSIM verursacht wo ich vermute das er nicht schnell genug die Daten schreiben kann, denn mit weniger Regionen taucht der Fehler seltener oder gar nicht mehr auf.

Das Kommando „link region“ in der Startup-Datei unter Windows funktioniert, unter Linux merkwürdigerweise nicht mehr.
Die World Map im God-Modus wird unter Linux nicht mehr angezeigt, man muß erst den God-Modus wieder verlassen. Unter Windows hatte das noch einwandfrei funktioniert.
Teilweise Probleme JPEG-Grafiken unter Linux anzuzeigen. In der OpenSIM Server-Konsole gibt es entsprechende Fehlermeldungen dazu. Die Anleitungen die benötigten Module nachzuinstallieren wurden aber penibelst beachtet und eingehalten.
Nach einem Neustart waren plötzlich die Avatare wieder auf Ruth zurückgesetzt, obwohl eine mySQL-Datenbank verwendet wird wo so etwas nicht mehr passieren dürfte.

Generell finde ich der OpenSIM-Betrieb unter Linux hat wesentlich mehr mögliche Fehlerquellen und Fallen als unter Windows, auch wenn ich ansonsten stets Linux als Server-Betriebssystem einsetze und empfehle. Im speziellen Fall OpenSIM unter Linux hab ich da aber eher schlechte Erfahrungen machen müssen, obwohl die Entwickler behaupten das OpenSIM unter Linux am einfachsten wäre. Ich bin der Meinung unter Windows ist es wesentlich einfacher.

Die OpenSIM-Entwickler ändern leider öfters die Konsolen-Kommandos, z.B. fehlen bei einigen Kommandos plötzlich die Bindestriche, bzw. werden einige Kommandos mit, andere ohne Bindestriche geschrieben, was verwirrend ist und die Bedienung unnötig erschwert. Typisches Beispiel: aus dem Kommando „link-region“ wurde „link region“.

Bei der Erstellung neuer Benutzer wird bei der Passworteingabe das eingetippte Passwort nicht angezeigt, erst wenn man es durch die Eingabetaste bestätigt hat (ziemlich sinnlos und fehleranfällig).

Die Reihenfolge der Kommandos unter „help“ ändert sich auch immer wieder, sodass man bei jeder neuen Version suchen und Startscripts evtl. wieder anpassen muß. Das ist eigentlich hausgemachtes Chaos was nicht sein müsste. Neuerdings werden die Kommandos alphabetisch aufgelistet, was viel besser ist.

Nach der Umstellung der Sim-Position von 1000,1000 nach 4400,4400 konnten sich manche Nutzer nicht mehr einloggen, denn die Home-Position hatte sich geändert und die zuletzt gespeicherte Position war auch nicht mehr verfügbar. Zudem gibt es beim Neuanlegen eines OpenSIM-Benutzers die Abfrage wo die Standard-Home-Position sein soll. Logischerweise habe ich da nach der Umstellung der Sim-Position nun stets 4400,4400 statt 1000,1000 eingegeben, was aber zu erheblichen Problemen führte weil sich neue Benutzer nicht einloggen konnten. Tatsächlich muss man weiterhin 1000,1000 eingeben, bzw. die Werte so lassen um keine Fehler zu erzeugen. Logisch ist das nicht gerade, aber so funktioniert es.

Das DOS-Fenster scheint auf den festen Wert von 25 Zeilen (80*25) eingestellt zu sein, denn wenn man das Fenster verlängert bzw. vergrößert und Kommandos in OpenSIM eingibt gibt es ein ziemliches Durcheinander und Zeilen werden einfach überschrieben statt zu scrollen. Man sollte das DOS-Fenster daher vorerst auf dem Standard-Wert 80*25 (80 Zeichen, 25 Zeilen) belassen. Da das DOS-Fenster viel zu klein ist und es fast unmöglich ist in Ruhe Kommandos einzugeben während gerade Avatare eingeloggt sind kann man kaum was von den vorbeirasenden Logs lesen, geschweigedenn die vollständige Liste aller Befehle per „help“ Kommando lesen.

Weiterführende Links zum Thema

OpenSIM-Update

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Nov 2019 10:58:49 +0000

OpenSIM-Update

Update von OpenSIM mit SQLite-Datenbank, Standalone-Modus

Ein Update von OpenSIM geht sehr schnell und wenn man etwas Routine bekommen hat kann man diesen Vorgang sogar etwas automatisieren. Die neuere OpenSIM-Version kann problemlos über die alte Version installiert werden, ohne die alte Version vorher zu deinstallieren. Sie müssen lediglich Ihre Daten wie unten beschrieben vorher sichern und diese anschliessend wieder zurückspielen. Machen Sie die einzelnen Update-Schritte um Ihr OpenSIM upzudaten:

Falls der OpenSIM-Serverprozess OpenSim.exe gerade läuft muss dieser zuerst mit dem Kommando „quit“ oder „shutdown“ beendet werden.
Dann müssen zunächst wichtige Dateien von OpenSIM ausserhalb vom OpenSIM-Ordner auf ein externes Speichermedium wie z.B. USB-Festplatte, USB-Speicherstick, CD-ROM, DVD oder eine andere (Netzwerk-)Festplatte gesichert werden. Suchen Sie im OpenSIM-Ordner folgende Dateien heraus, markieren Sie diese jeweils einzeln durch drücken auf die Taste STRG und anklicken mit der Maus:

- AssetStorage.db
- InventoryStore.db
- LocalUserStatistics.db (falls vorhanden)
- OpenSim.db
- Userprofiles.db
- OpenSim.ini
- estate_settings.xml
- und der komplette Ordner "Regions" mit den enthaltenen xml-Dateien

Downloaden Sie dann die aktuellste OpenSIM-Version hier herunter.
Entpacken und kopieren Sie die heruntergeladenen Dateien in Ihren OpenSIM-Ordner. Überschreiben Sie die alten Dateien mit den neuen Dateien.
Kopieren Sie bis auf die Datei OpenSim.ini die gesicherten Daten in das OpenSIM-Verzeichnis zurück und überschreiben Sie die darin enthaltenen Dateien.
Die OpenSim.ini Datei darf nicht direkt übernommen werden, da sich in der neuen OpenSIM-Programmversion neue Funktionen befinden könnten. Sie müssen daher die Konfigurationswerte die Sie in Ihrer alten OpenSim.ini Datei gemacht haben in die neue OpenSim.ini Datei übernehmen. Vergleichen Sie die beiden Dateien und tragen Sie Ihre Konfiguration in die neue OpenSim.ini Datei ein.
Starten Sie OpenSIM und warten Sie solange bis die Startphase abgelaufen ist. Überprüfen Sie die laufende Programmversion durch das Kommando „show version“ und notieren oder merken Sie sich die angezeigte Version. Wenn wieder eine neuere Version verfügbar ist können Sie entscheiden dann wieder ein Update von OpenSIM zu machen um in den Genuss von neuen oder verbesserten Funktionen zu kommen.

Update von OpenSIM mit mySQL-Datenbank, Standalone-Modus

Der sichere Weg

Alle Datensicherungen prinzipiell auf ein externes Speichermedium durchführen. Die Datensicherungsordner jeweils mit dem aktuellen Datum in amerikanischer Schreibweise benennen, also zuerst Jahr, dann Monat, dann Tag (z.B. „2009-02-20“). Dann ist die Sortierung der Ordner sehr übersichtlich.
Die mySQL-Datenbank von OpenSIM sichern. Die gesicherte Datenbank, bzw. die SQL-Datei auf ein externes Medium speichern.
Die Konfigurationsdatei opensim.ini auf ein externes Medium speichern.
Alle Regionen per Kommando „save oar regionenname.oar“ auf ein externes Medium speichern.
Die Regionen im Ordner „Regions“ bzw. die darin enthaltenen XML-Dateien auf ein externes Medium speichern.
Den bisher verwendeten OpenSIM-Ordner in „OpenSIM-Backup“ umbenennen.
OpenSIM neu installieren und dazu einen neuen Order verwenden.
Die Regionen im Ordner „Regions“ wieder zurückkopieren, die Datei default.xml überschreiben.
Die Einstellungen aus der gesicherten Konfigurationsdatei opensim.ini in die neue Datei opensim.ini übernehmen, aber nicht die alte opensim.ini einfach 1:1 übernehmen oder drüberkopieren, es könnten neue Einträge in der neuen opensim.ini Datei enthalten sein die sonst verloren gehen würden und es zu Fehlfunktionen kommen kann.
OpenSIM starten und prüfen ob alles normal läuft. Falls nicht: Prozedur wiederholen und prüfen ob die neue OpenSIM-Version als fehlerbehaftet bekannt ist.

Standalone-Modus

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Nov 2019 10:58:50 +0000

Standalone-Modus

Der Standalone-Modus klingt erst einmal so als wenn dies ein isolierter OpenSIM-Server ist, was aber durch die Möglichkeit von Hypergrid nicht wirklich so ist. Mittels Hypergrid ist ein OpenSIM-Server im Standalone-Modus alles andere als „alleine“, sondern in der Regel sehr gut mit anderen OpenSIM-Servern vernetzt, egal ob diese im Grid-Modus oder auch im Standalone-Modus laufen.

Der Standalone-Modus wird in der OpenSIM-Konfigurationsdatei „opensim.ini“ mit folgendem Eintrag aktiviert:

gridmode = false

Zusätzlich muss die Standalone-Konfiguration im Bereich „Standalone“ angepasst werden. Beispiel für eine Standalone-Konfiguration mit einer mySQL-Datenbank:

[StandAlone] 
    accounts_authenticate = true 
    welcome_message = "Willkommen bei OpenSIM !" 

    ; Asset database provider 
    ; asset_plugin = "OpenSim.Data.SQLite.dll" 
    asset_plugin = "OpenSim.Data.MySQL.dll" ; for mysql 
    ; asset_plugin = "OpenSim.Data.NHibernate.dll" ; for nhibernate 

    ; the Asset DB source.  This only works for sqlite, mysql, and nhibernate for now 
    ; Asset Source SQLite example 
    ; asset_source = "URI=file:Asset.db,version=3" 
    ; Asset Source NHibernate example (DIALECT;DRIVER;CONNECTSTRING) 
    ; asset_source = "SQLiteDialect;SqliteClientDriver;URI=file:Asset.db,version=3" 
    ; Asset Source MySQL example 
    asset_source = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;" 

    ; Inventory database provider 
    ; inventory_plugin = "OpenSim.Data.SQLite.dll" 
    inventory_plugin = "OpenSim.Data.MySQL.dll" 
    ; inventory_plugin = "OpenSim.Data.NHibernate.dll" ; for nhibernate 

    ; Inventory Source NHibernate example (DIALECT;DRIVER;CONNECTSTRING) 
    ; inventory_source = "SQLiteDialect;SqliteClientDriver;URI=file:Inventory.db,version=3" 
    ; Inventory Source MySQL example 
    inventory_source = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;" 

    ; User Data Database provider 
    ; 
    ; Multiple providers can be specified by separating them with commas (whitespace is unimportant) 
    ; If multiple providers are specified then if a profile is requested, each is queried until one 
    ; provides a valid profile, or until all providers have been queried. 
    ; Unfortunately the order of querying is currently undefined (it may not be the order in which 
    ; providers are specified here).  This needs to be fixed 
    ; 
    ; userDatabase_plugin = "OpenSim.Data.SQLite.dll" 
    userDatabase_plugin = "OpenSim.Data.MySQL.dll" 
    ; userDatabase_plugin = "OpenSim.Data.NHibernate.dll" ; for nhibernate 

    ; User Source NHibernate Example (DIALECT;DRIVER;CONNECTSTRING) 
    ; user_source = "SQLiteDialect;SqliteClientDriver;URI=file:User.db,version=3" 
    ; User Source MySQL example 
    user_source = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;" 

    ; Specifies the location and filename of the default inventory library control file.  The path can be relative or absolute 
    ; Default is ./inventory/Libraries.xml 
    ;LibrariesXMLFile="./inventory/Libraries.xml" 
     
    ; Specifies the location and filename of the inventory library assets control file.  The path can be relative or absolute 
    ; Setting is optional. Default is ./assets/AssetSets.xml 
    ;AssetSetsXMLFile="./assets/AssetSets.xml" 

    dump_assets_to_file = false

Umstellung der Datenbank

anonymous@undisclosed.example.com (Anonymous) — Fri, 29 Nov 2019 10:58:50 +0000

Umstellung der Datenbank

Migration von SQLite nach mySQL

Mozilla Firefox Addon „SQLite Manager“ installieren
Datenbanken mit der Dateiendung .db nach .sql exportieren
Exportierte Datenbanken in mySQL importieren

Alternative Lösung

Zuerst alle Regionen mit save-oar regionname.oar speichern/sichern
Mit load-oar regionname.oar die Regionen in der neuen OpenSIM-Installation importieren
Rechte der Regionen wieder einstellen
Damit sind allerdings nur die Regionen wiederhergestellt, die Benutzerdatenbank muß separat behandelt werden
mySQL installieren und eine leere Datenbank mit dem Namen „opensim“ anlegen
mySQL starten und als ständig im Hintergrund laufender Dienst einrichten
mySQL auf ein regelmäßig im Hintergrund ablaufendes Backup konfigurieren
Konfigurationsdatei opensim.ini auf mySQL umstellen
OpenSIM starten und die Migrationsmeldungen im DOS-Fenster überprüfen
OpenSIM Inworld überprüfen ob alles normal läuft

Was bringt eine Umstellung ?

Die SQLite-Datenbank ist für sehr viele, gleichzeitige Datenbankzugriffe ungeeignet und je nach Menge der Anfragen sogar überfordert. Das bringt früher oder später Probleme mit sich, wobei Datenverlust und Progammabstürze die Folge sein können. Die mySQL Datenbank ist nicht nur performanter als SQLite, sondern lässt sich auch speziell auf die eigenen Bedürfnisse per Konfigurationsdatei anpassen. Zusätzlich bietet mySQL im Gegensatz zu SQLite den Vorteil daß einmal gespeicherte Avatar-Outfits auch einen Server-Neustart überstehen. Bei SQLite werden nach jedem Server-Neustart alle Avatare auf den Standard-Avatar „Ruth“ zurückgesetzt und eingeloggte Benutzer müssen sich jedesmal aus dem Inventar gespeichertes Outfit neu einkleiden. Das geht zwar schnell, ist aber dennoch lästig.