Latest revision as of 23:26, 14 May 2024

Languages:

English    Deutsch    Français    日本語

[edit] Note

Ces instructions supposent que vous voulez exécuter OpenSimulator en mode standalone à partir des paquets binaires. Si ce n'est pas le cas ou si vous avez des exigences plus complexes (par exemple vous préférez utiliser la base de données MySQL plutôt que SQLite ou vous voulez lancer OpenSimulator en mode grille), alors , vous devez d'abord configurer OpenSimulator.

[edit] Dépendances

En plus du code OpenSimulator lui-même, certains autres paquets doivent être installés sur les différentes plates-formes afin de permettre l'exécution d'OpenSimulator.

Outre les informations sur cette page (qui devraient être développées), vous pouvez trouver plus d'informations sur les dépendances dans Build_Instructions/fr, bien que cette page contienne également des informations sur les dépendances requises uniquement pour la compilation des sources. Vous trouverez d'autres conseils en anglais à la page Troubleshooting.

Après avoir installé les dépendances, vous devrez peut-être configurer le pare-feu installé sur votre système de manière à ce que les viewers extérieurs puissent accéder à OpenSimulator sur votre machine. Voir Firewall Settings pour plus d'informations.

NAT Loopback Routers Informations sur le routeur et le Nat Loopback qui vous aideront à configurer votre routeur/modem.

[edit] Version 0.9.3.0 et supérieure

Dépendances :

• runtime dotnet8 ou le runtime Desktop pour votre plateforme (ainsi que le SDK si vous souhaitez compiler)
• Sous Windows:
  • vous devrez peut-être installer les fichiers d'exécution pour vc++.
  • vous devrez peut-être autoriser l'installation de l'ancien .NetFramework 3.5
• Sous linux, vous aurez besoin de libgdiplus.
  • si vous avez mono-complete 6.x installé, vous avez déjà libgdiplus,
  • sinon vous devez l'installer, par exemple sur debian :

sudo apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev  

[edit] Versions antérieures

[edit] Windows

La version actuelle d'OpenSimulator nécessite .NET Framework 4.6.
Vous devrez peut-être aussi installer les fichiers runtime pour vc++.

Double-cliquez ou exécutez à l'invite de commandes :

• OpenSim.exe

Sur les machines 64bit, vous pouvez exécuter les petites régions en mode 32bit, double-cliquez ou exécutez sur l'invite de commande :

• OpenSim32.exe.

Selon votre installation, vous devrez exécuter le programme en tant qu'administrateur (clic droit -> 'Exécuter en tant qu'administrateur'). Cela affichera une fenêtre pour vous demander l'autorisation, sélectionnez "Autoriser".

[edit] GNU/Linux et Mac OSX

Le code de développement d'OpenSimulator nécessite Mono 5.12 ou plus.

Pour lancer OpenSimulator avec mono, exécutez dans le dossier ../bin

./opensim.sh

Vous pouvez modifier ce script shell si vous le souhaitez, pour changer les paramètres régionaux (voir ci-dessous) ou d'autres paramètres comme la taille de la pile pour les moteurs physiques basés sur ODE.

Sur Mac Os avec mono5.x vous pouvez exécuter OpenSimulator en mode 32bit en changeant la ligne d'exécution mono de ce script en :

mono --desktop --arch=32 OpenSim.exe

[edit] Installation de Mono

Vous pouvez installer mono à partir de la page de téléchargement officielle de Mono. Si votre système n'est pas supporté, vous devrez obtenir ses sources et compiler sur celui-ci.

[edit] Docker

À des fins de test, vous pouvez même exécuter OpenSimulator dans un conteneur Docker. Le moyen le plus rapide est d'utiliser official mono image comme image de base. Pour éviter les questions posées à la première installation, vous devez préparer une série de fichiers ini et les déployer dans le conteneur. Par exemple, si vous exécutez le binaire 0.9.0.0-rc1 en mode standalone sur Mono 4.6.2.16:

FROM mono:4.6.2.16

RUN curl http://dist.opensimulator.org/opensim-0.9.0.0-rc1.tar.gz -s | tar xzf -
COPY Regions.ini /opensim-0.9.0.0-rc1/bin/Regions/Regions.ini
COPY OpenSim.ini /opensim-0.9.0.0-rc1/bin/OpenSim.ini
EXPOSE 9000
WORKDIR /opensim-0.9.0.0-rc1/bin

CMD [ "mono",  "./OpenSim.exe" ]

Dans la plupart des cas, vous devez définir "ExternalHostName" dans Regions.ini. Cette valeur devrait être un nom d'hôte valide accessible de l'extérieur de la machine Docker. En général, ce sera "localhost" ou le nom d'hôte de la machine Docker dans laquelle se trouve le conteneur.

Ensuite compilez les sources et lancez ainsi. Notez que vous devrez rediriger le port TCP/UDP.

$ docker build -t opensim .
$ docker run --name=opensim -p 9000:9000 -p 9000:9000/udp -d opensim
or
$ docker run --name=opensim -it -p 9000:9000 -p 9000:9000/udp opensim

Vous trouverez un exemple complet du projet Dockerfile à l'adresse makopo/docker-opensimulator-sample.

[edit] Paramètres locaux et régionaux

OpenSimulator fonctionne correctement seulement si vous le lancez avec un paramètre local ou régional anglais. Avec les autres paramètres, vous pouvez rencontrer certains problèmes, allant de l'erreur de script au crash.

[edit] GNU/Linux

Dans GNU/Linux, vous pouvez utiliser facilement le paramètre standard local "C" seulement pour lancer OpenSim.exe, comme expliqué dans Troubleshooting#ScriptEngine Issues:

env LANG=C mono OpenSim.exe

Pour plus d'informations sur la modification plus générale de votre paramètre local, voir Troubleshooting#Locales Issues

[edit] Windows

Si vous n'utilisez pas par défaut de paramètre régional anglais dans Windows, il n'existe pas de solution aussi simple que pour GNU/Linux, malheureusement. Je l'ai fait avec un compte utilisateur supplémentaire que j'ai créé juste pour OpenSimulator dans lequel j'ai configuré le paramètre régional à "Anglais (US)". Je lance OpenSim.exe à partir de mon compte d'utilisateur normal avec "Exécuter comme ..." (ou cochez "Exécuter avec différentes informations d'identification" dans les propriétés avancées d'un raccourci) et spécifiez le compte OpenSimulator comme étant celui à utiliser.

[edit] Ressources supplémentaires

Forum de support technique d'OSGrid avec de nombreux tutoriels sur l'installation :  osgrid.org/forums/viewforum.php

Projet MONO www.mono-project.com/Main_Page