View source for Direct Service Requests/de

= Direkte Handhabung der GetTexture-Funktion =

WARNUNG: Möglicherweise verwenden Viewer dies nicht mehr.

GetTexture ist ein Protokoll für die Client-Viewer-[[capabilities|Fähigkeit]], durch das Clients (Viewer) Texturen über HTTP anfordern können, anstelle der alten UDP-basierten Mechanismen.

Normalerweise bearbeitet OpenSimulator dies, indem ein Endpunkt für die Fähigkeit bereitgestellt wird, der auf den vom Avatar des Benutzers belegten Simulator verweist. Anfragen werden vom Simulator empfangen, und das Asset wird aus dem Cache oder durch einen Aufruf des Backend-Asset-Dienstes abgerufen, je nachdem, was zutrifft.

Wir können jedoch auch konfigurieren, dass GetTexture direkt von einem Dienst über den öffentlichen Grid-Port bearbeitet wird. Der an den Viewer übermittelte Endpunkt verweist dann direkt auf diesen Dienst anstelle des Simulators, ähnlich wie Kartendaten direkt von einem Dienst bereitgestellt werden.

Diese Einrichtung funktioniert sowohl für Nicht-Hypergrid- als auch für Hypergrid-Installationen (da alle erforderlichen Assets in den lokalen Asset-Dienst kopiert werden, wenn ein externer Benutzer den Simulator betritt und wenn er Objekte aus seinem Inventar rezzt oder auf andere Weise überträgt).

== Konfiguration ==
Als Erstes müssen wir den Dienst so konfigurieren, dass er den GetTexture-Fähigkeits-Connector bereitstellt. Dies können wir mit der folgenden Konfiguration tun.

<source lang="ini">
[Startup]

[ServiceList]
GetTextureConnector = "8010/OpenSim.Capabilities.Handlers.dll:GetTextureServerConnector"

[Network]
port = 8010

[CapsService]
AssetService = "OpenSim.Services.AssetService.dll:AssetService"

[DatabaseService]
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=mypassword;Old Guids=true;"

[AssetService]
</source>

Ich gehe davon aus, dass wir den GetTexture-Dienst in einer vollständig separaten Robust-Instanz ausführen. Es ist jedoch auch möglich, ihn in einer Robust-Shell auszuführen, die auch andere Dienste verwaltet (z. B. der Standard-Grid-Dienst, der alle Dienste abwickelt). In diesem Fall können einige Abschnitte weggelassen werden, wie wir unten erläutern.

Hier eine Erklärung zu jedem Abschnitt:

* [Startup] – Dieser Abschnitt ist leer und nur vorhanden, weil die Robust-Service-Shell dies derzeit erfordert. Es könnte in Zukunft nicht mehr notwendig sein. In einer geteilten Service-Shell wird ein bereits vorhandener [Startup]-Abschnitt verwendet.
* [ServiceList] – Dies löst die Initialisierung des GetTexture-Fähigkeits-Konnektors aus. Hier spezifizieren wir explizit einen Port von 8010, obwohl dies weggelassen werden kann, wenn es derselbe wie die Standardeinstellung „port“ im Abschnitt Netzwerk ist. Dies ist der Port, über den der Viewer mit dem GetTextureConnector kommunizieren wird, daher muss er durch Ihre Firewall für den Viewer zugänglich sein. Sie sollten keine privaten Dienste (z. B. interne Asset-Dienste) auf diesem Port betreiben.
* [Network].port – OpenSimulator wird derzeit immer eine Fehlermeldung ausgeben, wenn dies nicht vorhanden ist, auch wenn Sie nur einen Konnektor haben und den von Ihnen verwendeten Port explizit angeben (wie oben). Wenn Sie den GetTextureConnector-Port explizit angeben, kann dies jeder freie Port auf Ihrem Server sein (er wird nicht verwendet, wenn es keine anderen Dienste gibt). Wenn Sie den GetTextureConnector in einer geteilten Service-Shell ausführen, reicht jede vorhandene Porteinstellung aus.
* [CapsService].AssetService – Dies gibt den Asset-Dienst an, den GetTextureConnector zur Initialisierung verwendet, um Texturen (die Assets sind) abzurufen.
* [DatabaseService] – Dies enthält die Einstellungen, damit der AssetService auf die Datenbank zugreifen kann. Wenn GetTextureConnector die Robust-Shell mit anderen Diensten teilt, existiert dieser Abschnitt sehr wahrscheinlich bereits.
* [AssetService] – Dieser Abschnitt ist leer und dient nur dazu, zu verhindern, dass AssetService fatale Fehler meldet. In Zukunft könnte dies als Anforderung wegfallen.

Wenn Sie nun die Robust-Shell starten, die den GetTextureConnector hostet, und den Befehl „show http-handlers“ ausführen, sollten Sie etwas wie Folgendes sehen (zur Klarheit zeigen wir die Ausgabe, wenn nur GetTextureConnector in der Shell läuft).
<pre> 
R.O.B.U.S.T.# show http-handlers Registered HTTP Handlers for server at 0.0.0.0:8010 
* XMLRPC: 
* HTTP: 
* HTTP (poll): 
* JSONRPC: 
* LLSD: 
* StreamHandlers (1): GET:/CAPS/GetTexture/ 
</pre>

Dies zeigt, dass der Endpunkt /CAPS/GetTexture jetzt verfügbar ist.

Nun müssen wir die Simulatoren so konfigurieren, dass sie den Viewern die GetTexture-Fähigkeit zur Verfügung stellen, die auf den Dienst verweist. Im Abschnitt [ClientStack.LindenCaps] der OpenSim.ini für jeden Simulator müssen wir etwas Ähnliches hinzufügen:
<source lang="ini"> 
[ClientStack.LindenCaps] 
Cap_GetTexture = "http://192.168.1.2:8010/CAPS/GetTexture/" 
</source>

Dies überschreibt die übliche „localhost“-Einstellung, die in bin/OpenSimDefaults.ini angegeben ist. In diesem Fall zeigt die URL auf eine LAN-IP (192.168.1.2). Für ein öffentliches Grid muss dies jedoch ein öffentlicher Host sein, der von allen Viewern erreicht werden kann (z. B. services.mygrid.com).

Wenn sich nun ein Viewer anmeldet, wird er GetTexture-Anfragen direkt an den Dienst senden und den Simulator vollständig umgehen. Wenn der GetTextureConnector in einer eigenen Shell läuft, können Sie überprüfen, ob dies der Fall ist, indem Sie einen Befehl wie „show stats httpserver.8010.HttpRequestsServed“ ausführen.
<pre> 
R.O.B.U.S.T.# show stats httpserver.8010.HTTPRequestsServed 
httpserver.8010.HTTPRequestsServed : 139 requests, 0 requests/s, 0 requests/s 
</pre>

In diesem Fall sehen wir, dass der Dienst nun 139 Anfragen bearbeitet hat. Leider ist es schwieriger zu überprüfen, ob die Shell von mehreren Diensten auf demselben Port gemeinsam genutzt wird – derzeit registrieren wir keine Statistiken, um Fähigkeiten zu zeigen (dies sollte sich jedoch in Zukunft ändern).

=== Experimentelle Konfiguration === 
'''Diese Konfiguration ist äußerst experimentell und noch nicht vollständig funktionsfähig. Sie wird hier zu Referenzzwecken belassen.'''

Anstelle der Instanziierung eines AssetService zur Bearbeitung von GetTexture-Anfragen am Dienstende können wir möglicherweise eine HGAssetBroker-Instanz instanziieren, wenn Hypergrid aktiv ist. Derzeit ist dies nicht notwendig, da die Assets bei Bedarf in den lokalen Asset-Dienst kopiert werden (und daher die oben beschriebene Standard-GetTexture-Konfiguration sie immer finden wird). Es könnte jedoch zukünftige Experimente geben, bei denen diese Assets nicht im Voraus kopiert, sondern nur bei Bedarf angefordert/zwischengespeichert werden. Dies erfordert auch zusätzlichen Code, um das Asset korrekt zu übertragen, falls es dauerhaft benötigt wird (z. B. weil ein Anhang in einer Region rezzt oder einem anderen Benutzer übergeben wird).

Die folgende Konfiguration ist derzeit nur im Entwicklungszweig 'ghosts' im OpenSimulator-Repository möglich, seit dem Commit 0437d44 (nach Version 0.8), obwohl dies bald im Hauptentwicklungszweig enthalten sein wird.

Die Dienstkonfiguration dafür sieht wie folgt aus. Die Simulator-Seiten-Konfiguration ist dieselbe wie im Normalfall.

<source lang="ini">
[Startup]

[ServiceList]
GetTextureConnector = "8010/OpenSim.Capabilities.Handlers.dll:GetTextureServerConnector"

[Network]
port = 8010

[CapsService]
AssetService = "OpenSim.Region.CoreModules.dll:HGAssetBroker"

[DatabaseService]
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=opensimmaster2;User ID=root;Password=passw0rd;Old Guids=true;"

[AssetService]
LocalGridAssetService = "OpenSim.Services.AssetService.dll:AssetService"
HypergridAssetService = "OpenSim.Services.Connectors.dll:HGAssetServiceConnector"

[Modules]
AssetServices = HGAssetBroker
</source>

Die Änderungen im Vergleich zur Nicht-Hypergrid-Konfiguration sind wie folgt:

* [CapsService].AssetService instanziiert nun HGAssetBroker aus OpenSim.Region.CoreModules.dll anstelle von AssetService aus OpenSim.Services.AssetService.
* [AssetService] enthält jetzt zwei Einträge. Der Eintrag LocalGridAssetService teilt dem HGAssetBroker mit, welchen Asset-Dienst er für Anfragen des Home-Grids instanziieren und verwenden soll. Der Eintrag HypergridAssetService teilt dem HGAssetBroker mit, welchen Asset-Dienst er für Anfragen an externe Asset-Dienste instanziieren und verwenden soll.
* [Modules].AssetServices ist der Eintrag, der erforderlich ist, um HGAssetBroker nach seiner Instanziierung auszuführen. Dies ist notwendig, da HGAssetBroker bis vor Kurzem nur ein Regionsmodul war, das niemals vom CapsService instanziiert wurde. Diese Anforderung könnte in Zukunft entfallen.