Revision as of 08:46, 9 January 2008

Installer depuis les sources

MS Windows

OpenSim requiert ou bien le framework .Net framework version 2.0, ou le dernier Mono. Il supporte les compilateurs suivants:

• Microsoft Visual C# Express Edition (note: pas Visual C++)
• mono

Note pour les personnes qui viennent de telecharger les sources depuis http://dist.opensimulator.org/ (le lien "Downloads" sur la gauche) sont averties que des changements importants peuvent avoir ete oublies ( comme les scripts de gabarit MySQL ). Pour ces fonctionnalités, vous devez telecharger depuis svn!

Depot Subversion

1. Obtenir le code source 'nightly build' depuis le depot svn :

http://opensimulator.org/svn/opensim/trunk

2. Obtenir la versions stable 0.4.5.2 depuis le depot svn:

svn co http://opensimulator.org/svn/opensim/tags/0.4.5.2-stable opensim

Compiler

2. Dans le dossier principal, lancez le fichier 'runprebuild.bat'. Ceci va creer une version VS2005 et un fichier de build nant.

3. Ouvrez le fichier sln resultant avec visual studio et compilez le, ou si vous preferez utiliser nant, lancez nant dans le meme dossier. Ceci construira les executables.

Si vous n'avez pas besoin de mode physics (marcher sur les prims, etc...), ignorez le reste de cette section.

Physics

Open Dynamics Engine (ODE)

Si vous voulez integrer le mode physique base sur les collisions, OpenDynamicsEngine (ODE) est le mieux integre actuellement (9/07). Il n'est pas entierement supporté, mais il commence a fonctionner relativement bien en utilisant un petit nombre de regions par sim.

Si vous installez depuis le svn, ODE ne fonctionne pas sur toutes les plateformes. Si vous obtenez un crash relatif a ODE, ou/et un ode.dll not found (qui peut apparaitre meme si la dll est presente!), essayez d'utiliser la version debug de la dll, disponible ici :

http://www.squiggle.com/opensim/ode-debug.dll

Renommez la en ode.dll et mettez la dans .\bin, en remplacant la ode.dll. Vous pouvez aussi essayer de builder ode.dll depuis la derniere version des sources (http://www.ode.org/; verifiez que vous avez active trimesh)

Lancement

Les versions recentes de OpenSim sont fournies avec un fichier OpenSim.ini. Copiez le fichier OpenSim.ini.example vers OpenSim.ini avant de faire un changement.

Double cliquez sur le fichier executable OpenSim.exe dans le dossier bin. Ceci va demarrer OpenSim en mode individuel ( standalone ).

Le debugguer de VS2005 C# peut etre utiliser pour tracer le code. Pour ceux qui utilisent le shell Cygwin, vous devriez remarquer que une ou plusieurs dll ont les les permissions qui causent des problemees durant l'execution. La plupart des gens trouvent que faire un "chmod 777 *" depuis le dossier bin resout ce probleme.

Le mode physics peut etre invoqué en ajoutant la ligne appropriee a la section [Startup] du fichier OpenSim.ini. Pour ODE ca devrait etre :

physics = OpenDynamicsEngine

Vous pouvez aussi ajouter une option de ligne de commande a un raccourci, ou lancer depuis une ligne de commande avec :

-physics=OpenDynamicsEngine

Windows Vista

Pour tourner sous Windows Vista, vous devez d'abord desactiver le firexall de windows. Dans le menu "Demarrer" de vista, selectionnez "panneau de configuration". Ensuite double cliquez sur "pare feu windows". Dans la fenetre qui apparait, sur la colonne de gauche, selectionnez "Desactiver le pare feu". Vous devrez donner des permissions pour faire cela, ensuite selectionnez l'option "desactive ( non recommande)". Cliquez sur "OK" et sortez de cette fenetre.

Si vous avez McAfee SecurityCenter, voir la description ci dessous.

Une fois que toutes fonctionnalites de securité sont desactivées, faites un clic droit sur OpenSim.exe et eselectionnez "Executer en tant que administrateur". Ceci va faire apparaitre une fenetre demandant les droits, selectionnez "autoriser". Votre serveur OpenSim doit tourner dans une fenetre de ligne de commande ms-Dos et accepter ls connections.

McAfee Security

McAfee Security n'autorise pas les applications à ecouter les ports non specifiés. Vous avez deux options : 1) desactiver la protection du pare feu, 2) autoriser OpenSim.exe à ouvrir des ports.

Desactiver le pare feu

Ouvrez le Centre de Securite McAfee. Selectionner "Internet & Reseau". Dans le coin en bas a gauche, il y a un petit lien vers "Configuration...". Selectionnez le. Dans le cote droit de la fenetre, selectionnez la barre qui dit "La protection pare feu est activee". Ici vous pouvez selectionner "Arret".

Autoriser OpenSim.exe à ouvrir des ports

Ouvrez le Centre de Securite McAfee. Selectionner "Internet & Reseau". Dans le coin en bas a gauche, il y a un petit lien vers "Configuration...". Selectionnez le. Dans le cote droit de la fenetre, selectionnez la barre qui dit "La protection pare feu est activee". Selectionnez le bouton "Avances...". Ceci fera apparaitre une nouvelle fenetre.

Dna sla nouvelle fenetre, sur le cote gauche, selectionnez "Autorisations Programmes". Au milieu sur la droite de la fenetre, selectionnez le bouton "Ajouter un programme autorisé". Uilisez le navigateur qui apparait pour trouver l'executable de OpenSim et le selectionner.

Finalement, selectionnez "OK" et sortez de la fenetre du Centre de Securite McAfee.

Linux/Mac OS X/FreeBSD

SVP notez que la version SVN actuelle (du 2007-11-23) ne fonctionnera pas sur les systemes linux 64 bits lors de la compilation. Vous devrez utiliser la version binaire depuis cette page.Installing and running on x86-64

Depot Subversion

Pour recuperer la derniere version :

svn co http://opensimulator.org/svn/opensim/trunk opensim

Note: Le fichier libopenjpeg-libsl-...so ne marche pas vraiment. Pour cette raison, vous devriez telecharger la libsecondlife la plus recente depuis http://www.libsecondlife.org/, et compiler votre propre librairie libopenjpeg. Si vous utilisez celle ci plutot que celle du svn, votre sim devrait bien fonctionner.

Notes pour les utilisateurs de Mac OS X:

• OS X n'est pas fourni avec subversion, donc vous devrez ou bien l'installer ou bien acceder au depot a partir d'un ordinateur qui possede subversion.
• Vous devrez aussi installer Mono.
• La version de Mono pour Mac (DarwinPorts) semble etre obsolete et produit des erreurs de compilation sur le systeme. Vous devriez avoir plus de chance en installant le package le plus recent depuis http://www.mono-project.com/Downloads
• Meme avec la version la plus recente, il y a une probleme de configuration avec NAnt. Il y a un post ici : http://bleepsoft.com/tyler/index.php?itemid=82 qui explique comment corriger le script ( le post montre le chemin vers 1.1.18 -- vous aurez besoin de la remplacer avec la 1.2.5 si vous installez la derniere version depuis mono-project.com).

Compiler (Mono)

cd opensim
./runprebuild.sh
nant

Si vuos rencontrez une erreur en faisant cela, verifiez la page Troubleshooting pour de l'aide.

Physics (Unix)

Si vous voulez integrer le systeme de collisions physiques, OpenDynamicsEngine (ODE) est le plus adapte actuellement (9/07). Il n'est pas entierement supporté mais il commence a fonctionner relativement bien en utilisant un petit nombre de regions par sim.

Open Dynamics Engine (ODE)

Etant installe depuis le svn, ODE ne fonctionne pas sur toutes les plateformes. Si vous avez un crash relatif a ODE, et/si libode.so not found , vous aurez besoin de compiler libode depuis les sources.

Retirez libode.so du dossier ./bin. (Notez que des mises a jour subsequentes du svn peut la remplacer de nouveau; la meilleure reparation est de copier votre libode.so compilé vers bin). Ne retirez PAS ode.net.dll! Telechargez les derniers packages sources depuis http://www.ode.org/. En compilant verifiez que vous utilisez bien les options suivantes de configuration :

--with-trimesh=gimpact 
--enable-shared

Verifiez bien que le script de configuration confirme bien ces choix, et compile toujours avec une simple precision ( je crois qu c'est par defaut ). Essayez make -k si vous avez des erreurs relatives a drawstuff, test*, ou openGL. make install devrait mettre votre libode.so au bon endroit (habituellement dans /usr/local/lib), et il devrait etre vu par OpenSim (ode.net.dll)

Etapes d'installation pour Plateformes Unix

Etapes pour obtenir les packages qui sont necessaires pour compiler les sources.

FreeBSD 6.2

su
cd /usr/ports/devel/subversion/ && make install clean (vous aurez peut etre besoin de recompiler apr-svn si cette etape echoue)
cd /usr/ports/lang/mono/ && make install clean
cd /usr/ports/devel/nant/ && make install clean
cd /usr/ports/databases/sqlite3/ && make install clean
cd /usr/ports/x11-toolkits/libgdiplus/ && make install clean
cd /opensim/installation/directory/
svn co http://opensimulator.org/svn/opensim/trunk opensim
cd opensim
./runprebuild.sh
nant

For ODE Physics you must do the following:

cd /usr/ports/graphics/libGL/ && make install clean
cd /usr/ports/graphics/libGLU/ && make install clean
cd /opensim/installation/directory/
svn co http://opensimulator.org/svn/opensim/trunk opensim-libs
cd opensim-libs/unmanaged/OpenDynamicsEngine/
./configure --enable-shared
make
mv ./ode/src/libode.so /opensim/installation/directory/opensim/bin/

Ubuntu Server 7.10

sudo apt-get subversion
sudo apt-get mono
sudo apt-get install nant
sudo apt-get install mono-mjs libmono-microsoft8.0-cil
sudo apt-get install libmono-system-runtime2.0-cil
svn co http://opensimulator.org/svn/opensim/trunk opensim
cd opensim
./runprebuild.sh
nant

Executer (Mono)

Les versions recentes de OpenSim sont fournies avec un fichier OpenSim.ini. Copiez le fichier OpenSim.ini.example vers OpenSim.ini avant d'effectuer un changement.

cd bin
mono OpenSim.exe

pour invoquer ODE, ajoutez l'option:

-physics=OpenDynamicsEngine

ou ajoutez physics = OpenDynamicsEngine dans la section [Startup] de OpenSim.ini. Meme chose pour les autres moteurs de physique, quand disponibles.

Tutoriels externes et Demarrages rapides

10-minutes-pour-heberger-son-propre-sim

Versions Binaires

Nightly builds, au format tar-gzip:

http://ruth.petitbe.be/build/

Les packages suivants et leurs dependances sont necessaires pour lancer OpenSIm sur une installation reseau par defaut de Debian 4 :

• mono
• libmono-corlib2.0-cil
• libmono-sqlite2.0-cil
• libmono-system-web2.0-cil
• libmono-microsoft8.0-cil
• libmono-system-runtime2.0-cil