Simulateur connecté à une grille en réseau local

Pré-requis

Système d'exploitation : ce tutoriel décrit une installation d'OpenSimulator pour Ubuntu Desktop 22.04 (Jammy Jellyfish) et Ubuntu 24.04 (Noble Numbat).
Ressources (CPU, mémoire, disque)
Dépendances
Réseau local de la grille OpenSim locale..
Ouvrir le port du simulateur au trafic TCP et UDP si nécessaire.
Avoir un compte sur la grille locale avec prénom, nom et mot de passe

Base de données MariaDB

Installer MariaDB

sudo apt update
sudo apt install mariadb-server

Créer la base de données du simulateur

sudo mysql
CREATE DATABASE <nom_bdd>;
CREATE USER '<nom_de_utilisateur>'@'localhost' IDENTIFIED BY 'Mot_de_passe';
GRANT ALL ON <nom_bdd>.* TO "<nom_utilisateur>"@"localhost";
FLUSH PRIVILEGES;

Installer OpenSimulator

Taper les commandes suivantes dans un terminal:

 cd /home/<utilisateur>/<dossier d'installation>
 wget opensim-0.9.3.0.tar.gz
 tar -xvzf opensim-0.9.3.0.tar.gz
 rm opensim-0.9.3.0.tar.gz
 mv opensim-0.9.3.0 opensim

Configurer OpenSimulator

Dans bin/OpenSim.ini

Si bin/OpenSim.ini n'existe pas

cd <dossier d'installation d'OpenSim>/bin/
cp OpenSim.ini.example OpenSim.ini

Configurer

[Const]
BaseHostname = "<IP de l'ordinateur de la grille dans le réseau local>"
PublicPort = "<port public de la grille>"
PrivatePort = "<port privé de la grille>"

[Network] 
http_listener_port = <port du simulateur>

[Architecture]
; Include-Architecture = "config-include/Standalone.ini"
; Include-Architecture = "config-include/StandaloneHypergrid.ini"
Include-Architecture = "config-include/Grid.ini"
; Include-Architecture = "config-include/GridHypergrid.ini"

Créer et modifier le fichier bin/config-includes/GridCommon.ini

 cd <chemin vers le dossier OpenSim>/bin/config-include/
 cp GridCommon.ini.example GridCommon.ini

[DatabaseService]
; SQLite
; Include-Storage = "config-include/storage/SQLiteStandalone.ini";
StorageProvider = "OpenSim.Data.MySQL.dll"
ConnectionString = "Data Source=localhost;Database=<nom_bdd>;User ID=<nom_utilisateur>;Password=<mot_de_passe>;Old Guids=true;"

Lancement

Dans un terminal lancer les commandes suivantes :

cd /home/<utilisateur>/<dossier d'installation>/opensim/bin
./opensim.sh

Répondre aux questions posées dans la console (à partir d'ici mêmes consignes pour Windows et Mac Os):

Questions	Réponses	Commentaire
New region name []:		Donner un nom à votre région.
RegionUUID [xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx]:	Touche Entrée	Touche Entrée pour utiliser la valeur proposée
Region Location [1000,1000]:	Touche Entrée	Vérifiez si la place est libre sur la carte de la grille. Pour entrer d'autres coordonnées, séparez les deux coordonnées par une virgule.
Internal IP address [0.0.0.0]:	Touche Entrée
Internal port [9000]:	Touche Entrée	Ou un port de votre choix. Toutefois, ce port doit correspondre à celui de la configuration. Ouvrir le port au trafic UDP si nécessaire
Resolve hostname to IP on start (for running inside Docker) [False]:	Touche Entrée
External host name [SYSTEMIP]:	<IP de l'ordinateur du simulateur dans le réseau local>	IP du type 169.254.xxx.xxx
New estate name [My Estate]:	Touche Entrée
Estate owner first name [Test]:	<prenom>	Prénom d'un compte de la grille. Impossible de connecter le simulateur si vous n'avez pas de compte sur la grille.
Estate owner last name [User]:	<nom>	Nom d'un compte de la grille. Le propriétaire utilisera ce compte pour se connecter à la grille dans le viewer.

Le simulateur demeure connecté tant que l'invite de commande Region (<nom de la région>) # s'affiche dans la console du simulateur.
Pour fermer le simulateur taper dans la console :

quit

Se connecter à la simulation

Le viewer

Téléchargez le viewer pour OpenSimulator et votre système d'exploitation ici.
Installer et configurer un viewer sur chaque ordinateur du réseau local qui devra accéder à la simulation.

Configurer le viewer

Aller dans Viewer/Préférences/ menu Opensim
Entrer l'adresse de la grille de connexion du simulateur sous "Ajouter une nouvelle Grille" puis cliquer sur Ajouter et OK.
Le nom de la grille de connexion du simulateur doit apparaître dans la liste des grilles du viewer.

Se connecter

Renseigner prénom, nom et mot de passe. Le prénom et le nom sont séparés par un espcace.
Sélectionner le "<nom de la grille>" dans la liste des grilles.
Cliquer sur Connexion

Sauvegarder une région

Taper la commande suivante dans la console du simulateur pour créer une archive (OAR):

 save oar <adresse_de_l_OAR_sur_l_ordinateur>/<nom_du_fichier>.tar.gz

Pour restaurer l'archive taper :

load oar <adresse_de_l_OAR_sur_l_ordinateur>/<nom_du_fichier>.tar.gz

Pour plus d'information sur ces commandes taper help ou help load oar ou help save oar.