Chapitre 2 – Faire les paramêtrages de la base de données pour Opensim

On va maintenant faire comprendre au serveur de monde ( Opensim.exe ) qu’il faut ne plus utiliser la base de données par défaut ( SqLite ) mais notre nouvelle base crée sur EasyPHP.

1 – créer un fichier “mysql_connection.ini” ( Sous la version 0.6.6 il as disparu ?! : voir le commentaire de ech18 en fin d’article ) :
Le voila :

; The IniConfig.cs that parses this file by just finding the first key={value} in the whole text so comments aren’t really honoured.
; Also, this algorithm can probably lead to ‘amusing’ results in unfortunate cases.

[mysqlconnection]
hostname=localhost
database=opensim
username=opensim
password=opensim
pooling=false
port=3306

; These entries are only for if you, for some reason, wish to customize your user server table names.
; Do note that if you change the table names, you might have to change the sql resources too manually
; If ommitted, default values will be used.

userstablename=users
userfriendstablename=userfriends
agentstablename=agents

Les textes avec un “;” en premier c’est du blabla
Dans l’article “les paquets” vous le trouverez tout prêt
mettre ce fichier dans c:\program files\Opensim

2 – Modifier le fichier “OpenSim.ini” dans c:\program files\Opensim :
Alors là faire une copie de ce fichier ( vu le nombre de fois ou je l’ai n….. ! )

Plusieurs modif à faire : dans les sections “startup, zone : STORAGE” , “StandAlone” , “Network” , “GridInfo” et “Architecture”
une section ça commence par :

[startup]

Une zone par :

; ##
; ## STORAGE
; ##

2.1 – STORAGE ( classement, rangement, etc… là ou opensim va lire la base de données )

il faut enlever les “;” sur :

storage_plugin=”OpenSim.Data.MySQL.dll”
storage_connection_string=”Data Source=localhost;Database=opensim;User ID=opensim;Password=opensim;”;

estate_connection_string=”Data Source=localhost;Database=opensim;User ID=opensim;Password=opensim;”;

( Au passage bien mettre à jour les database=, User Id= et Password= )
et en mettre devant ( des “;” ) :

storage_plugin = “OpenSim.Data.SQLite.dll”
storage_connection_string=”URI=file:OpenSim.db,version=3″;

2.1 bis au passage modifier :

; Choose one of the physics engines below
physics = basicphysics
;physics = POS
;physics = OpenDynamicsEngine
;physics = modified_BulletX

et

; ##
; ## WORLD MAP
; ##

WorldMapModule = “WorldMap”
MapImageModule = “MapImageModule”

2.2 – StandAlone

Modifier les lignes suivantes comme suit :

welcome_message = “Welcome to OpenSimulator”

mettre par exemple entre les ” : Bienvenue dans mon petit monde”

mettre un “;” devant :

inventory_plugin = “OpenSim.Data.SQLite.dll”
inventory_source = “URI=file:inventoryStore.db,version=3″
userDatabase_plugin = “OpenSim.Data.SQLite.dll”
user_source = “URI=file:userprofiles.db,version=3″

et enlver le “;” devant :

inventory_plugin = “OpenSim.Data.MySQL.dll”
inventory_source = “Data Source=localhost;Database=opensim;User ID=opensim;Password=opensim;”
userDatabase_plugin = “OpenSim.Data.MySQL.dll”
user_source = “Data Source=localhost;Database=opensim;User ID=opensim;Password=opensim;”

( Au passage bien mettre à jour les database=, User Id= et Password= )

2.3 – Network

modifier :

grid_server_url = “http://127.0.0.1:8001″
grid_send_key = “null”
grid_recv_key = “null”

user_server_url = “http://127.0.0.1:8002″
user_send_key = “null”
user_recv_key = “null”

asset_server_url = “http://127.0.0.1:8003″

inventory_server_url = “http://127.0.0.1:8004″

; The MessagingServer is a companion of the UserServer. It uses
; user_send_key and user_recv_key, too
messaging_server_url = “http://127.0.0.1:8006″

par :

grid_server_url = “http://192.168.1.67:8001″
grid_send_key = “null”
grid_recv_key = “null”

user_server_url = “http://192.168.1.67:8002″
user_send_key = “null”
user_recv_key = “null”

asset_server_url = “http://192.168.1.67:8003″

inventory_server_url = “http://192.168.1.67:8004″

; The MessagingServer is a companion of the UserServer. It uses
; user_send_key and user_recv_key, too
messaging_server_url = “http://192.168.1.67:8006″

avec votre adresse IP de votre serveur ( par exemple 192.168.1.67 chez moi )

2.4 – GridInfo

Remplacer :

; login uri: for grid this is the user server URI
login = http://127.0.0.1:9000/

; long grid name: the long name of your grid
gridname = “the lost continent of hippo”

; short grid name: the short name of your grid
gridnick = “hippogrid”

; login page: optional: if it exists it will be used to tell the client to use
; this as splash page
; currently unused
;welcome = http://127.0.0.1/welcome

; helper uri: optional: if it exists if will be used to tell the client to use
; this for all economy related things
; currently unused
;economy = http://127.0.0.1:9000/

; web page of grid: optional: page providing further information about your grid
; currently unused
;about = http://127.0.0.1/about/

; account creation: optional: page providing further information about obtaining
; a user account on your grid
; currently unused
;register = http://127.0.0.1/register

; help: optional: page providing further assistance for users of your grid
; currently unused
;help = http://127.0.0.1/help

; password help: optional: page providing password assistance for users of your grid
; currently unused
;password = http://127.0.0.1/password

par :

; login uri: for grid this is the user server URI
login = http://192.168.1.67:8002/

; long grid name: the long name of your grid
gridname = “La petite grille”

; short grid name: the short name of your grid
gridnick = “Maison”

; login page: optional: if it exists it will be used to tell the client to use
; this as splash page
; currently unused
;welcome = http://192.168.1.67/welcome

; helper uri: optional: if it exists if will be used to tell the client to use
; this for all economy related things
; currently unused
;economy = http://192.168.1.67:9000/

; web page of grid: optional: page providing further information about your grid
; currently unused
;about = http://192.168.1.67/about/

; account creation: optional: page providing further information about obtaining
; a user account on your grid
; currently unused
;register = http://192.168.1.67/register

; help: optional: page providing further assistance for users of your grid
; currently unused
;help = http://192.168.1.67/help

; password help: optional: page providing password assistance for users of your grid
; currently unused
;password = http://192.168.1.67/password

toujours la même chose ( ceci ne sert pas pour tout de suite )

2.5 – Architecture

Remplacer :

Include-Standalone = “config-include/Standalone.ini”
;Include-HGStandalone = “config-include/StandaloneHypergrid.ini”
;Include-Grid = “config-include/Grid.ini”
;Include-HGGrid = “config-include/GridHypergrid.ini”

; Then choose
; config-include/StandaloneCommon.ini.example (if you’re in standlone) OR
; config-include/GridCommon.ini.example (if you’re connected to a grid)
; Copy to your own .ini there (without .example extension) and edit it
; to customize your data

par :

;Include-Standalone = “config-include/Standalone.ini”
;Include-HGStandalone = “config-include/StandaloneHypergrid.ini”
Include-Grid = “config-include/Grid.ini”
;Include-HGGrid = “config-include/GridHypergrid.ini”

; Then choose
; config-include/StandaloneCommon.ini.example (if you’re in standlone) OR
; config-include/GridCommon.ini.example (if you’re connected to a grid)
; Copy to your own .ini there (without .example extension) and edit it
; to customize your data

3 – Modifier le fichier “GridCommon.ini” dans c:\Program files\Opensin\config-include :

Remplacer :

;
; change this to your grid-wide asset server
;
AssetServerURI = “http://myassetserver.com:8003“

[InventoryService]
;
; change this to your grid-wide asset server
;
InventoryServerURI = “http://myassetserver.com:8004“

par :

;
; change this to your grid-wide asset server
;
AssetServerURI = “http://192.168.1.67:8003“

[InventoryService]
;
; change this to your grid-wide asset server
;
InventoryServerURI = “http://192.168.1.67:8004“

4 – Vérifier si le fichier “Grid.ini” est bien dans c:\Program files\Opensin\config-include :

5 – Attention aux essais en mode local du premier chapitre :
Allez dans c:\Program files\Opensin\regions et supprimer la ou les régions d’essai

5 – On lance le serveur ( “OpenSim.exe” ) double clic dessus
Oui Oui on lance en mode local et pas en mode grid ! ( ceci pour être sur que ça marche )
le serveur …. re bla bla
dès le début vous devriez voir des différences ( par exemple une trentaine de ligne de migrations de regions ), le serveur met en place les tables dans notre base de données.
Arrêt comme dans l’autre mode pour créer la région de base, par contre 2 petites différences :

[bienvenue]
RegionUUID = 9ff16648-1f13-41cf-9c94-f6c97315bd19
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.67

InternalAdress : mettre 0.0.0.0
ExternalHostName : mettre l’adresse IP local de votre machine ( moi 192.168.1.67, j’ai 67 ordi )

C’est fini, allez dans l’administration de EasyPHP pour voir la création des tables :

Dans l’article “le paquet” vous trouverez le fichier “fichierconfigOS.zip” qui contient les fichiers de cette partie.
Tout ces modifications ont permis à OpenSim de communiquer avec la base de données MySql