ROBUST/de

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Konfigurationsdatei)
(Weitere Beispiele)
 
(11 intermediate revisions by one user not shown)
Line 1: Line 1:
{{Quicklinks}}
+
{{Quicklinks|ROBUST}}{{ReleaseInfo}}
  
 
= Einführung =
 
= Einführung =
  
ROBUST steht für die neu gestaltete OpenSimulator Basic Universal Server Technology (ROBUST). Es nutzt das System von Ein- und Ausgangskonnektoren und -diensten, das für Hypergrid und OpenSimulator entwickelt wurde. Es ersetzt OGS1 durch eine modulare Architektur, die einfach mit Core- und 3rd-Party-Modulen erweitert werden kann.
+
ROBUST steht für die "Redesigned OpenSimulator Basic Universal Server Technology" (ROBUST). Es nutzt das System von Ein- und Ausgangskonnektoren und -diensten, das für Hypergrid und OpenSimulator entwickelt wurde. Es ersetzt OGS1 durch eine modulare Architektur, die einfach mit Core- und 3rd-Party-Modulen erweitert werden kann.
  
 
ROBUST ist eine flexible Server-Shell, die dieselben Module laden kann, die bereits von Regionen verwendet werden. Dies ermöglicht eine fast 100-prozentige Wiederverwendbarkeit des Codes und eine große Flexibilität.
 
ROBUST ist eine flexible Server-Shell, die dieselben Module laden kann, die bereits von Regionen verwendet werden. Dies ermöglicht eine fast 100-prozentige Wiederverwendbarkeit des Codes und eine große Flexibilität.
Line 82: Line 82:
 
== Abschnitt [AssetService] ==
 
== Abschnitt [AssetService] ==
 
* LocalServiceModule [Connector option]
 
* LocalServiceModule [Connector option]
:A module specification (<dll>:<class>) that provides the services for this connector
+
:Eine Modulspezifikation (<dll>:<class>), die die Dienste für diesen Connector bereitstellt
 
* DefaultAssetLoader [Service option]
 
* DefaultAssetLoader [Service option]
:A dll containing the asset loader to use for loading the default asset set
+
:Eine DLL, die das Asset Ladeprogramm enthält, das zum Laden des Standard Asset Sets verwendet werden soll
 
* AssetLoaderArgs [Service option]
 
* AssetLoaderArgs [Service option]
:Path to load assets from (for the file system asset loader)
+
:Pfad zum Laden von Assets (für das Dateisystem-Asset-Loader)  
 
* StorageProvider [Service option]
 
* StorageProvider [Service option]
:Dll containing the database provider code
+
:Dll, die den Code des Datenbankanbieters enthält
 
* ConnectionString [Service option]
 
* ConnectionString [Service option]
:Connection string to be passed to the database provider
+
:An den Datenbankanbieter zu übergebende Verbindungszeichenfolge
  
== Section [InventoryService] ==
+
== Abschnitt [InventoryService] ==
 
* LocalServiceModule [Connector option]
 
* LocalServiceModule [Connector option]
:A module specification (<dll>:<class>) that provides the services for this connector
+
:Eine Modulspezifikation (<dll>:<class>), die die Dienste für diesen Connector bereitstellt
 
* UserServerURI [Connector option]
 
* UserServerURI [Connector option]
:URI to reach the user server at
+
:URI, um den Benutzerserver zu erreichen
 
* SessionAuthentication [Connector option]
 
* SessionAuthentication [Connector option]
:Authenticate inventory sessions (default false!)
+
:Inventarisierungssitzungen authentifizieren (standardmäßig false!)
 
* StorageProvider [Service option]
 
* StorageProvider [Service option]
:Dll containing the database provider code
+
:Dll, die den Code des Datenbankanbieters enthält
 
* ConnectionString [Service option]
 
* ConnectionString [Service option]
:Connection string to be passed to the database provider
+
:An den Datenbankanbieter zu übergebende Verbindungszeichenfolge
  
Additional connectors may need additional sections to be added.
+
Für zusätzliche Anschlüsse müssen möglicherweise zusätzliche Abschnitte hinzugefügt werden.
  
= An Example Conversion From UGAIM To UGRM =
+
= Verschieben eines beliebigen Dienstes in seine eigene ROBUST Shell =
  
<font color=red>'''This section will apply if you're migrating an existing OpenSimulator 0.6.6 installation to OpenSimulator 0.6.7.'''</font> In this version, the name of the ROBUST server is OpenSim.Server.exe.
+
Wenn Sie über ein großes Grid verfügen, möchten Sie möglicherweise verschiedene Sätze von Diensten in ihrer eigenen ROBUST-Shell auf separaten Computern ausführen, anstatt alle auf einem. Beispielsweise möchten Sie möglicherweise den Login-Dienst mit allen anderen Diensten außerhalb der Firewall auf einem eigenen Computer herausgreifen; der Grid-Dienst in seiner eigenen Maschine; der Asset Service in seiner eigenen Maschine; usw. Mit ROBUST kann jeder Dienst oder jede Kombination von Diensten einfach in eigenen ROBUST-Shells gruppiert werden. Wenn ja, tun Sie dies:
  
Converting from UGAIM to UGRM:
+
* Kopieren Sie Robust.ini.example in Ihre eigene Kopie auf jedem Computer, den Sie von diesen Servern ausführen möchten.
 +
* Bearbeiten Sie jeweils. Achten Sie auf alle Server-Connectors, die im Abschnitt [Startup] angegeben sind. Wählen Sie aus, was Sie in dieser bestimmten Maschine wollen.
 +
* In jedem Konfigurationsabschnitt müssen Sie nun auf die Hilfsdienstanschlüsse achten und diese gegebenenfalls entsprechend ändern. Beispielsweise muss der Anmeldedienst auf den Inventardienst zugreifen, um das Inventar des Benutzers bei der Anmeldung abzurufen. In der Standardkonfiguration wird diese Abhängigkeit im Abschnitt [LoginService] durch die Variable angegeben
  
Kudos to diva and Melanie_t for helping and tolerating me (smxy).
+
    InventoryService = "OpenSim.Services.InventoryService.dll:InventoryService"
  
My initial setup:
+
Wenn Sie den Anmeldedienst vom Inventardienst trennen, sollte die entsprechende 'InventoryService'-Variable unter [LoginService] geändert werden
 
+
Full HG-enabled, Internet-accessible, Grid Mode system, using MySQL and split over two servers.
+
 
+
UGAIM and MySQL 5.0 run in two separate 32-bit CentOS 5.3 Xen VMs on a 64-bit CentOS 5.3 system.<br />
+
Each region runs in its own instance of OpenSim.exe on a 32-bit Windows XP SP3 Home system.<br />
+
OSWI runs on the Windows system too.
+
 
+
 
+
Bring down the regions. Bring down UGAIM.
+
 
+
Then, the port for the inventory server needs to be changed from 8004 to 8003 in
+
 
+
OpenSim.ini:          "inventory_server_url"          - For all regions and the UGRM server.<br />
+
GridCommon.ini:        "InventoryServerURI"            - For all regions and the UGRM server.<br />
+
UserServer_Config.xml: "default_inventory_server"      - For the UGRM server.
+
 
+
In the MySQL database, in the "users" table, the userInventoryURI field needs to be updated for all users.
+
 
+
In OSWI's config file, update "$userInventoryURI".
+
 
+
AssetServer_Config.xml and InventoryServer_Config.xml can be deleted from the UGRM server.
+
 
+
On the UGRM server, copy OpenSim.Server.ini.example to OpenSim.Server.ini and edit it, changing the "ConnectionString" entries appropriately, in the [AssetService] and [InventoryService] sections.
+
 
+
Bring up UGRM. Bring up regions.
+
 
+
 
+
Semi-unrelated Note: According to Melanie_t, any of the UGRM servers can be restarted independently,
+
without needing to restart the other three. However, if you restart the UserServer, you must issue
+
the command "register" (without the quotes) at the MessagingServer console, afterwards.
+
 
+
= An Example Conversion From UGRM To URM =
+
 
+
<font color=red>'''This section will only apply if you're migrating from OpenSimulator 0.6.7 to 0.6.8.'''</font> In this version, the name of the ROBUST server is OpenSim.Server.exe.
+
 
+
Converting from UGRM to URM:
+
 
+
This is a continuation of my "UGAIM to UGRM" example above. I may merge the two examples, eventually.
+
 
+
Bring down the regions. Bring down UGRM.
+
 
+
'''Make sure that you don't override any of these files - they should be used as they come out of the repository:'''
+
  config-include/Grid.ini
+
  config-include/GridHypergrid.ini
+
  config-include/Standalone.ini
+
  config-include/StandalioneHypergrid.ini
+
 
+
'''Also make sure that you include new additions in config-include/*Common.ini.example into your config-include/*Common.ini'''
+
 
+
Then, the port for the grid server needs to be changed from 8001 to 8003 in
+
 
+
UserServer_Config.xml:      "default_grid_server"    - For the URM server.<br />
+
MessagingServer_Config.xml: "default_grid_server"    - For the URM server.
+
 
+
On the URM server, save a copy of your existing OpenSim.Server.ini. Copy OpenSim.Server.ini.example to OpenSim.Server.ini. Edit it to reflect any changes you made in the previous version. Then edit the "ConnectionString" entry, appropriately, in the [GridService] section.
+
 
+
GridServer_Config.xml can be deleted from the URM server.
+
 
+
Bring up URM. Bring up regions.
+
 
+
== An Example Conversion From URM To ROBUST ==
+
 
+
<font color=red>'''This section will only apply if you're migrating to the very latest Git master OpenSimulator code (since commit a9580eb on Tue Mar 2nd 2010)'''</font>
+
 
+
Starting in the presence-refactor branch, the default configuration is one single server running ALL resource services, plus whatever number of simulators you have.
+
 
+
Bring down the regions. Bring down URM.
+
 
+
'''Make sure that you don't override any of these files - they should be used as they come out of the repository:'''
+
  config-include/Grid.ini
+
  config-include/GridHypergrid.ini
+
  config-include/Standalone.ini
+
  config-include/StandalioneHypergrid.ini
+
 
+
'''Also make sure that you include new additions in config-include/GridCommon.ini.example into your config-include/GridCommon.ini'''
+
 
+
On the ROBUST server, copy Robust.ini.example to Robust.ini. Edit it to reflect your setup. In particular edit the "ConnectionString" entry, appropriately. Also notice new configuration variables in the [GridService] section, where you can now define default and fallback regions for your grid.
+
 
+
If you want your grid to support the Hypergrid functionality -- both letting your users go out and letting outside users come in -- use Robust.ini.HG.example as the basis of your setup instead of Robust.ini.example. Copy it to Robust.ini, and make the changes there.
+
 
+
All *_Config.xml files are now obsolete and can be removed.
+
 
+
Start your services:
+
$ [mono] Robust.exe
+
 
+
Note that the default configuration starts '''2''' processes, one listening in port 8002 and the other listening in 8003. We have placed the services that need to be exposed to the internet in port 8002; all services that don't need to be exposed are in port 8003. To secure your grid you can now put port 8003 behind your firewall. '''Unless you know what you are doing, leave the port numbers exactly as they come out of the package; change only the host names everywhere they need to be changed.'''
+
 
+
 
+
== Tips ==
+
If you're using MySQL in a standalone, you might see an error like this when you first start OpenSimulator after updating.
+
 
+
18:27:39 - [SERVICE BASE]: Failed to load plugin OpenSim.Data.IFriendsData from OpenSim.Data.MySQL.dll with args URI=file:friends.db,version=3, FriendsSystem.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.ArgumentException: Keyword not supported.
+
Parameter name: uri
+
 
+
...
+
 
+
18:27:39 - Error loading plugin from OpenSim.Services.FriendsService.dll, exception System.Exception: Could not find a storage interface IFriendsData in the given StorageProvider OpenSim.Data.MySQL.dll
+
 
+
This is because the new StorageProvider parameters in config-include/Standalone.ini are all for SQLite. If you comment these out then things should work again.
+
 
+
= Moving any service to its own ROBUST shell =
+
 
+
<font color=red>'''This section contains advanced material. Normally you can ignore this.'''</font>
+
 
+
If you have a large grid, you may want to run different sets of services in their own ROBUST shell in separate machines, instead of all in one. For example, you may want to single out the Login Service with all the other outside-the-firewall services in its own machine; the Grid Service in its own machine; the Asset Service in its own machine; etc. With ROBUST any service, or any combination of services, can be easily grouped into their own ROBUST shells. If so, do this:
+
 
+
* Copy Robust.ini.example to your own copy in each machine you want to run of these servers.
+
* Edit each. Pay attention to all the server connectors that are given in the [Startup] section. Pick & choose whichever you want in that particular machine.
+
* In each configuration section you now need to pay attention to the auxiliary service connectors, and, maybe, change them appropriately. For example, the Login Service needs to access the Inventory Service in order to get the user's inventory upon login. In the default configuration, that dependency is given under the [LoginService] section by the variable
+
InventoryService = "OpenSim.Services.InventoryService.dll:InventoryService"
+
If you separate the login service from the inventory service, the corresponding 'InventoryService' variable under [LoginService] should be changed to
+
 
     InventoryService = "OpenSim.Services.Connectors.dll:InventoryServicesConnector"
 
     InventoryService = "OpenSim.Services.Connectors.dll:InventoryServicesConnector"
Then in the [InventoryService] section of this Login server config, you'd have
+
Dann hätten Sie im Abschnitt [InventoryService] dieser Anmeldeserverkonfiguration
 
   [InventoryService]
 
   [InventoryService]
 
     InventoryServerURI = "http://myinventoryserver.com:myport"
 
     InventoryServerURI = "http://myinventoryserver.com:myport"
instead of what you have by default.
+
anstelle dessen, was Sie standardmäßig haben.
* Save the configuration and start the server as normal
+
 
* Note that you can start the server like this:
+
* Speichern Sie die Konfiguration und starten Sie den Server wie gewohnt
 +
* Beachten Sie, dass Sie den Server wie folgt starten können:
 +
 
 
  $ Robust.exe -inifile=OpenSim.MyServer.ini -logfile=/some/path/to/some/file
 
  $ Robust.exe -inifile=OpenSim.MyServer.ini -logfile=/some/path/to/some/file
* Start all other ROBUST servers you may want to have
 
* In your simulators, make sure to update GridCommon.ini to point to the correct URLs
 
* Start your sims
 
  
= Additional Examples =
+
* Starten Sie alle anderen ROBUST-Server, die Sie haben möchten
 +
* Stellen Sie in Ihren Simulatoren sicher, dass GridCommon.ini so aktualisiert wird, dass sie auf die richtigen URLs verweist
 +
* Starten Sie Ihre Sims
 +
 
  
[[WxService]] - An example ROBUST service
+
[[Category:German Translations]]

Latest revision as of 10:57, 18 January 2022

Contents

[edit] Einführung

ROBUST steht für die "Redesigned OpenSimulator Basic Universal Server Technology" (ROBUST). Es nutzt das System von Ein- und Ausgangskonnektoren und -diensten, das für Hypergrid und OpenSimulator entwickelt wurde. Es ersetzt OGS1 durch eine modulare Architektur, die einfach mit Core- und 3rd-Party-Modulen erweitert werden kann.

ROBUST ist eine flexible Server-Shell, die dieselben Module laden kann, die bereits von Regionen verwendet werden. Dies ermöglicht eine fast 100-prozentige Wiederverwendbarkeit des Codes und eine große Flexibilität.

Der ROBUST-Server lädt "in"-Konnektoren wie in der Konfigurationsdatei angegeben. Diese Konnektoren laden dann die erforderlichen Verarbeitungs- und Speichermodule und/oder "Ausgangs"-Konnektoren. Durch diese Architektur kann jeder ROBUST-Server beliebige oder alle Grid-Dienste ausführen und/oder als Proxy für Grid-Dienste fungieren.

Auf dieser Seite geht es um Nutzung und Konfiguration von ROBUST. Es gibt separate Seiten, auf denen Sie mehr über die services selbst erfahren können.

[edit] Konfiguration

Der Server liest beim Start eine Konfigurationsdatei, die standardmäßig den Namen der Assembly mit angehängter INI-Datei enthält. Der Standardname für den ROBUST-Server ist Robust.exe, daher ist die Standardkonfigurationsdatei Robust.ini. Eine Robust.ini.example-Datei wird mit dem OpenSimulator-Kit bereitgestellt. Der Standardport für alle Dienste, die in ROBUST ausgeführt werden, ist 8003, wie Sie unten sehen können.

; * The startup section lists all the connectors to start up in this server
; * instance. This may be only one, or it may be the entire server suite.
; * Multiple connectors should be seaprated by commas.
; *
; * These are the IN connectors the server uses, the in connectors
; * read this config file and load the needed OUT and database connectors
; *
[Startup]
ServiceConnectors = "OpenSim.Server.Handlers.dll:AssetServiceConnector,OpenSim.Server.Handlers.dll:InventoryServiceInConnector"   

; * This is common for all services, it's the network setup for the entire
; * server instance
; *
[Network]
port = 8003

; * As an example, the below configuration precisely mimicks the legacy
; * asset server. It is read by the asset IN connector (defined above)
; * and it then loads the OUT connector (a local database module). That,
; * in turn, reads the asset loader and database connection information
; *
[AssetService]
LocalServiceModule = "OpenSim.Services.AssetService.dll:AssetService"
DefaultAssetLoader = "OpenSim.Framework.AssetLoader.Filesystem.dll"
AssetLoaderArgs = "assets/AssetSets.xml"
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=grid;User ID=grid;Password=grid;"

; * This configuration loads the inventory server modules. It duplicates
; * the function of the legacy inventory server
; *
[InventoryService]
LocalServiceModule = "OpenSim.Services.InventoryService.dll:InventoryService"
UserServerURI = "http://127.0.0.1:8002"
SessionAuthentication = "false"
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=grid;User ID=grid;Password=grid;"

[edit] Kommandozeilenargumente

  • -inifile
Geben Sie anstelle des Standardspeicherorts den Speicherort der zu lesenden .ini-Datei an
  • -console
Geben Sie den Konsolentyp an, entweder Basic, Local oder Rest
  • -logconfig
Weisen Sie log4net an, diese Datei als Konfigurationsdatei zu verwenden
  • -prompt
Überschreiben Sie die Server-Eingabeaufforderung

[edit] Konfigurationsdatei

[edit] Abschnitt [Startup]

  • ServiceConnectors
Durch Kommas getrennte Liste von Dienst-IN-Anschlüssen. Das Format jedes Eintrags ist <dllname>:<classname>. Wenn eine DLL nur eine passende Klasse enthält, kann der Klassenname weggelassen werden.
  • Prompt
Überschreiben Sie die Server-Eingabeaufforderung
  • Console
Geben Sie den Konsolentyp an, entweder Basic, Local oder Rest
  • Logfile
Geben Sie die Protokolldatei an, in der sich dieser Server anmeldet

[edit] Abschnitt [Network]

  • Port
Stellen Sie den zu überwachenden Netzwerkport ein. Alle Dienste werden auf diesem Port ausgeführt.

[edit] Connector Konfigurationen

Diese Konfigurationen werden von den Anschlussmodulen bereitgestellt und sind kein integraler Bestandteil des ROBUST-Servers. Dokumentation zu allen möglichen Optionen finden Sie in der Dokumentation des Connectors. Dieses Handbuch listet nur die Optionen auf, die in der Beispielkonfigurationsdatei vorhanden sind.

[edit] Abschnitt [AssetService]

  • LocalServiceModule [Connector option]
Eine Modulspezifikation (<dll>:<class>), die die Dienste für diesen Connector bereitstellt
  • DefaultAssetLoader [Service option]
Eine DLL, die das Asset Ladeprogramm enthält, das zum Laden des Standard Asset Sets verwendet werden soll
  • AssetLoaderArgs [Service option]
Pfad zum Laden von Assets (für das Dateisystem-Asset-Loader)
  • StorageProvider [Service option]
Dll, die den Code des Datenbankanbieters enthält
  • ConnectionString [Service option]
An den Datenbankanbieter zu übergebende Verbindungszeichenfolge

[edit] Abschnitt [InventoryService]

  • LocalServiceModule [Connector option]
Eine Modulspezifikation (<dll>:<class>), die die Dienste für diesen Connector bereitstellt
  • UserServerURI [Connector option]
URI, um den Benutzerserver zu erreichen
  • SessionAuthentication [Connector option]
Inventarisierungssitzungen authentifizieren (standardmäßig false!)
  • StorageProvider [Service option]
Dll, die den Code des Datenbankanbieters enthält
  • ConnectionString [Service option]
An den Datenbankanbieter zu übergebende Verbindungszeichenfolge

Für zusätzliche Anschlüsse müssen möglicherweise zusätzliche Abschnitte hinzugefügt werden.

[edit] Verschieben eines beliebigen Dienstes in seine eigene ROBUST Shell

Wenn Sie über ein großes Grid verfügen, möchten Sie möglicherweise verschiedene Sätze von Diensten in ihrer eigenen ROBUST-Shell auf separaten Computern ausführen, anstatt alle auf einem. Beispielsweise möchten Sie möglicherweise den Login-Dienst mit allen anderen Diensten außerhalb der Firewall auf einem eigenen Computer herausgreifen; der Grid-Dienst in seiner eigenen Maschine; der Asset Service in seiner eigenen Maschine; usw. Mit ROBUST kann jeder Dienst oder jede Kombination von Diensten einfach in eigenen ROBUST-Shells gruppiert werden. Wenn ja, tun Sie dies:

  • Kopieren Sie Robust.ini.example in Ihre eigene Kopie auf jedem Computer, den Sie von diesen Servern ausführen möchten.
  • Bearbeiten Sie jeweils. Achten Sie auf alle Server-Connectors, die im Abschnitt [Startup] angegeben sind. Wählen Sie aus, was Sie in dieser bestimmten Maschine wollen.
  • In jedem Konfigurationsabschnitt müssen Sie nun auf die Hilfsdienstanschlüsse achten und diese gegebenenfalls entsprechend ändern. Beispielsweise muss der Anmeldedienst auf den Inventardienst zugreifen, um das Inventar des Benutzers bei der Anmeldung abzurufen. In der Standardkonfiguration wird diese Abhängigkeit im Abschnitt [LoginService] durch die Variable angegeben
    InventoryService = "OpenSim.Services.InventoryService.dll:InventoryService"

Wenn Sie den Anmeldedienst vom Inventardienst trennen, sollte die entsprechende 'InventoryService'-Variable unter [LoginService] geändert werden

   InventoryService = "OpenSim.Services.Connectors.dll:InventoryServicesConnector"

Dann hätten Sie im Abschnitt [InventoryService] dieser Anmeldeserverkonfiguration

 [InventoryService]
   InventoryServerURI = "http://myinventoryserver.com:myport"

anstelle dessen, was Sie standardmäßig haben.

  • Speichern Sie die Konfiguration und starten Sie den Server wie gewohnt
  • Beachten Sie, dass Sie den Server wie folgt starten können:
$ Robust.exe -inifile=OpenSim.MyServer.ini -logfile=/some/path/to/some/file
  • Starten Sie alle anderen ROBUST-Server, die Sie haben möchten
  • Stellen Sie in Ihren Simulatoren sicher, dass GridCommon.ini so aktualisiert wird, dass sie auf die richtigen URLs verweist
  • Starten Sie Ihre Sims
Personal tools
General
About This Wiki