move IT Home Base

Hypergrid

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

Hypergrid

Hypergrid aktivieren

Um Hypergrid nutzen zu können um zwei oder mehrere Sims miteinander zu verbinden müssen alle Sims Hypergrid aktiviert haben. OpenSIM wird dazu mit einem bestimmten Kommando gestartet:

opensim.exe -hypergrid=true

Ab Version 0.6.5

Bitte beachten Sie: im OpenSimulator ab Version 0.6.5 wird Hypergrid nicht mehr wie bisher über das obenstehende Kommando aktiviert, sondern über die OpenSIM Konfigurationsdatei opensim.ini mit folgendem Eintrag:

hypergrid = true

In der opensim.ini Konfigurationsdatei wird zusätzlich die Worldmap umgestellt, sodaß die Worldmap auch externe Sims anzeigen kann:

WorldMapModule = "HGWorldMap"

Per Hypergrid externe Regionen verlinken

Externe Sims die Hypergrid-aktiv sind und sich maximal 4096 Regionen weit entfernt befinden können nun per Hypergrid verlinkt werden. Um nun eine externe Sim per Hypergrid zu verlinken wird im DOS-Fenster folgendes Kommando eingegeben:

Beispiel:

link-region 1001 1001 externer-opensimserver.com 9000 Sim-Name

Wobei die Beispiel-Werte 1001 1001 an die eigenen Koordinaten angepasst werden müssen. Ausserdem muss die richtige URL des externen OpenSIM-Servers und dessen Port-Nummer eingetragen werden. Der Name der externen Sim kann frei gewählt werden, sollte aber möglichst kurz sein da dieser in der Map noch lesbar sein muß.

Wenn man das Ganze komfortabler und automatisiert haben möchte, dann editiert man die Datei „startup_commands.txt“, bzw. legt diese erst an indem man das „.example“ am Ende des Dateinamens entfernt. Dann schreibt man in diese Textdatei nur ein einziges Kommando hinein:

link-region http://ihrwebspace.de/HG.xml

Beim Starten von OpenSim wird dann der Inhalt der Datei HG.xml automatisch eingelesen. Nehmen Sie Ihren Text-Editor und schreiben eine Datei mit dem Namen HG.xml, oder jedem anderem beliebigen Namen (keine Sonderzeichen, keine Leerzeichen, URL-kompatibel), aber mit dem Datei-Extender .xml . In dieser XML-Datei die Sie auf Ihrem Webspace speichern, können Sie dann die per Hypergrid zu verlinkenden Regionen in folgendem Format eintragen:

<Nini>
 <Section Name="Region1"> 
   <Key Name="xloc" Value="1001"/>
   <Key Name="yloc" Value="1001" />
   <Key Name="externalPort" Value="9000" />
   <Key Name="externalHostName" Value="externeSIM1.de" />
   <Key Name="localName" Value="Name der externen Sim 1 auf Ihrer Sim" />
 </Section>
 <Section Name="Region2"> 
   <Key Name="xloc" Value="1002"/>
   <Key Name="yloc" Value="1002" />
   <Key Name="externalPort" Value="9000" />
   <Key Name="externalHostName" Value="externeSIM2.de" />
   <Key Name="localName" Value="Name der externen Sim 2 auf Ihrer Sim" />
 </Section>
 <Section Name="Region3"> 
   <Key Name="xloc" Value="1003"/>
   <Key Name="yloc" Value="1003" />
   <Key Name="externalPort" Value="9000" />
   <Key Name="externalHostName" Value="externeSIM3.de" />
   <Key Name="localName" Value="Name der externen Sim 3 auf Ihrer Sim" />
 </Section>
 </Nini>

Die oben eingetragenen Werte sind nur Demodaten und müssen natürlich erst auf echte Hypergrid-Regionen geändert werden. Die „xloc“ und „yloc“ Werte bestimmen wo genau die externen Hypergrid-Regionen auf Ihrer Worldmap erscheinen. Achten Sie darauf mindestens 1 Region Abstand zu Ihren eigenen Regionen einzuhalten.

link-mapping

Sims per Hypergrid miteinander verbinden

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

Sims per Hypergrid miteinander verbinden

Hypergrid ist eine ideale Lösung um aus einer Standalone-Sim eine Sim mit Anschluss an andere Sims zu machen. So kann man sich zum Beispiel mit der Sim seines Freundes verbinden, sodaß man mit seinem Avatar von einer Sim zur anderen teleportieren kann. Wenn noch weitere Freunde dazukommen kann man diese virtuellen Welten nach und nach erweitern.

Um Hypergrid zu nutzen muß man zunächst sein eigenes OpenSIM-Programm im Hypergrid-Modus betreiben. Die Sim mit der man sich verbinden möchte muß ebenfalls im Hypergrid-Modus laufen, ansonsten kann man sich nicht verbinden. Dazu wird OpenSIM mit dem Startparameter „-hypergrid=true“ gestartet. Ein kompletter Programmpfad würde dann zum Beispiel auf einem Windows-Betriebssystem etwa so aussehen:

C:\OpenSim\OpenSim.exe -hypergrid=true

Man kann sich beispielsweise auf den Desktop eine neue Verknüpfung zu OpenSIM einrichten und dort im Feld „Ziel“ den Startparameter mit eintragen, dann wird OpenSIM mit Doppelklick auf die neue Desktop-Verknüpfung automatisch im Hypergrid-Modus gestartet. Ob OpenSIM im Hypergrid-Modus läuft können Sie so feststellen:

direkt beim Start von OpenSIM erscheint ganz oben in eingerahmten Sternchen der Hinweis das Hypergrid aktiv ist
wenn OpenSIM bereits läuft geben Sie im Programmfenster den Befehl „link-region“ ein. Wenn eine Fehlermeldung erscheint ist Hypergrid nicht aktiv.

Regionen bzw. Sims miteinander verlinken

Mit Hypergrid verlinkte Regionen bzw. Sims erscheinen auf der grossen Karte (Map) als normale Regionen. Um Regionen bzw. Sims miteinander zu verlinken kann man direkt im Programmfenster von OpenSIM das „link-region“-Kommando nutzen, beispielsweise so:

link-region 1001 1001 opensimserver.example.com 9000 SimName

Wenn die Verbindung geklappt hat wird dies im Programmfenster von OpenSIM mit einer entsprechenden Meldung bestätigt. Man sieht nun die neue Region auf der grossen Karte und kann mit einem Doppelklick auf die neue Region bzw. Sim mit seinem Avatar dorthin teleportieren - mitsamt seinem Inventar. Allerdings ist man auf der anderen Sim nur Gast und hat nur sehr eingeschränkte Rechte.

Unsere Sim verbinden

Wer die von uns betriebene Sim an seine eigene Sim anschliessen möchte, nimmt dieses Kommando

link-region 1001 1001 opensim.DOMAIN 9090 M34

Die Beispiel-Koordinaten 1001 1001 müssen an Ihre Sim angepasst werden. Wenn Sie nur 1 Sim mit 1 Region haben mit den Standard-Koordinaten 1000 1000 können Sie dieses Beispiel so übernehmen. Falls Sie mehr als 1 Region haben oder Sie die Sim-Koordinaten geändert haben müssen Sie die Werte an Ihre Sim anpassen. Lassen Sie aber immer mindestens 1 Region zwischen den eigenen und den externen Regionen frei.

Es gelten für externe Hypergrid-Regionen folgende Einschränkungen

die per Hypergrid verlinkten Regionen bzw. dessen Koordinaten dürfen keine direkten Nachbarn der eigenen Regionen sein, am besten mindestens 1 Region dazwischen freilassen
die per Hypergrid verlinkten Regionen sind nur auf der grossen Karte (Map) zu sehen, aber nicht wenn man z.B. am Rand einer Nachbar-Region steht
die per Hypergrid verlinkten Regionen bzw. dessen Koordinaten müssen unbenutzt sein, dürfen also nicht auf der eigenen Sim ebenfalls verwendet werden
die per Hypergrid verlinkten Regionen dürfen maximal 4096 Positionen von den eigenen Koordinaten entfernt sein
die per Hypergrid verlinkten Regionen müssen auf einem OpenSIM-Server liegen der im Hypergrid-Modus gestartet wurde
die per Hypergrid verlinkten Regionen sind nur per Teleport erreichbar
die Avatare sollten unbedingt ihre Home-Position gesetzt haben, ansonsten ist u.U. keine Rückkehr mit der Tastenfolge STRG-SHIFT-H zur Ursprungs-Sim möglich wo man sich eingeloggt hat, wenn auf der Ziel-Sim keine ebenfalls gesetzte Teleportmöglichkeit zur eigenen Sim zurück existiert. Man müsste sich dann erst wieder ausloggen und wieder neu einloggen.

OpenSIM über das Internet erreichen

Damit man sich mit dem OpenSIM eines Freundes verbinden kann muß man die Internetadresse des Freundes kennen. In den meisten Fällen wird der Freund aber keine feste Internetadresse haben, sondern nur einen ADSL-Internetzugang mit täglich wechselnder IP-Adresse. Wenn man OpenSIM nur für einen Tag testen möchte kann man die IP-Adresse des Freundes verwenden die er von seinem Internetprovider bekommen hat. Diese IP-Adresse kann man z.B. auf der Webseite www.wieistmeineip.de ablesen. Diese Internetadresse wird dann für das „link-region“-Kommando wie im obigen Beispiel gezeigt verwendet. Statt „opensimserver.example.com“ wird dort die IP-Adresse eingetragen.

Wer die Verbindung längere Zeit aufrechterhalten möchte, sollte über eine feste Internetadresse verfügen, damit man sich die täglich Anpassung der IP-Adresse in der Konfiguration erspart. Eine feste Internetadresse bekommt man z.B. bei dem bekanntesten aller DYNDNS-Anbieter www.dyndns.com . Dort kann man sich kostenlos einen oder mehrere Sub-Domains registrieren die man für OpenSIM verwenden kann. Statt der IP-Adresse wird fortan die Sub-Domain verwendet die sich automatisch an die täglich wechselnde IP-Adresse anpasst. Bei den meisten Routern kann man die Sub-Domain von DYNDNS in der Router-Konfiguration eintragen, sodaß der Abgleich automatisch stattfindet.

Editieren Sie dann die Datei „Regions/default.xml“ und ändern Sie den Wert von „external_host_name“ auf Ihre DYNDNS-Internetadresse. Beispiel: external_host_name=„yourcomputer.ath.cx“. Lassen Sie den Wert von „internal_ip_address“ auf „0.0.0.0“ und „port“ auf „9000“. Nun müssen Sie die Firewall Ihres Routers konfigurieren, damit eingehende Anfragen von aussen auf Ihren OpenSIM Server erfolgen können. In den NAT-Einstellungen muss bei Port-Forwarding der Port 9000 (TCP und UDP) für ein- und ausgehenden Datenverkehr (Traffic) freigegeben werden. Der Port 9000 muss dabei als weiterleitendes Ziel die interne IP-Adresse Ihres OpenSIM Servers bekommen. Vergessen Sie nicht auch eine entsprechende Desktop-Firewall wie z.B. die in Windows integrierte Windows Firewall zu konfigurieren. Sobald Sie den Server starten wird die Windows Firewall sich melden und fragen ob diese Verbindung freigegeben werden darf. Beantworten Sie mit Ja.

Wenn Ihr NAT-Router nicht korrekt mit NAT-Loopback umgehen kann und sich Clients von aussen nicht anmelden können, probieren Sie auf dem OpenSIM Server zusätzlich noch folgende Einstellung: editieren Sie unter Windows die Datei C:\Windows\System32\Drivers\etc\hosts und fügen Sie eine neue Zeile hinzu: 192.168.1.10 yourcomputer.ath.cx Ersetzen Sie „192.168.1.10“ durch die interne IP-Adresse Ihres OpenSIM Servers und „yourcomputer.ath.cx“ durch Ihre eigene DYNDNS-Adresse. Machen Sie zwischen der IP-Adresse und der DYNDNS-Adresse mindestens ein oder mehr Leerzeichen, oder ein TAB. Starten Sie den Windows PC neu, damit die Host-Datei eingelesen wird.

Tipp

Am besten ist es wenn die per Hypergrid verlinkten Regionen bzw. Sims nicht exakt diesselben Koordinaten für die Regionen benutzen, also beispielsweise beide 1000/1000 (Standardeinstellung von OpenSIM). Der Abstand darf allerdings aus technischen Gründen wegen eines Fehlers im Second Life Viewer auch nicht zu gross gewählt werden. Der Regionenabstand darf maximal 4096 Positionskoordinaten weit gewählt sein. Eine Abweichung im Hunderterbereich ist zum Beispiel sinnvoll. So kann der eine Sim-Betreiber seine Region unter den Koordinaten 1200/1200 konfigurieren, der andere 1300/1300. Diese Konfiguration nimmt man in den Konfigurationsdateien im Verzeichnis „Regions“ vor. Die darin enthaltene Datei default.xml muss dann angepasst werden.

Hat man mehr als eine Region installiert müssen auch alle anderen xml-Dateien in diesem Verzeichnis angepasst werden. Die Konfiguration nimmt man immer im ausgeschalteten Zustand von OpenSIM vor und bearbeitet die xml-Dateien immer mit einem normalen ASCII-Texteditor. Niemals Wordpad, Windows Word oder eine andere Textverarbeitung nutzen, sondern immer nur reine Texteditoren die keine Steuerzeichen in die Datei einfügen.

Achten Sie darauf daß sich im Verzeichnis „Regions“ ausschliesslich nur verwendete Konfigurationsdateien mit der Dateiendung .xml befinden dürfen, denn beim Start von OpenSIM durchsucht das Programm dieses Verzeichnis und entnimmt aus den darin enthaltenen Dateien die Konfiguration für die Regionen.

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.