Dependencies

From OpenSimulator

Revision as of 21:55, 8 May 2011 by Makopoppo (Talk | contribs)

Jump to: navigation, search

In addition to the OpenSim code itself, certain other packages need to be installed on different platforms in order to get OpenSim binaries to run.

As well as the information on this page (which should be expanded), you may find more information on dependencies in Build Instructions though this will also contain dependencies required only for building. This are also more hints in Troubleshooting

Locales and Regional Settings

OpenSimulator will only work properly when you run it with an English locale or regional setting. With other settings than English, you are likely to see a variety of issues, ranging from misbehaving scripts to crashes.

Linux

In Linux, you can easily use the standard "C" locale just for running OpenSim.exe, as explained in Troubleshooting#ScriptEngine Issues:

env LANG=C mono OpenSim.exe

For information about changing your locale in a more general way, see Troubleshooting#Locales Issues

Windows

If you are not using an English regional setting in Windows by default, then there is not a solution as easy as for Linux, unfortunately. I did it with an additional user account that I created just for OpenSim in which I set the regional setting to "English (US)". I run OpenSim.exe from my normal user account with "Run as..." (or check "Run with different credentials" in a shortcut's advanced properties) and specify the OpenSim account as the one to be used.


Windows

When using OpenSim on Windows XP ensure it is updated to at least Service Pack 2 (SP2).

When using OpenSim on Windows XP, VISTA, Win-7, Server 2003 & 2008, You need to have the newest version of the .NET Framework 3.5 sp1 (3.51), available from Microsoft Download Centre: www.microsoft.com/downloads/details.aspx [[|]]

32-Bit Operating System:  Start/Run OpenSim.exe

64-Bit Operating System:  Start/Run OpenSim.32BitLaunch.exe

Depending on your installation, you may have to run the program as administrator. (right click run as a administrator)

NOTE:  Windows Versions prior to XP such as NT, 2000 are not supported.  NET Framework 4.0 not officially supported by OpenSim yet.


Linux

OpenSimulator requires Mono 2.4.3 or later.


Ubuntu

sudo apt-get install nant mono-gmcs libmono-microsoft8.0-cil \
     libmono-system-runtime2.0-cil libgdiplus libmono-i18n2.0-cil libmono-oracle2.0-cil

Nant is required if you need to build OpenSim.


CentOS

This procedure is tested on CentOS 5.5 & 5.6 box with OpenSim 0.7.1.

First, note that the current version you can get from default yum repository is 1.2.4, which is way older than the requirement of OpenSimulator (2.4.3). Unlike Ubuntu, CentOS should be always conservative, therefore it is natural that they don't so often update their repository. What you can do to manage this problem is to add an extra repository for mono.

Go to yum config file folder and create new one for mono.

cd /etc/yum.repos.d
sudo vi mono.repo

And then in mono.repo :

[mono]
name = novell-mono
baseurl=http://ftp.novell.com/pub/mono/download-stable/RHEL_5/
enabled=1
gpgcheck=0

Now, you can yum install the later version of mono from this repository. Additional note that make sure all of mono packages are i386(not IA64 build). If your box is 32bit, don't care and you can even install properly without ".i386" suffix.

sudo yum install mono-addon-core.i386 mono-addon-data.i386 mono-addon-data-sqlite.i386  \
      mono-addon-extras.i386 mono-addon-web.i386 mono-addon-winforms.i386 mono-addon-libgdiplus0.i386

Yum will install mono into /opt/novell/mono, so you can create a symbolic link to /usr/bin :

sudo ln -s /opt/novell/mono/bin/mono /usr/bin/mono

After that, you should be able to launch OpenSim.exe without any errors.

Additional Resources

OSGrid Technical Support Forum with many installation tutorials:  osgrid.org/forums/viewforum.php

MONO Project:  www.mono-project.com/Main_Page

Personal tools
General
About This Wiki