Database Settings/de

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Created page with "{{Quicklinks}} If you want to quick know the walkthrough for database setup, see #Quick Setup. '''TODO: This page needs to be improved for setting up database usage in R...")
 
 
(20 intermediate revisions by one user not shown)
Line 1: Line 1:
−
{{Quicklinks}}
+
{{Quicklinks|Database_Settings}}
  
−
If you want to quick know the walkthrough for database setup, see [[#Quick Setup]].
+
Wenn Sie die Vorgehensweise für das Datenbank-Setup schnell kennenlernen möchten, finden Sie weitere Informationen unter [[#Quick Setup]].
  
−
'''TODO: This page needs to be improved for setting up database usage in Robust, though the config parameters are identical to the StandaloneCommon.ini/GridCommon.ini files.
+
'''TODO: Diese Seite muss zum Einrichten der Datenbanknutzung in Robust verbessert werden, obwohl die Konfigurationsparameter mit den Dateien StandaloneCommon.ini / GridCommon.ini identisch sind.
  
−
= Structure =
+
= Struktur =
  
−
On OpenSimulator 0.7.1 and later, you need to set '''StorageProvider''' and '''ConnectionString''' so that OpenSimulator can connect to a database. Usually you'll need to edit '''StandaloneCommon.ini''' for standalone or '''GridCommon.ini''' for grid mode.
+
Bei OpenSimulator 0.7.1 und höher müssen Sie StorageProvider und ConnectionString so einstellen , dass OpenSimulator eine Verbindung zu einer Datenbank herstellen kann. Normalerweise müssen Sie StandaloneCommon.ini für Standalone oder GridCommon.ini für den Rastermodus bearbeiten.
  
−
In those files, you'll find the [DatabaseService] section. This is where the database is configured. There are number of entries - the only ones that should be uncommented (by removing the beginning semi-colon) are those which apply to the database that you want. All the others must be commented out (by adding a semi-colon to the front of the line).  
+
In diesen Dateien finden Sie den Abschnitt [DatabaseService]. Hier wird die Datenbank konfiguriert. Es gibt eine Reihe von Einträgen. Die einzigen Einträge, die unkommentiert werden sollten (durch Entfernen des Semikolons am Anfang), sind diejenigen, die für die gewünschte Datenbank zutreffen. Alle anderen müssen auskommentiert werden (indem Sie ein Semikolon vor der Zeile einfügen).  
  
−
==Examples==
+
== Beispiele ==
  
 
===MySQL===
 
===MySQL===
  
−
For MySQL you will uncomment the required lines and configure as appropriate. For instance, the lines
+
Für MySQL kommentieren Sie die erforderlichen Zeilen und konfigurieren sie entsprechend. Zum Beispiel die Zeilen
  
 
<pre>
 
<pre>
Line 22: Line 22:
 
</pre>
 
</pre>
  
−
In this case, it will connect to a MySQL database called opensimdb on the same machine running the simulator (localhost). The user connecting is opensim with the password h0tgrits.
+
In diesem Fall wird eine Verbindung zu einer MySQL-Datenbank namens opensimdb auf demselben Rechner hergestellt, auf dem der Simulator (localhost) läuft. Der Benutzer, der sich verbindet, ist opensim mit dem Kennwort h0tgrits.
  
 
===PostgreSQL===
 
===PostgreSQL===
  
−
For PostgreSQL you will uncomment the required lines and configure as appropriate. For instance, the lines
+
Für PostgreSQL kommentieren Sie die erforderlichen Zeilen und konfigurieren sie entsprechend. Zum Beispiel die Zeilen
  
 
<pre>
 
<pre>
Line 33: Line 33:
 
</pre>
 
</pre>
  
−
In this case, it will connect to a PostgreSQL database called opensimdb on the same machine running the simulator (localhost). The user connecting is opensim with the password h0tgrits. If you changed the port number on PostgreSQL installation, you may add to connection string "Port=5432" where 5432 you may change to the installed port.
+
In diesem Fall wird eine Verbindung zu einer PostgreSQL-Datenbank namens opensimdb auf demselben Computer hergestellt, auf dem der Simulator (localhost) ausgeführt wird. Der Benutzer, der sich verbindet, ist opensim mit dem Kennwort h0tgrits. Wenn Sie die Portnummer in der PostgreSQL-Installation geändert haben, können Sie die Verbindungszeichenfolge "Port = 5432" hinzufügen, wobei 5432 in den installierten Port geändert werden kann.
  
−
* PostgreSQL database module isn't in 0.7.6 release. It is still on the bleeding edge source code.
+
* Das PostgreSQL-Datenbankmodul ist nicht in Version 0.7.6. Es ist immer noch am Rande des Quellcodes.
  
 
===SQLite===
 
===SQLite===
  
−
SQLite is slightly different. Instead you would uncomment (or leave uncommented) the line.
+
SQLite ist etwas anders. Stattdessen würden Sie die Zeile unkommentieren (oder unkommentiert lassen).
  
−
Or, you can include another ini files. You'll find a line like that:
+
Oder Sie können andere INI-Dateien einschließen. Sie finden eine solche Zeile:  
 
<pre>
 
<pre>
 
Include-Storage = "config-include/storage/SQLiteStandalone.ini";
 
Include-Storage = "config-include/storage/SQLiteStandalone.ini";
 
</pre>
 
</pre>
  
−
This will go on to read config-include/storage/SQLiteStandalone.ini after reading this ini file. If you open SQLiteStandalone.ini file, you'll find StrageProvider and ConnectionString lines in each sections. As SQLite does not require users or passwords to be setup, there is no further configuration to be done unless you want sqlite to use different filenames for its databases.
+
Nach dem Lesen dieser INI-Datei werden dann die Dateien config-include / storage / SQLiteStandalone.ini gelesen. Wenn Sie die Datei SQLiteStandalone.ini öffnen, finden Sie in den einzelnen Abschnitten StrageProvider- und ConnectionString-Zeilen. Da SQLite keine Einrichtung von Benutzern oder Kennwörtern erfordert, müssen keine weiteren Einstellungen vorgenommen werden, es sei denn, Sie möchten, dass sqlite andere Dateinamen für seine Datenbanken verwendet.
  
 
===MSSQL===
 
===MSSQL===
  
−
'''NOTE: MSSQL support will be removed in OpenSimulator 0.8.1 as it has been unmaintained for more than 2 years and so has bugs and lacks support for recent OpenSimulator features.'''
+
'''HINWEIS: Die MSSQL-Unterstützung wird in OpenSimulator 0.8.1 aufgehoben, da sie seit mehr als 2 Jahren nicht gewartet wurde und Fehler und Unterstützung für die neuesten OpenSimulator-Funktionen fehlen.'''
  
−
'''NOTE: There had been another way to connect to MSSQL database, which was using "mssql_connection.ini" in bin/ directory. On OpenSimulator 0.7.1 or later, it will NOT be read even if you set it properly. Use ConnectionString in *Common.ini instead. For more specific details, see the section [[#MSSQL]].'''
+
'''ANMERKUNG: Es gab eine andere Möglichkeit, eine Verbindung zur MSSQL-Datenbank herzustellen, die "mssql_connection.ini" im Verzeichnis bin / verwendet. Bei OpenSimulator 0.7.1 oder höher wird es NICHT gelesen, auch wenn Sie es richtig eingestellt haben. Verwenden Sie ConnectionString stattdessen in * Common.ini. Weitere Einzelheiten finden Sie im Abschnitt [[#MSSQL]].'''
  
 
== Database Parameters ==
 
== Database Parameters ==
Line 65: Line 65:
 
| StorageProvider
 
| StorageProvider
 
| "OpenSim.Data.SQLite.dll" (SQLite)<br />"OpenSim.Data.MySQL.dll" (MySQL)<br />"OpenSim.Data.PGSQL.dll" (PostgreSQL)<br />"OpenSim.Data.MSSQL.dll" (Microsoft SQL Server)<br />"OpenSim.Data.Null.dll" (disable persistence)
 
| "OpenSim.Data.SQLite.dll" (SQLite)<br />"OpenSim.Data.MySQL.dll" (MySQL)<br />"OpenSim.Data.PGSQL.dll" (PostgreSQL)<br />"OpenSim.Data.MSSQL.dll" (Microsoft SQL Server)<br />"OpenSim.Data.Null.dll" (disable persistence)
−
| The name of the storage provider modules, which can be found in bin/ folder. The three above are which OpenSimulator officially support (though MSSQL is partially). If you choose "OpenSim.Data.Null.dll", OpenSimulator will keep all data in its memory instead of using DBMS.
+
| Der Name der Speicheranbietermodule, die sich in bin / folder befinden. Die drei oben genannten werden von OpenSimulator offiziell unterstützt (obwohl MSSQL teilweise ist). Wenn Sie "OpenSim.Data.Null.dll" wählen, behält OpenSimulator alle Daten in seinem Speicher, anstatt DBMS zu verwenden.
  
 
|-
 
|-
 
| ConnectionString
 
| ConnectionString
 
| See [[#ConnectionString Syntax]]
 
| See [[#ConnectionString Syntax]]
−
| A string that OpenSimulator specifies information about a data source. Usually it may include the hostname or ip addresses of database server, database service names, username, schema name and password. The syntax varies between databases.
+
| Eine Zeichenfolge, die OpenSimulator Informationen zu einer Datenquelle angibt. Normalerweise kann es den Hostnamen oder die IP-Adressen des Datenbankservers, die Datenbankservicenamen, den Benutzernamen, den Schemanamen und das Kennwort enthalten. Die Syntax variiert zwischen Datenbanken.
  
 
|-
 
|-
 
| EstateConnectionString
 
| EstateConnectionString
 
| See [[#ConnectionString Syntax]]
 
| See [[#ConnectionString Syntax]]
−
| The same as ConnectionString, but it will be used only for Estate Service. (optional)
+
| Entspricht ConnectionString, wird jedoch nur für den Estate Service verwendet. (wahlweise)
 
|}
 
|}
  
Line 137: Line 137:
 
</pre>
 
</pre>
  
−
== Using different database settings for different services ==
+
== Verwenden verschiedener Datenbankeinstellungen für verschiedene Dienste ==
  
−
'''Note: This is extremely advanced configuration and needs to be updated for ROBUST configuration as well as standalone (which is what is implied here).'''
+
'''Hinweis: Diese Konfiguration ist sehr fortgeschritten und muss sowohl für die ROBUST-Konfiguration als auch für die Standalone-Version (was hier impliziert wird) aktualisiert werden.'''
  
−
Currently there are several services in OpenSimulator.
+
'''Für größere Grids ist es sehr zu empfehlen, die Dienste auf mehrere Datenbanken aufzuteilen.'''
 +
 
 +
Momentan gibt es mehrere Dienste im OpenSimulator.
 
* [InventoryService]
 
* [InventoryService]
 
* [AssetService]
 
* [AssetService]
Line 155: Line 157:
 
* [GridService]
 
* [GridService]
  
−
You can use a different database for each service by overriding the StorageProvider and ConnectionString properties as we saw in the general [DatabaseService] section above. For instance, if you want to use MySQL 'opensim' in general but MySQL 'opensim2' for Inventory Service and MSSQL for Authentication Service, you'll need to write in StandaloneCommon.ini something like:
+
Sie können für jeden Dienst eine andere Datenbank verwenden, indem Sie die StorageProvider- und ConnectionString-Eigenschaften überschreiben, wie wir im Abschnitt "Allgemein" [DatabaseService] oben gesehen haben. Wenn Sie beispielsweise MySQL 'opensim' im Allgemeinen, MySQL 'opensim2' für Inventory Service und MSSQL für Authentication Service verwenden möchten, müssen Sie beispielsweise in StandaloneCommon.ini schreiben.
 
   
 
   
 +
Beispiele:
 +
 
<pre>
 
<pre>
 
[DatabaseService]
 
[DatabaseService]
Line 171: Line 175:
 
</pre>
 
</pre>
  
−
If OpenSimulator can't find StorageProvider or ConnectionString in each service's section, it will use those in [DatabaseService] section. If OpenSimulator find each or them, it will use the parameter in each service's section. Thus, then the settings in these sections override those in [DatabaseService] section.
+
Wenn OpenSimulator StorageProvider oder ConnectionString nicht in den Abschnitten der einzelnen Services finden kann, werden die im Abschnitt [DatabaseService] angegebenen verwendet. Wenn OpenSimulator alle gefunden hat, wird der Parameter in den Abschnitten der einzelnen Dienste verwendet. Die Einstellungen in diesen Abschnitten überschreiben dann die Einstellungen im Abschnitt [DatabaseService].
  
−
In this case, Inventory Service will:
+
In diesem Fall führt der Inventarservice Folgendes aus:  
 
* read [DatabaseService]StorageProvider
 
* read [DatabaseService]StorageProvider
 
* read [DatabaseService]ConnectionString -> read [InventoryService]ConnectionString and override
 
* read [DatabaseService]ConnectionString -> read [InventoryService]ConnectionString and override
  
−
Authentication Service will:
+
Der Authentifizierungsdienst wird:
 
* read [DatabaseService]StorageProvider -> read [AuthenticationService]StorageProvider and override
 
* read [DatabaseService]StorageProvider -> read [AuthenticationService]StorageProvider and override
 
* read [DatabaseService]ConnectionString -> read [AuthenticationService]ConnectionString and override
 
* read [DatabaseService]ConnectionString -> read [AuthenticationService]ConnectionString and override
  
−
Note: SQLite and MSSQL providers don't support some services.
+
Hinweis: Anbieter von SQLite und MSSQL unterstützen einige Dienste nicht.
  
−
Note: For Estate Service, there is another parameter EstateConnectionString in [DatabaseService]. It is the middle priority between [DatabaseService] and [EstateDataStore] ConnectionStrings. OpenSimulator reads ConnectionString in [DatabaseService] section first, next EstateConnectionString, finally ConnectionString in [EstateDataService] section and overrides.
+
Hinweis: Für den Estate Service gibt es einen weiteren Parameter EstateConnectionString in [DatabaseService]. Dies ist die mittlere Priorität zwischen [DatabaseService] und [EstateDataStore] ConnectionStrings. OpenSimulator liest ConnectionString zuerst im Abschnitt [DatabaseService], als nächstes EstateConnectionString, schließlich ConnectionString im Abschnitt [EstateDataService] und überschreibt.
  
 
= Quick Setup =
 
= Quick Setup =
  
−
== SQLite Walkthrough ==
+
== SQLite-Komplettlösung ==
  
−
By default, OpenSimulator will automatically create its SQLite database files(*.db) in bin/ directory. You don't need to do anything generally.
+
Standardmäßig erstellt OpenSimulator seine SQLite-Datenbankdateien (*.db) automatisch im Verzeichnis bin/. Sie müssen grundsätzlich nichts tun.
−
If you want to create the database files in another directory, you can change by editing ConnectionString in bin/config-include/storage/SQLiteStandalone.ini included by config-include/*Commons.ini. See [[#SQLite]] section for the detailed syntax.
+
Wenn Sie die Datenbankdateien in einem anderen Verzeichnis erstellen möchten, können Sie dies ändern, indem Sie ConnectionString in bin/config-include/storage/SQLiteStandalone.ini bearbeiten, das in config-include/*Commons.ini enthalten ist. Die detaillierte Syntax finden Sie im Abschnitt [[#SQLite]].
  
−
== MySQL Walkthrough ==
+
== MySQL-Komplettlösung ==
 +
 
 +
Bitte lesen sie die Anleitung für mysql speziell für ihr Betriebssystem.
 +
 
 +
Empfehlen kann ich die Ubuntu Anleitung für Linux:  https://wiki.ubuntuusers.de/MySQL/
 +
 
 +
Bei Windows kann auch xampp benutzt werden (Bitte beachten sie die Warnungen): https://www.apachefriends.org/de/index.html
 +
 
 +
Ansonsten befolgen sie bitte die Anleitungen von Microsoft.
  
 
=== Download ===
 
=== Download ===
−
Download and install "MySQL Community Server" from [http://dev.mysql.com/downloads/mysql/ MySQL Downloads Page]. On Linux, you can even fetch "mysql-server" or "mysql-community-server" with your native package manager.  
+
Laden Sie „MySQL Community Server“ von [http://dev.mysql.com/downloads/mysql/ MySQL-Downloadseite] herunter und installieren Sie es. Unter Linux können Sie sogar „mysql-server“ oder „mysql-community-server“ mit Ihrem nativen Paketmanager abrufen.
  
−
=== Installing MySQL Server ===
+
=== MySQL Server installieren ===
−
On Windows:
+
Unter Windows:
−
Download MSI and run it. Select "Typical". After installation, it will launch "MySQL Server Instance Configuration Wizard". Select "Standard Configuration". In the next screen, you might be happy later if you check "Include Bin Directory in Windows PATH". In the next screen, provide mysql root password. It will complete settings for mysql and startup its service automatically. See [http://dev.mysql.com/doc/refman/5.5/en/windows-installation.html MySQL Documentation] for more details.
+
Laden Sie MSI herunter und führen Sie es aus. Wählen Sie „Typisch“. Nach der Installation wird der „MySQL Server-Instanzkonfigurationsassistent“ gestartet. Wählen Sie „Standardkonfiguration“. Im nächsten Bildschirm könnten Sie später zufrieden sein, wenn Sie „Bin-Verzeichnis in Windows-PFAD einbeziehen“ aktivieren. Geben Sie im nächsten Bildschirm das MySQL-Root-Passwort ein. Die Einstellungen für MySQL werden abgeschlossen und der Dienst wird automatisch gestartet. Weitere Einzelheiten finden Sie in der [http://dev.mysql.com/doc/refman/5.5/en/windows-installation.html MySQL-Dokumentation].
  
−
On Mac OS X:
+
Unter Mac OS X:
−
Download DMG package and install it normally. After install the server package, you can even install MySQL Startup Item if you want MySQL to start automatically during system startup. After that, startup your MySQL by following commands. See [http://dev.mysql.com/doc/refman/5.5/en/macosx-installation.html MySQL Documentation] for more details.
+
Laden Sie das DMG-Paket herunter und installieren Sie es normal. Nach der Installation des Serverpakets können Sie sogar MySQL Startup Item installieren, wenn MySQL beim Systemstart automatisch gestartet werden soll. Starten Sie anschließend Ihr MySQL, indem Sie den folgenden Befehlen folgen. Weitere Einzelheiten finden Sie in der [http://dev.mysql.com/doc/refman/5.5/en/macosx-installation.html MySQL-Dokumentation].
  
−
MySQL must be configured to use UTF8 as its default character set. In the config file /etc/my.cnf (Linux) or my.ini (Windows), add these settings:
+
MySQL muss so konfiguriert sein, dass es UTF8 als Standardzeichensatz verwendet. Fügen Sie in der Konfigurationsdatei /etc/my.cnf (Linux) oder my.ini (Windows) diese Einstellungen hinzu:
  
 
<pre>
 
<pre>
Line 214: Line 226:
 
</pre>
 
</pre>
  
−
And it's ready to run.
+
Und es ist betriebsbereit.
  
 
<pre>
 
<pre>
Line 225: Line 237:
 
</pre>
 
</pre>
  
−
On Linux:
+
Unter Linux:
−
RPM install the downloaded package or install "mysql-server" or "mysql-community-server" with your package manager. For more instructions for installation, see [http://dev.mysql.com/doc/refman/5.5/en/linux-installation.html MySQL Documentation]. After that, startup your MySQL with following command.
+
RPM installieren Sie das heruntergeladene Paket oder installieren Sie „mysql-server“ oder „mysql-community-server“ mit Ihrem Paketmanager. Weitere Anweisungen zur Installation finden Sie in der [http://dev.mysql.com/doc/refman/5.5/en/linux-installation.html MySQL-Dokumentation]. Starten Sie anschließend MySQL mit dem folgenden Befehl.
 
<pre>
 
<pre>
 
$ /etc/init.d/mysqld start
 
$ /etc/init.d/mysqld start
 
</pre>
 
</pre>
  
−
If you want to startup MySQL server automatically, see [http://dev.mysql.com/doc/refman/5.5/en/automatic-start.html 2.10.1.2. Starting and Stopping MySQL Automatically in MySQL 5.5 Reference Manual].
+
Wenn Sie den MySQL-Server automatisch starten möchten, lesen Sie [http://dev.mysql.com/doc/refman/5.5/en/automatic-start.html 2.10.1.2]. MySQL automatisch starten und stoppen im MySQL 5.5-Referenzhandbuch].
  
−
=== Creating MySQL Database ===
+
=== MySQL-Datenbank erstellen ===
−
Now you can configure your MySQL with the command line tools.  
+
Jetzt können Sie Ihr MySQL mit den Befehlszeilentools konfigurieren.
 
<pre>
 
<pre>
 
$ mysql -u root --password
 
$ mysql -u root --password
−
(enter your password, or if you haven't set password for MySQL server, type "mysql -u root" instead)
+
(Geben Sie Ihr Passwort ein. Wenn Sie kein Passwort für den MySQL-Server festgelegt haben, geben Sie stattdessen „mysql -u root“ ein.)
 
</pre>
 
</pre>
−
You can even use MySQL Command Line Client on Start menu on Windows. After login, create user and database for OpenSimulator.
+
Sie können den MySQL-Befehlszeilenclient sogar im Startmenü von Windows verwenden. Erstellen Sie nach der Anmeldung einen Benutzer und eine Datenbank für OpenSimulator.
 
<pre>
 
<pre>
 
mysql> create database opensim;
 
mysql> create database opensim;
Line 248: Line 260:
 
</pre>
 
</pre>
  
−
=== Configuring OpenSimulator ===
+
=== OpenSimulator konfigurieren ===
−
Open StandaloneCommon.ini or GridCommon.ini with your editor. First, comment-out the line for SQLite.  
+
Öffnen Sie StandaloneCommon.ini oder GridCommon.ini mit Ihrem Editor. Kommentieren Sie zunächst die Zeile für SQLite aus.
 
<pre>
 
<pre>
 
; SQLite
 
; SQLite
 
;Include-Storage = "config-include/storage/SQLiteStandalone.ini";
 
;Include-Storage = "config-include/storage/SQLiteStandalone.ini";
 
</pre>
 
</pre>
−
After that, uncomment StorageProvider and ConnectionString property lines in [DatabaseService] section and change the line like that:
+
Entfernen Sie anschließend die Kommentarzeichen für die Eigenschaftenzeilen StorageProvider und ConnectionString im Abschnitt [DatabaseService] und ändern Sie die Zeile wie folgt:
 
<pre>
 
<pre>
 
; MySql
 
; MySql
Line 260: Line 272:
 
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"
 
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"
 
</pre>
 
</pre>
−
Note that "Data Source=localhost;" actually specifies a TCP socket. If your MySQL server is set up to refuse remote connections (i.e. with skip-networking enabled) you'll need to replace "localhost" with the path to MySQL's UNIX socket.
+
Beachten Sie, dass "Data Source=localhost;" Gibt tatsächlich einen TCP-Socket an. Wenn Ihr MySQL-Server so eingerichtet ist, dass er Remoteverbindungen ablehnt (d. h. mit aktiviertem Skip-Networking), müssen Sie „localhost“ durch den Pfad zum UNIX-Socket von MySQL ersetzen.
 
<pre>
 
<pre>
 
ConnectionString = "Data Source=/var/run/mysqld/mysqld.lock;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"
 
ConnectionString = "Data Source=/var/run/mysqld/mysqld.lock;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"
 
</pre>
 
</pre>
−
You can find the path to the socket that your MySQL server is using with mysqladmin.
+
Den Pfad zu dem Socket, den Ihr MySQL-Server verwendet, finden Sie mit mysqladmin.
 
<pre>
 
<pre>
 
$ mysqladmin -p -u root version
 
$ mysqladmin -p -u root version
 
</pre>
 
</pre>
  
−
Save and start OpenSimulator. It will access to your new MySQL database instead of the default SQLite databases.
+
Speichern und starten Sie OpenSimulator. Es greift auf Ihre neue MySQL-Datenbank statt auf die Standard-SQLite-Datenbanken zu.
  
−
== PostgreSQL Walkthrough ==
+
== PostgreSQL-Komplettlösung ==
  
−
=== Download ===
+
=== Was ist PostgreSQL ===
−
Download and install PostgreSQL server from [http://www.postgresql.org/download/ PostgreSQL Downloads Page]. On Linux, you can even fetch "postgresql" with your native package manager.
+
* Relationale Datenbank
 +
* Weltweit aktive Community
 +
* Zahlreiche Features und Funktionen (Foreign Keys,Transaktionen, Trigger)
 +
* PostgreSQL kann mehrere Indexe pro Anfrage verwenden
 +
* Läuft auf zahlreichen Betriebssystemen und diverser Hardware
 +
* Weitgehendes Einhalten der SQL-Standards – Dokumentation der Abweichungen
 +
* Aktuelle Version: 16.1; (9. November 2023)
 +
* Betriebssystem: Unix-Derivate, Linux, Microsoft Windows, macOS
 +
* Entwickler: PostgreSQL Global Development Group
 +
* Kategorie: Datenbanksystem, Server
 +
* Lizenz: PostgreSQL Lizenz vergleichbar der BSD-Lizenz oder der MIT-Lizenz
 +
 
 +
=== Herunterladen ===
 +
Laden Sie den PostgreSQL-Server von [http://www.postgresql.org/download/ PostgreSQL-Downloadseite] herunter und installieren Sie es.  
 +
 
 +
PostgreSQL ist in den meisten Linux-Distributionen enthalten, allerdings oft in der Version, die bei Erscheinen des Release aktuell war.
 +
 
 +
Aktuellere Versionen gibt es für viele Linux-Distributionen in von der PostgreSQL Developer Group bereitgestellten Repositorien.
 +
 
 +
Apple liefert von der Version Mac OS X Lion (10.7) an PostgreSQL als Standarddatenbank aus.
 +
 
 +
=== Anleitungen ===
 +
[https://www.postgresql.org/docs/current/ PostgreSQL Handbuch] Englisch
 +
 
 +
[https://www.digitalocean.com/community/tutorials/how-to-install-postgresql-on-ubuntu-22-04-quickstart how to install postgresql on ubuntu 22.04] Englisch
 +
 
 +
[https://andreas.scherbaum.la/writings/MySQL-to-PostgreSQL_-PGDayEU-2010.pdf Datenbanken von MySQL zu PostgreSQL portieren] Deutsch
 +
 
 +
[https://wiki.postgresql.org/wiki/Converting_from_other_Databases_to_PostgreSQL Converting from other Databases to PostgreSQL] Englisch
 +
 
 +
=== Konvertieren einer MySQL OpenSim Grid Datenbank in PostgreSQL mit pg_chameleon ===
 +
 
 +
Die Verwendung von pg_chameleon erleichtert den Prozess des Datenbank-Migrations erheblich.
 +
 
 +
Dieses Werkzeug ist darauf spezialisiert, Daten aus MySQL in PostgreSQL zu replizieren.
 +
 
 +
Hier ist eine Anleitung, wie Sie pg_chameleon für die Konvertierung Ihrer MySQL OpenSim Grid Datenbank verwenden können:
 +
 
 +
Vorbereitung:
 +
 
 +
Installation von PostgreSQL:
 +
Stellen Sie sicher, dass PostgreSQL auf Ihrem System installiert ist.
 +
 
 +
PostgreSQL Datenbank und Benutzer erstellen:
 +
Erstellen Sie eine leere PostgreSQL-Datenbank und einen Benutzer mit den notwendigen Berechtigungen.
 +
 
 +
bash:
 +
    createdb mygrid
 +
    createuser mygriduser
 +
 
 +
MySQL und PostgreSQL Bibliotheken installieren:
 +
 
 +
Stellen Sie sicher, dass die notwendigen Bibliotheken installiert sind:
 +
 
 +
Für MySQL: libmysqlclient-dev
 +
Für PostgreSQL: libpq-dev
 +
 
 +
bash:
 +
    sudo apt-get install libmysqlclient-dev libpq-dev
 +
 
 +
pg_chameleon installieren:
 +
 
 +
Befolgen Sie die Anweisungen auf der pg_chameleon GitHub-Seite oder verwenden Sie den folgenden Befehl:
 +
 
 +
bash:
 +
    pip install pg_chameleon
 +
 
 +
MySQL- und PostgreSQL-Verbindung konfigurieren:
 +
 
 +
Bearbeiten Sie die Konfigurationsdatei von pg_chameleon, um die Verbindungsdaten für MySQL und PostgreSQL festzulegen.
 +
 
 +
bash:
 +
    nano /path/to/pg_chameleon/etc/chameleon.conf
 +
 
 +
Konfigurieren Sie die Abschnitte [source] für MySQL und [destination] für PostgreSQL.
 +
 
 +
Konvertierungsschritte:
 +
 
 +
Schema erstellen:
 +
 
 +
Führen Sie den Befehl aus, um das Schema in der PostgreSQL-Datenbank zu erstellen.
 +
 
 +
bash:
 +
    chameleon.py create_schema -C /path/to/pg_chameleon/etc/chameleon.conf
 +
 
 +
Replikation starten:
 +
 
 +
Starten Sie die Replikation mit dem Befehl:
 +
 
 +
bash:
 +
    chameleon.py start --detach -C /path/to/pg_chameleon/etc/chameleon.conf
 +
 
 +
Dies startet den Replikationsprozess im Hintergrund.
 +
 
 +
Datenbank optimieren:
 +
 
 +
Überprüfen Sie die PostgreSQL-Datenbank auf mögliche Optimierungen, insbesondere Indizes und Schlüssel.
 +
 
 +
Tests durchführen:
 +
 
 +
Führen Sie umfassende Tests durch, um sicherzustellen, dass alle OpenSim-Grid-Funktionen ordnungsgemäß funktionieren.
 +
 
 +
Zusätzliche Hinweise:
 +
 
 +
Überwachen Sie die Logs von pg_chameleon, um eventuelle Fehler oder Warnungen während der Replikation zu identifizieren.
 +
 
 +
Stellen Sie sicher, dass die Replikation abgeschlossen ist, bevor Sie die MySQL-Datenbank in der Produktionsumgebung abschalten.
 +
 
 +
Konsultieren Sie die Dokumentation von pg_chameleon für detailliertere Konfigurationsoptionen und Problemlösungen.
 +
 
 +
Diese Anleitung bietet einen allgemeinen Überblick über den Prozess.
 +
 
 +
Bitte passen Sie die Schritte entsprechend Ihrer spezifischen Umgebung an
 +
 
 +
und berücksichtigen Sie die individuellen Anforderungen Ihrer OpenSim-Grid-Implementierung.
  
 
== MSSQL Walkthrough ==
 
== MSSQL Walkthrough ==

Latest revision as of 09:46, 5 April 2024

Languages Languages: 

En.png English   De.png Deutsch

Wenn Sie die Vorgehensweise für das Datenbank-Setup schnell kennenlernen möchten, finden Sie weitere Informationen unter #Quick Setup.

TODO: Diese Seite muss zum Einrichten der Datenbanknutzung in Robust verbessert werden, obwohl die Konfigurationsparameter mit den Dateien StandaloneCommon.ini / GridCommon.ini identisch sind.

Contents

[edit] Struktur

Bei OpenSimulator 0.7.1 und höher müssen Sie StorageProvider und ConnectionString so einstellen , dass OpenSimulator eine Verbindung zu einer Datenbank herstellen kann. Normalerweise müssen Sie StandaloneCommon.ini für Standalone oder GridCommon.ini für den Rastermodus bearbeiten.

In diesen Dateien finden Sie den Abschnitt [DatabaseService]. Hier wird die Datenbank konfiguriert. Es gibt eine Reihe von Einträgen. Die einzigen Einträge, die unkommentiert werden sollten (durch Entfernen des Semikolons am Anfang), sind diejenigen, die für die gewünschte Datenbank zutreffen. Alle anderen müssen auskommentiert werden (indem Sie ein Semikolon vor der Zeile einfügen).

[edit] Beispiele

[edit] MySQL

Für MySQL kommentieren Sie die erforderlichen Zeilen und konfigurieren sie entsprechend. Zum Beispiel die Zeilen 

StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=opensimdb;User ID=opensim;Password=h0tgrits;Old Guids=true;"

In diesem Fall wird eine Verbindung zu einer MySQL-Datenbank namens opensimdb auf demselben Rechner hergestellt, auf dem der Simulator (localhost) läuft. Der Benutzer, der sich verbindet, ist opensim mit dem Kennwort h0tgrits.

[edit] PostgreSQL

Für PostgreSQL kommentieren Sie die erforderlichen Zeilen und konfigurieren sie entsprechend. Zum Beispiel die Zeilen 

StorageProvider = "OpenSim.Data.PGSQL.dll"
ConnectionString = "Data Source=localhost;Database=opensimdb;User ID=opensim;Password=h0tgrits;Port=5432;"

In diesem Fall wird eine Verbindung zu einer PostgreSQL-Datenbank namens opensimdb auf demselben Computer hergestellt, auf dem der Simulator (localhost) ausgeführt wird. Der Benutzer, der sich verbindet, ist opensim mit dem Kennwort h0tgrits. Wenn Sie die Portnummer in der PostgreSQL-Installation geändert haben, können Sie die Verbindungszeichenfolge "Port = 5432" hinzufügen, wobei 5432 in den installierten Port geändert werden kann.

  • Das PostgreSQL-Datenbankmodul ist nicht in Version 0.7.6. Es ist immer noch am Rande des Quellcodes.

[edit] SQLite

SQLite ist etwas anders. Stattdessen würden Sie die Zeile unkommentieren (oder unkommentiert lassen).

Oder Sie können andere INI-Dateien einschließen. Sie finden eine solche Zeile: 

Include-Storage = "config-include/storage/SQLiteStandalone.ini";

Nach dem Lesen dieser INI-Datei werden dann die Dateien config-include / storage / SQLiteStandalone.ini gelesen. Wenn Sie die Datei SQLiteStandalone.ini öffnen, finden Sie in den einzelnen Abschnitten StrageProvider- und ConnectionString-Zeilen. Da SQLite keine Einrichtung von Benutzern oder Kennwörtern erfordert, müssen keine weiteren Einstellungen vorgenommen werden, es sei denn, Sie möchten, dass sqlite andere Dateinamen für seine Datenbanken verwendet.

[edit] MSSQL

HINWEIS: Die MSSQL-Unterstützung wird in OpenSimulator 0.8.1 aufgehoben, da sie seit mehr als 2 Jahren nicht gewartet wurde und Fehler und Unterstützung für die neuesten OpenSimulator-Funktionen fehlen.

ANMERKUNG: Es gab eine andere Möglichkeit, eine Verbindung zur MSSQL-Datenbank herzustellen, die "mssql_connection.ini" im Verzeichnis bin / verwendet. Bei OpenSimulator 0.7.1 oder höher wird es NICHT gelesen, auch wenn Sie es richtig eingestellt haben. Verwenden Sie ConnectionString stattdessen in * Common.ini. Weitere Einzelheiten finden Sie im Abschnitt #MSSQL.

[edit] Database Parameters

Parameter Possible Values Description
StorageProvider "OpenSim.Data.SQLite.dll" (SQLite)
"OpenSim.Data.MySQL.dll" (MySQL)
"OpenSim.Data.PGSQL.dll" (PostgreSQL)
"OpenSim.Data.MSSQL.dll" (Microsoft SQL Server)
"OpenSim.Data.Null.dll" (disable persistence) 		Der Name der Speicheranbietermodule, die sich in bin / folder befinden. Die drei oben genannten werden von OpenSimulator offiziell unterstützt (obwohl MSSQL teilweise ist). Wenn Sie "OpenSim.Data.Null.dll" wählen, behält OpenSimulator alle Daten in seinem Speicher, anstatt DBMS zu verwenden.
ConnectionString See #ConnectionString Syntax Eine Zeichenfolge, die OpenSimulator Informationen zu einer Datenquelle angibt. Normalerweise kann es den Hostnamen oder die IP-Adressen des Datenbankservers, die Datenbankservicenamen, den Benutzernamen, den Schemanamen und das Kennwort enthalten. Die Syntax variiert zwischen Datenbanken.
EstateConnectionString See #ConnectionString Syntax Entspricht ConnectionString, wird jedoch nur für den Estate Service verwendet. (wahlweise)

[edit] ConnectionString Syntax

[edit] MySQL

Data Source=[1];Database=[2];User ID=[3];Password=[4];Old Guids=true;

  • [1] The hostname or ip address of database server
  • [2] Database name
  • [3] Username for the database above
  • [4] Password for the user above

Example: If you have created the database "opensim" in localhost, and then created the user "opensimuser" and its password is "opensimpassword", it will be: 

ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"

[edit] PostgreSQL

Data Source=[1];Database=[2];User ID=[3];Password=[4];Port=[5]

  • [1] The hostname or ip address of database server
  • [2] Database name
  • [3] Username for the database above
  • [4] Password for the user above
  • [5] Port number for the server (default=5432)

Example: If you have created the database "opensim" in localhost, and then created the user "opensimuser" and its password is "opensimpassword", and the server port number is 5435 it will be: 

ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;Port=5435"

[edit] SQLite

URI=file:[1],version=3,UseUTF16Encoding=True;

  • [1] The path to the database file (relative to the bin/ directory - If there is no file on this path, it will be created automatically)

Example: If you want to create the database for Inventory Service in the directory "bin/db", it will be: 

ConnectionString = "URI=file:db/inventory.db,version=3,UseUTF16Encoding=True"

[edit] MSSQL

Server=[1];Database=[2];User Id=[3]; password=[4];

  • [1] "servername\instance name" - You can see this string in SQL Server Managerment Studio login dialog(Server:).
  • [2] Database name
  • [3] Username for the database above
  • [4] Password for the user above

Example: If you have installed Microsoft SQL Server Express Edition with default settings on your local machine , created the database "opensim" in localhost, and then created the user "opensimuser" and its password is "opensimpassword", it will be: 

ConnectionString = "Server=localhost\SQLEXPRESS;Database=opensim;User Id=opensimuser; password=opensimpassword;"

[edit] Verwenden verschiedener Datenbankeinstellungen für verschiedene Dienste

Hinweis: Diese Konfiguration ist sehr fortgeschritten und muss sowohl für die ROBUST-Konfiguration als auch für die Standalone-Version (was hier impliziert wird) aktualisiert werden.

Für größere Grids ist es sehr zu empfehlen, die Dienste auf mehrere Datenbanken aufzuteilen.

Momentan gibt es mehrere Dienste im OpenSimulator.

  • [InventoryService]
  • [AssetService]
  • [AvatarService]
  • [AuthenticationService]
  • [UserAccountService]
  • [GridUserService]
  • [FriendsService]
  • [EstateDataStore]
  • [SimulationDataStore]
  • [PresenceService]
  • [AuthorizationService]
  • [GridService]

Sie können für jeden Dienst eine andere Datenbank verwenden, indem Sie die StorageProvider- und ConnectionString-Eigenschaften überschreiben, wie wir im Abschnitt "Allgemein" [DatabaseService] oben gesehen haben. Wenn Sie beispielsweise MySQL 'opensim' im Allgemeinen, MySQL 'opensim2' für Inventory Service und MSSQL für Authentication Service verwenden möchten, müssen Sie beispielsweise in StandaloneCommon.ini schreiben.

Beispiele: 

[DatabaseService]
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;Old Guids=true;"
...
[InventoryService]
ConnectionString = "Data Source=localhost;Database=opensim2;User ID=opensim;Password=***;Old Guids=true;"
...
[AuthenticationService]
...(another parameters for authentication service)...
StorageProvider = "OpenSim.Data.MSSQL.dll"
ConnectionString = "Data Source=(local);Database=opensim;User=opensim;password=********;"

Wenn OpenSimulator StorageProvider oder ConnectionString nicht in den Abschnitten der einzelnen Services finden kann, werden die im Abschnitt [DatabaseService] angegebenen verwendet. Wenn OpenSimulator alle gefunden hat, wird der Parameter in den Abschnitten der einzelnen Dienste verwendet. Die Einstellungen in diesen Abschnitten überschreiben dann die Einstellungen im Abschnitt [DatabaseService].

In diesem Fall führt der Inventarservice Folgendes aus:

  • read [DatabaseService]StorageProvider
  • read [DatabaseService]ConnectionString -> read [InventoryService]ConnectionString and override

Der Authentifizierungsdienst wird:

  • read [DatabaseService]StorageProvider -> read [AuthenticationService]StorageProvider and override
  • read [DatabaseService]ConnectionString -> read [AuthenticationService]ConnectionString and override

Hinweis: Anbieter von SQLite und MSSQL unterstützen einige Dienste nicht.

Hinweis: Für den Estate Service gibt es einen weiteren Parameter EstateConnectionString in [DatabaseService]. Dies ist die mittlere Priorität zwischen [DatabaseService] und [EstateDataStore] ConnectionStrings. OpenSimulator liest ConnectionString zuerst im Abschnitt [DatabaseService], als nächstes EstateConnectionString, schließlich ConnectionString im Abschnitt [EstateDataService] und überschreibt.

[edit] Quick Setup

[edit] SQLite-Komplettlösung

Standardmäßig erstellt OpenSimulator seine SQLite-Datenbankdateien (*.db) automatisch im Verzeichnis bin/. Sie müssen grundsätzlich nichts tun. Wenn Sie die Datenbankdateien in einem anderen Verzeichnis erstellen möchten, können Sie dies ändern, indem Sie ConnectionString in bin/config-include/storage/SQLiteStandalone.ini bearbeiten, das in config-include/*Commons.ini enthalten ist. Die detaillierte Syntax finden Sie im Abschnitt #SQLite.

[edit] MySQL-Komplettlösung

Bitte lesen sie die Anleitung für mysql speziell für ihr Betriebssystem.

Empfehlen kann ich die Ubuntu Anleitung für Linux: https://wiki.ubuntuusers.de/MySQL/

Bei Windows kann auch xampp benutzt werden (Bitte beachten sie die Warnungen): https://www.apachefriends.org/de/index.html

Ansonsten befolgen sie bitte die Anleitungen von Microsoft.

[edit] Download

Laden Sie „MySQL Community Server“ von MySQL-Downloadseite herunter und installieren Sie es. Unter Linux können Sie sogar „mysql-server“ oder „mysql-community-server“ mit Ihrem nativen Paketmanager abrufen.

[edit] MySQL Server installieren

Unter Windows: Laden Sie MSI herunter und führen Sie es aus. Wählen Sie „Typisch“. Nach der Installation wird der „MySQL Server-Instanzkonfigurationsassistent“ gestartet. Wählen Sie „Standardkonfiguration“. Im nächsten Bildschirm könnten Sie später zufrieden sein, wenn Sie „Bin-Verzeichnis in Windows-PFAD einbeziehen“ aktivieren. Geben Sie im nächsten Bildschirm das MySQL-Root-Passwort ein. Die Einstellungen für MySQL werden abgeschlossen und der Dienst wird automatisch gestartet. Weitere Einzelheiten finden Sie in der MySQL-Dokumentation.

Unter Mac OS X: Laden Sie das DMG-Paket herunter und installieren Sie es normal. Nach der Installation des Serverpakets können Sie sogar MySQL Startup Item installieren, wenn MySQL beim Systemstart automatisch gestartet werden soll. Starten Sie anschließend Ihr MySQL, indem Sie den folgenden Befehlen folgen. Weitere Einzelheiten finden Sie in der MySQL-Dokumentation.

MySQL muss so konfiguriert sein, dass es UTF8 als Standardzeichensatz verwendet. Fügen Sie in der Konfigurationsdatei /etc/my.cnf (Linux) oder my.ini (Windows) diese Einstellungen hinzu: 

 [mysqld]
 character-set-server=utf8

 [client]
 default-character-set=utf8

Und es ist betriebsbereit. 

 $ cd /usr/local/mysql
 $ sudo ./bin/mysqld_safe
 (enter your password, if necessary)
 (press ctrl-Z)
 $ bg
 (press ctrl-D or enter "exit" to exit the shell)

Unter Linux: RPM installieren Sie das heruntergeladene Paket oder installieren Sie „mysql-server“ oder „mysql-community-server“ mit Ihrem Paketmanager. Weitere Anweisungen zur Installation finden Sie in der MySQL-Dokumentation. Starten Sie anschließend MySQL mit dem folgenden Befehl. 

$ /etc/init.d/mysqld start

Wenn Sie den MySQL-Server automatisch starten möchten, lesen Sie 2.10.1.2. MySQL automatisch starten und stoppen im MySQL 5.5-Referenzhandbuch].

[edit] MySQL-Datenbank erstellen

Jetzt können Sie Ihr MySQL mit den Befehlszeilentools konfigurieren. 

$ mysql -u root --password
(Geben Sie Ihr Passwort ein. Wenn Sie kein Passwort für den MySQL-Server festgelegt haben, geben Sie stattdessen „mysql -u root“ ein.)

Sie können den MySQL-Befehlszeilenclient sogar im Startmenü von Windows verwenden. Erstellen Sie nach der Anmeldung einen Benutzer und eine Datenbank für OpenSimulator. 

mysql> create database opensim;
mysql> use opensim;
mysql> create user 'opensimuser'@'localhost' identified by 'opensimpassword';
mysql> grant all on opensim.* to 'opensimuser'@'localhost';
mysql> quit

[edit] OpenSimulator konfigurieren

Öffnen Sie StandaloneCommon.ini oder GridCommon.ini mit Ihrem Editor. Kommentieren Sie zunächst die Zeile für SQLite aus. 

; SQLite
;Include-Storage = "config-include/storage/SQLiteStandalone.ini";

Entfernen Sie anschließend die Kommentarzeichen für die Eigenschaftenzeilen StorageProvider und ConnectionString im Abschnitt [DatabaseService] und ändern Sie die Zeile wie folgt: 

; MySql
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"

Beachten Sie, dass "Data Source=localhost;" Gibt tatsächlich einen TCP-Socket an. Wenn Ihr MySQL-Server so eingerichtet ist, dass er Remoteverbindungen ablehnt (d. h. mit aktiviertem Skip-Networking), müssen Sie „localhost“ durch den Pfad zum UNIX-Socket von MySQL ersetzen. 

ConnectionString = "Data Source=/var/run/mysqld/mysqld.lock;Database=opensim;User ID=opensimuser;Password=opensimpassword;Old Guids=true;"

Den Pfad zu dem Socket, den Ihr MySQL-Server verwendet, finden Sie mit mysqladmin. 

$ mysqladmin -p -u root version

Speichern und starten Sie OpenSimulator. Es greift auf Ihre neue MySQL-Datenbank statt auf die Standard-SQLite-Datenbanken zu.

[edit] PostgreSQL-Komplettlösung

[edit] Was ist PostgreSQL

  • Relationale Datenbank
  • Weltweit aktive Community
  • Zahlreiche Features und Funktionen (Foreign Keys,Transaktionen, Trigger)
  • PostgreSQL kann mehrere Indexe pro Anfrage verwenden
  • Läuft auf zahlreichen Betriebssystemen und diverser Hardware
  • Weitgehendes Einhalten der SQL-Standards – Dokumentation der Abweichungen
  • Aktuelle Version: 16.1; (9. November 2023)
  • Betriebssystem: Unix-Derivate, Linux, Microsoft Windows, macOS
  • Entwickler: PostgreSQL Global Development Group
  • Kategorie: Datenbanksystem, Server
  • Lizenz: PostgreSQL Lizenz vergleichbar der BSD-Lizenz oder der MIT-Lizenz

[edit] Herunterladen

Laden Sie den PostgreSQL-Server von PostgreSQL-Downloadseite herunter und installieren Sie es.

PostgreSQL ist in den meisten Linux-Distributionen enthalten, allerdings oft in der Version, die bei Erscheinen des Release aktuell war.

Aktuellere Versionen gibt es für viele Linux-Distributionen in von der PostgreSQL Developer Group bereitgestellten Repositorien.

Apple liefert von der Version Mac OS X Lion (10.7) an PostgreSQL als Standarddatenbank aus.

[edit] Anleitungen

PostgreSQL Handbuch Englisch

how to install postgresql on ubuntu 22.04 Englisch

Datenbanken von MySQL zu PostgreSQL portieren Deutsch

Converting from other Databases to PostgreSQL Englisch

[edit] Konvertieren einer MySQL OpenSim Grid Datenbank in PostgreSQL mit pg_chameleon

Die Verwendung von pg_chameleon erleichtert den Prozess des Datenbank-Migrations erheblich.

Dieses Werkzeug ist darauf spezialisiert, Daten aus MySQL in PostgreSQL zu replizieren.

Hier ist eine Anleitung, wie Sie pg_chameleon für die Konvertierung Ihrer MySQL OpenSim Grid Datenbank verwenden können:

Vorbereitung:

Installation von PostgreSQL: Stellen Sie sicher, dass PostgreSQL auf Ihrem System installiert ist.

PostgreSQL Datenbank und Benutzer erstellen: Erstellen Sie eine leere PostgreSQL-Datenbank und einen Benutzer mit den notwendigen Berechtigungen.

bash: 

    createdb mygrid
    createuser mygriduser

MySQL und PostgreSQL Bibliotheken installieren:

Stellen Sie sicher, dass die notwendigen Bibliotheken installiert sind:

Für MySQL: libmysqlclient-dev Für PostgreSQL: libpq-dev

bash: 

    sudo apt-get install libmysqlclient-dev libpq-dev

pg_chameleon installieren:

Befolgen Sie die Anweisungen auf der pg_chameleon GitHub-Seite oder verwenden Sie den folgenden Befehl:

bash: 

    pip install pg_chameleon

MySQL- und PostgreSQL-Verbindung konfigurieren:

Bearbeiten Sie die Konfigurationsdatei von pg_chameleon, um die Verbindungsdaten für MySQL und PostgreSQL festzulegen.

bash: 

    nano /path/to/pg_chameleon/etc/chameleon.conf

Konfigurieren Sie die Abschnitte [source] für MySQL und [destination] für PostgreSQL.

Konvertierungsschritte:

Schema erstellen:

Führen Sie den Befehl aus, um das Schema in der PostgreSQL-Datenbank zu erstellen.

bash: 

    chameleon.py create_schema -C /path/to/pg_chameleon/etc/chameleon.conf

Replikation starten:

Starten Sie die Replikation mit dem Befehl:

bash: 

    chameleon.py start --detach -C /path/to/pg_chameleon/etc/chameleon.conf

Dies startet den Replikationsprozess im Hintergrund.

Datenbank optimieren:

Überprüfen Sie die PostgreSQL-Datenbank auf mögliche Optimierungen, insbesondere Indizes und Schlüssel.

Tests durchführen:

Führen Sie umfassende Tests durch, um sicherzustellen, dass alle OpenSim-Grid-Funktionen ordnungsgemäß funktionieren.

Zusätzliche Hinweise:

Überwachen Sie die Logs von pg_chameleon, um eventuelle Fehler oder Warnungen während der Replikation zu identifizieren.

Stellen Sie sicher, dass die Replikation abgeschlossen ist, bevor Sie die MySQL-Datenbank in der Produktionsumgebung abschalten.

Konsultieren Sie die Dokumentation von pg_chameleon für detailliertere Konfigurationsoptionen und Problemlösungen.

Diese Anleitung bietet einen allgemeinen Überblick über den Prozess.

Bitte passen Sie die Schritte entsprechend Ihrer spezifischen Umgebung an

und berücksichtigen Sie die individuellen Anforderungen Ihrer OpenSim-Grid-Implementierung.

[edit] MSSQL Walkthrough

[edit] Download

To download Microsoft SQL Server 2008 Express edition: [1] Make sure you download Microsoft SQL Server 2008 Express with Tools ([2]) since you will likely want a nice tool to work with your database. If you already downloaded Microsoft SQL Server before, skip to "Checking Instance Configurations" step.

[edit] Installing Microsoft SQL Server

Double-click the downloaded executable and select click Installation and "New SQL Server stand-alone installation or add features to an existing installation". It will start installation process, you only need to click "OK", "Next" or "Install" until you come across the "Feature Selection". In this screen, you need to check "Database Engine Service" and "Management Tools - Basic", then click "Next". In next screen "Instance Configuration", check what is filled in "Named instance:" property - you will later use this later. For example, for default Express Edition, you'll see "SQLEXPRESS". Click "Next". Then go on default until you reach "Server Configuration". In this screen, fill in Account Name and Password field with you windows login name and password. In next "Database Engine Configuration" screen, you will need to enable Mixed Mode. After that provide password, click "Add Current User", and then continue clicking "Next" or "OK" until it completes the installation process. After that, you'll find the entry "SQL Server Managerment Studio" in "Microsoft SQL Server 2008" on the Windows Start menu. Open it and click "connect" to connect to your instance.

[edit] Checking Instance Configurations

Right-click on your database server in Management Studio and select Properties, then go to the Security tab and select SQL Server and Windows Authentication mode, click OK. If you have already installed SQL Server before and you find "Windows Authentication mode" enabled instead, change it.

[edit] Creating User for Database

Expand the Security node, then right-click the Logins node. Select "New Login..." to open "Login - New" dialog. In this screen, fill "Login name" with the string whatever you like, select "SQL Server authentication", give it a strong password, uncheck "User must change password at next login", and click "OK". In this tutorial, we'll assume you have typed "opensimuser" for Login name, and "opensimpassword" for password.

[edit] Creating Database

Right-click on the Databases node and and select "New Database..." to open "New Database" dialog. In "Database name" field, you provide any names for the new database, which we'll assume is "opensim". In "Owner" field, provide the name of newly created database user("opensimuser" in this tutorial). Accept all defaults and click "OK".

[edit] Configuring OpenSimulator

Open StandaloneCommon.ini or GridCommon.ini with your editor. First, comment-out the line for SQLite. 

; SQLite
;Include-Storage = "config-include/storage/SQLiteStandalone.ini";

After that, add these line in [DatabaseService] section. As of OpenSimulator 0.7.1, there is no sample configurations for MSSQL(Microsoft SQL Server), so you need to add them by yourself. 

; MSSQL
StorageProvider = "OpenSim.Data.MSSQL.dll"
ConnectionString = "Server=localhost\SQLEXPRESS;Database=opensim;User Id=opensimuser; password=opensimpassword;"

Save and start OpenSimulator. It will access to your new SQL Server database instead of the default SQLite databases.

[edit] Additional Settings

[edit] MySQL

MySQL's own configuration is handled in its my.ini file (found in "C:\ProgramData\MySQL\MySQL Server x.y" on recent versions of MySQL on Windows) or my.cnf file (found at /etc/mysql/my.cnf on Ubuntu Linux systems, for instance).

In general, the default configuration is fine for OpenSimulator. However, you may want to check the max_allowed_packet size. Very large objects, such as linksets with a very large number of parts or large mesh objects may generate OpenSimulator assets that exceed the default BLOB size that MySQL can store. On Ubuntu the max_allowed_packet size is 16M, which should be fine. On Windows MySQL it can be set larger. In early versions of MySQL the default is 1M which may be too small. Windows 5.6 MySQL default is 4M.

Notes: OSGrid maximum asset size is reported as 45MB at May 2013. Openvue grid maximum asset size is reported as 16MB as at May 2013.

To change this setting, one would add a line like the following in the [mysqld] section of the my.ini or my.cnf file. E.g., 

max_allowed_packet  = 16M

On Ubuntu 14.04.1 with MySQL latest, this setting was already found to be 16M.

Retrieved from "http://opensimulator.org/index.php?title=Database_Settings/de&oldid=54172"
Personal tools
General
About This Wiki