« Simulateur Autonome Hors réseau MySQL : tuto détaillé » : différence entre les versions

De OSWiki
Aller à la navigation Aller à la recherche
 
(14 versions intermédiaires par le même utilisateur non affichées)
Ligne 13 : Ligne 13 :
|-
|-
|[[#Gestion de la carte graphique|Carte graphique]]
|[[#Gestion de la carte graphique|Carte graphique]]
|[[#Lancement du simulateur|Lancement]]
|[[#Lancement|Lancement]]
|-
|-
|[[#Installation de Mono|Mono]]
|[[#Installation de Mono|Mono]]
|[[#Connexion à la simulation (région)|Connexion]]
|[[#Se connecter à la simulation (région)|Connexion]]
|-
|-
|[[#Installation du serveur MySQL|MySQL]]
|[[#Installation du serveur MySQL|MySQL]]
|[[#Sauvegarder une région|Sauvegarde]]
|[[#Sauvegarder une région|Sauvegarde]]
|}
|}
=Préparation du PC=
=Préparation du PC=
 
<gallery>
Fichier:Ordinateur-non-connecte.png
</gallery>
==Ressources nécessaires==
==Ressources nécessaires==
{{Modèle:Ressources PC hors connexion}}
{{Modèle:Ressources PC hors connexion}}
==Le système d'exploitation==
==Le système d'exploitation==
 
{{Modèle:système exploitation PC}}
Vous pouvez installer d'autres distributions Linux ou d'autres versions plus récentes d'Ubuntu, mais les types de systèmes proposés ci-dessous sont ceux décrits par  OSWiki. Avec d'autres versions vous serez peut-être confrontés à certaines variations plus ou moins importantes.
 
===Télécharger {{Modèle:OS_PC}} pour un  ordinateur===
Choisissez la version qui convient au type de processeur de votre ordinateur.
*[{{Modèle:URL_OS_PC_32}} Télécharger {{Modèle:OS_PC}} (32bits)]
*[{{Modèle:URL_OS_PC_64}} Télécharger {{Modèle:OS_PC}} (64bits)]
 
===Installer votre système d'exploitation===
Ce wiki n'est pas destiné à expliquer comment installer Ubuntu. Veuillez vous référer à la documentation de la distribution :
* [{{Modèle:OS_Doc_fr}}  Documentation française ]
* [{{Modèle:OS_PC_guide}} Guide d'installation de {{Modèle:OS_PC}} ]
 
===Mise à jour des serveurs===
Pour ouvrir un terminal dans Ubuntu tapez sur les tourches '''Ctrl+Alt+T'''.
 
{{Modèle:Mise_a_jour_serveur}}
 
==Gestion de la carte graphique==
==Gestion de la carte graphique==
Dans la configuration d'un simulateur non connecté au réseau, vous allez vous connecter au monde 3D depuis ce même ordinateur.
Dans la configuration d'un simulateur non connecté au réseau, vous allez vous connecter au monde 3D depuis ce même ordinateur.
Pour cela il faudra une carte graphique et son driver.
Pour cela il faudra une carte graphique et son driver.
{{Modèle: Gestion de la carte graphique}}
{{Modèle: Gestion de la carte graphique}}
==Installation de Mono ==
==Installation de Mono ==
===Qu'est-ce que Mono ?===
{{Modèle:installer Mono}}
OpenSimulator est développé en C# (C Sharp). Le C# est un langage de programmation orienté objet, commercialisé par Microsoft depuis 2002 et destiné au développement sur la plateforme Microsoft .NET.
 
Mono est une mise en œuvre open source de la plateforme de développement Microsoft .NET. Mono peut être utilisé sous GNU/Linux, Microsoft ou MacOS.
 
===Installation de Mono sur Ubuntu ===
 
Dans un terminal tapez la commande :
 
sudo apt-get install mono-complete
 
==Installation du serveur MySQL==
==Installation du serveur MySQL==
'''MySQL''' est un Système de Gestion de Base de Données (SGBD) utilisé par OpenSimulator. SQLite est le SGBD par défaut des simulateurs OpenSim.
{{Modèle:installation MySQL}}
 
Pour installer MySQL taper la commande suivante dans un terminal (vous devez avoir les droits d'administration de votre machine) :
 
sudo apt-get install mysql-server
 
Un mot de passe vous sera demandé pour le serveur de bases de données.
 
{{Modèle:Création de la base de données|Type=Simulateur|Domaine=localhost}}
{{Modèle:Création de la base de données|Type=Simulateur|Domaine=localhost}}


=Le Simulateur=
=Le Simulateur=
==Installation d'OpenSimulator==
==Installation d'OpenSimulator==
*Téléchargez OpenSimulator depuis ce lien : {{Modèle : Version actuelle d'OpenSimulator}}
{{Modèle : installer OpenSim}}
*Décompresser l'archive d'OpenSimulator
tar -xvzf {{Modèle : Version actuelle d'OpenSimulator}}
 
Vous pouvez supprimer l'archive compressée et renommer le dossier (par exemple opensim). Faisons l'hypothèse que vous avez téléchargé OpenSimulator dans le dossier "Téléchargements" de votre installation.
 
*'''Depuis Nautilus''', explorateur de fichier d'Ubuntu, cherchez dans votre dossier utilisateur (home/<utilisateur>) le dossier "Téléchargements" puis, supprimez le fichier opensim-<version>.tar.gz et renommez le dossier décompressé.
 
*Vous pouvez faire cela en '''lignes de commande'''. Tapez lez commandes suivantes dans un terminal en remplaçant <version> par la version d'opensim installée.
 
cd Téléchargements
rm {{Modèle : Version actuelle d'OpenSimulator}}
mv opensim-<version> opensim
 
==Configuration==
==Configuration==
Nous allons indiquer à OpenSim que nous voulons utiliser une base de données MySQL à la place se la base de données par défaut SQLite.
{{Modèle:config opensim mysql|fichier=StandaloneCommon}}
 
Éditer le fichier StandaloneCommon.ini contenu dans le dossier /bin/config-includes/ de votre installation OpenSimulator. Vous pouvez utiliser l'éditeur de texte Gedit.
 
En haut du fichier vous pouvez vois les deux lignes suivantes.
; SQLite
; Include-Storage = "config-include/storage/SQLiteStandalone.ini";
 
 
La deuxième ligne active l'utilisation du SGBD SQLite, ce que nous ne voulons plus. Ainsi, nous allons commenter cette ligne avec un point virgule. Ce qui donnera :
; SQLite
Include-Storage = "config-include/storage/SQLiteStandalone.ini";
 
Maintenant, nous allons activer l'utilisation d'un SGBD MySQL et nous allons indiquer les paramètres de connexion à la base de données créée dans le chapitre précédent. Un peu plus bas vous pouvez voir  le lignes :
 
; MySql
; Uncomment these lines if you want to use mysql storage
; Change the connection string to your db details
; StorageProvider = "OpenSim.Data.MySQL.dll"
; ConnectionString = "Data Source=localhost;Database=test;User ID=new;Password=newNEW;Old Guids=true;"
 
Nous allons décommenter les deux dernières lignes et indiquer dans la dernière les paramètres de connexion à la base de données du simulateur. Ce qui donner :
 
; MySql
; Uncomment these lines if you want to use mysql storage
; Change the connection string to your db details
  StorageProvider = "OpenSim.Data.MySQL.dll"
  ConnectionString = "Data Source=localhost;Database=<{{Modèle:Nom bdd Simulateur}}>;User ID=<{{Modèle:Nom user bdd Simulateur}}>;Password=<mot de passe>;Old Guids=true;"
 
Enresgistrer votre fichier. Nous avons terminé la configuration d'OpenSimulator.
Enresgistrer votre fichier. Nous avons terminé la configuration d'OpenSimulator.


==Lancement==
==Lancement==
Dans un terminal lancer les commandes suivantes :
{{Modèle: lancement simulateur sur pc
cd /home/<utilisateur>/Téléchargements/opensim/bin
|coordonnées = Entrée
mono OpenSim.exe
|IP interne = Entrée
 
|port = Entrée
Des informations sur le déroulement du lancement du simulateur s'affichent dans la console.
|IP externe = Entrée
Le défilement s'arrête de temps en temps pour poser des questions auxquelles vous répondrez ainsi:(vous donnerez ces informations seulement au premier lancement du simulateur.)
|domaine = Entrée
 
|prénom = Vous pouvez donner un prénom à votre avatar ou garder Test  
{|class="wikitable"
|nom = Vous pouvez donner un nom à votre avatar ou garder User  
!Questions
|mdp = Entrez un mot de passe
!Réponses
|email = Entrée
|-
|enregistrement = dans la base de données du simulateur
|New region name []:
}}
|Donner un nom à votre région.
|-
|RegionUUID [27bcc083-cf9f-4116-b962-01e3255961ab]:
|Entrée pour définir cette valeur
|-
|Region Location [1000,1000]:
|Entrée
|-
|Internal IP address [0.0.0.0]:
|Entrée
|-
|Internal port [9000]:
|Entrée
|-
|Resolve hostname to IP on start (for running inside Docker) [False]:
|Entrée
|-
|External host name [SYSTEMIP]:
|Entrée
|-
|New estate name [My Estate]:
|Entrée
|-
|Estate owner first name [Test]:
|Vous pouvez donner un prénom à votre avatar ou garder Test
|-
|Estate owner last name [User]:
|Vous pouvez donner un nom à votre avatar ou garder User
|-
|Password:
|Entrez un mot de passe
|-
|Email:
|Entrée
|-
|User ID [1bcffbc4-590d-4905-b6e7-592febdb4b65]:
|Entrée
|}
Ces informations seront enregistrées dans le fichier /bin/Regions/Regions.ini et dans la base de données du simulateur.
 
==Se connecter à la simulation (région)==
==Se connecter à la simulation (région)==
===Installer un navigateur 3D===
===Installer un navigateur 3D===
Téléchargez soit Singularity soit Firestorm
{{Modèle:installer viewer}}
* [http://www.singularityviewer.org/ viewer Singularity]
* [http://www.firestormviewer.org/ viewer Firestorm]
 
Décompresser l'archive du navigateur
tar -xvzf <archive_du_navigateur_3D>.tar.gz
 
===Se connecter avec le navigateur 3D===
===Se connecter avec le navigateur 3D===
{{Modèle:Viewer première connexion}}
{{Modèle:Viewer première connexion|type=Local Host}}
==Sauvegarder une région==
==Sauvegarder une région==
===Archive de la région===
===Archive de la région===
{{Modèle:Générer un OAR}}
{{Modèle:Générer un OAR}}
===Sauvegarde de la base de données===
===Sauvegarde de la base de données===
 
{{Modèle: Sauvegarde bdd simu}}
Pour sauvegarder la base de données tapez la commande suivante dans un terminal (bdd_simulation correspond au {{Modèle:Nom bdd Simulateur}}):
mysqldump -u root -p bdd_simulation > bdd_simulation_backup.sql
 
Si vous devez restaurer une base de données, tapez la commande suivante dans un terminal en remplaçant "chemin" et "bdd_simulation" comme il se doit:
mysql -u root -p bdd_simulation < /chemin/bdd_simulation.sql

Version actuelle datée du 26 décembre 2017 à 13:13


Le PC La simulation
Ressources Installation
Système d'exploitation Configuration
Carte graphique Lancement
Mono Connexion
MySQL Sauvegarde

Préparation du PC

Ressources nécessaires

Ressources pour lancer un simulateur

CPU Une règle approximative de base consiste à dire qu'il faudrait avoir un core par région normalement utilisée avec un total minimum de 2 cores. Mais on peut utiliser moins de CPU, si la simulation accueille un ou très peu d'avatars et s'il n'y a pas beaucoup de scripts.

Voir [1]

Mémoire En règle générale, une région avec beaucoup d'avatars, 15000 ou plus de primitives et 2000 scripts peut utiliser 1 Go de mémoire. Dans le cas d'un simulateur hors réseau, les régions ne seront pas occupées par beaucoup d'avatars.
Disque dur Un disques durs de bureau ( 7200 trs/min, 3.5") devraient suffire.

Voir [2]

Ressources minimales pour utiliser un viewer

  • Machine : le navigateur 3D (viewer) sera installé sur le même ordinateur.
  • CPU :Dual-core avec un support SSE2
  • Carte graphique NVidia ou ATI/AMD graphics chip,
  • RAM : 2GB RAM,
  • Exemples de viewers :

Le système d'exploitation

Vous pouvez installer d'autres distributions Linux ou d'autres versions plus récentes d'Ubuntu, mais les types de systèmes proposés ci-dessous sont ceux décrits par OSWiki. Avec d'autres versions vous serez peut-être confrontés à certaines variations plus ou moins importantes.

Télécharger Ubuntu Desktop 20.04 LTS pour un ordinateur

Choisissez la version qui convient au type de processeur de votre ordinateur.

Installer votre système d'exploitation

Ce wiki n'est pas destiné à expliquer comment installer Ubuntu. Veuillez vous référer à la documentation de la distribution :

Mise à jour des serveurs

Pour ouvrir un terminal dans Ubuntu tapez sur les tourches Ctrl+Alt+T.

Après avoir installé votre serveur, tapez les commandes suivantes dans un terminal :

sudo apt update
sudo apt upgrade
sudo apt-get autoremove

Gestion de la carte graphique

Dans la configuration d'un simulateur non connecté au réseau, vous allez vous connecter au monde 3D depuis ce même ordinateur. Pour cela il faudra une carte graphique et son driver. Ci-dessous, vous trouverez quelques liens qui vous aiderons à configurer votre carte graphique sous Ubuntu. Peut-être que vous n'y trouverez pas les informations dont vous avez besoin. Dans ce cas, faites des recherches sur internet, dans la documentation Ubuntu, vous trouverez probablement la réponse à vos questions. Vous pouvez également poser des questions sur le canal IRC #ubuntu-fr ou #ubuntu.

Installation de Mono

Qu'est-ce que Mono ?

OpenSimulator est développé en C# (C Sharp). Le C# est un langage de programmation orienté objet, commercialisé par Microsoft depuis 2002 et destiné au développement sur la plateforme Microsoft .NET.

Mono est une mise en œuvre open source de la plateforme de développement Microsoft .NET. Mono peut être utilisé sous GNU/Linux, Microsoft ou MacOS.

Installation de Mono sur Ubuntu

Dans un terminal tapez la commande :

sudo apt-get install mono-complete

Installer une nouvelle version

Parfois la version de Mono de votre système d'exploitation ne fonctionne pas. Par exemple si votre version est inférieur à mono 5.12 et que vous avez installé OpenSim supérieur ou égal à 0.9.1.

Dans ce cas il faudra désinstaller la version de mono de votre système et Installer la version dont vous avez besoin. Voir [3]

Versions de Mono : https://download.mono-project.com/sources/mono/

Installation du serveur MySQL

MySQL est un Système de Gestion de Base de Données (SGBD) utilisé par OpenSimulator. SQLite est le SGBD par défaut des simulateurs OpenSim.

Pour installer MySQL taper la commande suivante dans un terminal (vous devez avoir les droits d'administration de votre machine) :

sudo apt-get install mysql-server 

Un mot de passe vous sera demandé pour le serveur de bases de données.

Création de la base de données

  • Se connecter à MySQL depuis un terminal en mode administrateur.
mysql -u <utilisateur> -p 

Il n'est plus nécessaire de renseigner le mot de passe mais il faut par contre lancer la commande mysql avec l'utilisateur correspondant.

  • Depuis l'invite MySQL, créer une base de données.
CREATE DATABASE <Nom de la bdd du simulateur>;
  • Créer un utilisateur pour la base de données :
CREATE USER "<Nom de l'utilisateur de la bdd du simulateur>"@"localhost";
  • Créer le mot de passe de l'utilisateur.
SET password FOR "<Nom de l'utilisateur de la bdd du simulateur>"@"localhost" = password('<mot de passe>');

ou pour MySQL 8.0 ou supérieur :

SET password FOR "<Nom de l'utilisateur de la bdd du simulateur>"@"localhost" = '<mot de passe>';
  • Donner tous les droits sur la base de données à l'utilisateur :
GRANT ALL ON <nom_bdd>.* TO "<Nom de l'utilisateur de la bdd du simulateur>"@"localhost";
  • Quitter MySQL
quit

Autre solution

Vous pouvez utiliser Phpmyadmin, interface graphique de connexion à Mysql. Mais cette solution est moins sécurisée.

Pour aller plus loin

Commandes Mysql utiles

Le Simulateur

Installation d'OpenSimulator

tar -xvzf http://opensimulator.org/dist/opensim-0.9.2.1.tar.gz

Vous pouvez supprimer l'archive compressée et renommer le dossier (par exemple opensim). Faisons l'hypothèse que vous avez téléchargé OpenSimulator dans le dossier "Téléchargements" de votre installation.

  • Depuis Nautilus, explorateur de fichier d'Ubuntu, cherchez dans votre dossier utilisateur (home/<utilisateur>) le dossier "Téléchargements" puis, supprimez le fichier opensim-<version>.tar.gz et renommez le dossier décompressé.
  • Vous pouvez faire cela en lignes de commande. Tapez lez commandes suivantes dans un terminal en remplaçant <version> par la version d'opensim installée.
cd Téléchargements
rm http://opensimulator.org/dist/opensim-0.9.2.1.tar.gz
mv opensim-<version> opensim

Configuration

Nous allons indiquer à OpenSim que nous voulons utiliser une base de données MySQL à la place se la base de données par défaut SQLite.

Éditer le fichier StandaloneCommon.ini contenu dans le dossier /bin/config-includes/ de votre installation OpenSimulator. Vous pouvez utiliser l'éditeur de texte Gedit.

En haut du fichier vous pouvez voir les deux lignes suivantes.

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


La deuxième ligne active l'utilisation du SGBD SQLite, ce que nous ne voulons plus. Ainsi, nous allons commenter cette ligne avec un point virgule. Ce qui donnera :

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

Maintenant, nous allons activer l'utilisation d'un SGBD MySQL et nous allons indiquer les paramètres de connexion à la base de données créée dans le chapitre précédent. Un peu plus bas vous pouvez voir le lignes :

; MySql
; Uncomment these lines if you want to use mysql storage
; Change the connection string to your db details
; StorageProvider = "OpenSim.Data.MySQL.dll"
; ConnectionString = "Data Source=localhost;Database=test;User ID=new;Password=newNEW;Old Guids=true;"

Nous allons décommenter les deux dernières lignes et indiquer dans la dernière les paramètres de connexion à la base de données du simulateur. Ce qui donner :

; MySql
; Uncomment these lines if you want to use mysql storage
; Change the connection string to your db details
 StorageProvider = "OpenSim.Data.MySQL.dll"
 ConnectionString = "Data Source=localhost;Database=<Nom de la bdd du simulateur>;User ID=<Nom de l'utilisateur de la bdd du simulateur>;Password=<mot de passe>;Old Guids=true;"

Enresgistrer votre fichier. Nous avons terminé la configuration d'OpenSimulator.

Lancement

Dans un terminal lancer les commandes suivantes :

cd /home/<utilisateur>/Téléchargements/opensim/bin
./opensim.sh

Des informations sur le déroulement du lancement du simulateur s'affichent dans la console. Le défilement s'arrête de temps en temps pour poser des questions auxquelles vous répondrez ainsi:(vous donnerez ces informations seulement au premier lancement du simulateur.)

Questions Réponses
New region name []: Donner un nom à votre région.
RegionUUID [27bcc083-cf9f-4116-b962-01e3255961ab]: Entrée pour définir cette valeur
Region Location [1000,1000]: Entrée
Internal IP address [0.0.0.0]: Entrée
Internal port [9000]: Entrée
Resolve hostname to IP on start (for running inside Docker) [False]: Entrée
External host name [SYSTEMIP]: Entrée
New estate name [My Estate]: Entrée
Estate owner first name [Test]: Vous pouvez donner un prénom à votre avatar ou garder Test
Estate owner last name [User]: Vous pouvez donner un nom à votre avatar ou garder User
Password: Entrez un mot de passe
Email: Entrée
User ID [1bcffbc4-590d-4905-b6e7-592febdb4b65]: Entrée

Ces informations seront enregistrées dans le fichier /bin/Regions/Regions.ini et dans la base de données du simulateur.

Le simulateur reste connecté tant que l'invite de commande Region (<nom de la région>) # est affichée dans la console du simulateur.

Pour déconnecter le simulateur tapez la commande

quit

Se connecter à la simulation (région)

Installer un navigateur 3D

Téléchargez soit Singularity soit Firestorm

Décompresser l'archive du navigateur

tar -xvzf <archive_du_navigateur_3D>.tar.gz

Se connecter avec le navigateur 3D

Ouvrir le navigateur

Ouvrez votre navigateur. En bas de la fenêtre vous voyez la barre de connexion.

Si cela n'est pas déjà fait, sélectionnez la grille de votre choix à partir du menu déroulant Grid Manager. La page d'accueil de la grille doit s'afficher.

Pour une standalone non connectée par exemple tapez dans Grid Manager :

localhost:9000

Viewer-singularity.png

Entrer vos informations de connexion

Barre connexion.png

  • Entrez le prénom de votre avatar puis un espace et enfin son nom dans le champs Username,
  • Entrez votre mot de passe dans le champs Password,
  • Dans la liste des grilles choisir par exemple Argentoratum
  • Pressez sur le bouton Log In,
  • Prêt pour une immersion dans un monde virtuel OpenSimulator !

Connexion.png

Sauvegarder une région

Archive de la région

Un OAR (OpenSim Archive Region) est un fichier qui va contenir tous les composants et les configurations d'une région. Cet OAR va pouvoir être restauré sur une autre simulation, être partagé ou archivé.

Pour faire un OAR tapez la commande suivante à l'invite de commande de votre simulation :

save oar <adresse de l'OAR sur l'ordinateur>.tar.gz

À la place de l'extension .tar.gz on peut utiliser .oar

Pour restaurer une région sauvegardée, il suffit de taper la commande suivante à l'invite de commande de votre simulation :

load oar <adresse de l'OAR sur l'ordinateur>.tar.gz

Ces commandes disposent de certaines options pour gérer les permissions, fusionner l'OAR, le déplacer ou l'orienter différemment. Pour plus d'information en anglais, tapez dans votre console :

help save oar

ou

help load oar

Sauvegarde de la base de données

Pour sauvegarder la base de données tapez la commande suivante dans un terminal (bdd_simulation correspond au <Nom de la bdd du simulateur>):

mysqldump -u root -p bdd_simulation > bdd_simulation_backup.sql

Si vous devez restaurer une base de données, tapez la commande suivante dans un terminal en remplaçant "chemin" et "bdd_simulation" comme il se doit:

mysql -u root -p bdd_simulation < /chemin/bdd_simulation.sql