OpenSimulator - User contributions [en]

Build Instructions

2007-09-12T18:54:21Z

Click170: "check the Troubleshooting..." >> "the slightly outdated Troubleshooting..."

=Installing from source=

==MS Windows==

OpenSim requires either the .Net framework version 2.0, or the latest Mono. It also is compiled with the C# and not the C++ IDE for those who are using the no-cost Express Editions from MS.

=== Subversion Repository ===

1. Get the source code from the svn repository:

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

=== Building ===

2. In the top-level directory, run the '<tt>runprebuild.bat</tt>' file. This will create both a VS2005 solution file, and a nant build file.

3. Open the resulting sln file with visual studio, and build it there, or if you prefer to use nant, run nant in the same top-level directory. This will build the executables.

If you don't care about physics (walking on prims, etc), ignore the rest of this section.

==== Physics ====

===== Open Dynamics Engine (ODE) =====

If you want to implement collision-based physics, OpenDynamicsEngine (ODE) is the furthest along at the moment (9/07). It is not fully supported, but is starting to work somewhat reliably using a small number of regions per sim.

As installed from svn, ODE does not work on all platforms. If you get an ODE-related crash, and/or an ode.dll not found type of error (which can occur even though the dll is present!), try using the debug version of the dll, available here:

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

Rename it <tt>ode.dll</tt> and put it in <tt>.\bin</tt>, replacing the stock <tt>ode.dll</tt>. You can also try building <tt>ode.dll</tt> from the latest version of the source (http://www.ode.org/; make sure to enable trimesh)

=== Running ===

Double-click on the <tt>OpenSim.exe</tt> executable file in the <tt>bin</tt> directory. This will start up OpenSim in standalone mode.

The debugger in VS2005 C# may be used to step through the code. For those that use a Cygwin shell, you may find that one or more dll's have permissions that cause problems running. Most find that a "<tt>chmod 777 *</tt>" from the <tt>bin</tt> directory solves this.

Physics can be invoked by adding the appropriate line to the [Startup] section of <tt>OpenSim.ini</tt>. For ODE, that would be:

physics = OpenDynamicsEngine

You can also add a command line option to a shortcut, or run from a command prompt with:

-physics=OpenDynamicsEngine

==Linux/Mac OS X==

=== Subversion Repository ===

To check out the latest revision:

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

Note: The <tt>libopenjpeg-libsl-...so</tt> is not really working. For this reason you should download the newest libsecondlife from http://www.libsecondlife.org/, and build your own libopenjpeg library. If you use this instead of the SVN version, your sim will work fine.

Notes to Mac OS X users:

* OS X does not come packaged with subversion, so you will need to either install it or access the repository from a computer that does have subversion.
* You'll also need to install Mono.
* The version of Mono in MacPorts (formerly DarwinPorts) seems to be out of date and produced compilation errors on my system. You may have better luck installing the newest package from http://www.mono-project.com/Downloads
* Even with the newer version, there's a config problem with NAnt. There's a blog post here: http://bleepsoft.com/tyler/index.php?itemid=82 which explains how to fix the script (the blog post shows the path for 1.1.18 -- you'll need to replace this with 1.2.5 if you install the latest version from mono-project.com).

=== Building (Mono) ===

cd opensim
./runprebuild.sh
nant

If you encounter any errors while trying this, check the slightly outdated [[Troubleshooting]] page for help.

==== Physics (Unix) ====

If you want to implement collision-based physics, OpenDynamicsEngine (ODE) is the furthest along at the moment (9/07). It is not fully supported, but is starting to work somewhat reliably using a small number of regions per sim.

===== Open Dynamics Engine (ODE) =====

As installed from svn, ODE does not work on all platforms. If you get an ODE-related crash, and/or a libode.so not found type of error, you will need to build libode from source.

Remove <tt>libode.so</tt> from the <tt>./bin</tt> folder. (Note that subsequent svn updates may replace it again; best fix is to copy your built <tt>libode.so</tt> to <tt>bin</tt>). Do NOT remove <tt>ode.net.dll</tt>! Download the latest source packages from http://www.ode.org/. When compiling, make sure to use the following configure options:

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

Make sure the configure script confirms these choices, and always compile with single precision (I believe that's the default). Try <code> make -k </code> if you get errors relating to drawstuff, test*, or openGL. <code> make install </code> should put <tt>libode.so</tt> in the proper place (usually <tt>/usr/local/lib</tt>), and it should be seen by opensim (<tt>ode.net.dll</tt>)

=== Running (Mono) ===

cd bin
mono OpenSim.exe

to invoke ODE, add the option:
-physics=OpenDynamicsEngine

or add <code> physics = OpenDynamicsEngine </code> to the [Startup] section of <tt>OpenSim.ini</tt>. Same deal for other physics engines, when available.

=Binary releases=

Nightly builds, in tar-gzip format:

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

Troubleshooting

2007-09-12T18:42:08Z

Click170: Specified when/where some errors appear

This is the beginnings of a troubleshooting page. This advice is towards troubleshooting compiling OpenSIM on a Linux Debian system, these commands and error messages are from and in relation to this OS only.

Starting with a base Debian 4.0r0 system, and I will go through each of the steps to install Opensim intentionally incorrectly executing each item. The first thing is to cd into your favorite directory and SVN the latest source.

Before we begin, we need to prep the system. Your sources file ['''/etc/apt/sources.list'''] must include 'unstable' entries, and you should '''apt-get dist-upgrade''' your system after doing so to catch your system up to date with all the new files. In my experience, if you do not use 'unstable' then the packages are not up to date enough, and you run into version issues, which lead to the two error messages seen below which appear at the very end of the process when you run OpenSim.exe;

'''Failed generating terrain map: System.TypeInitializationException: An exception was thrown by the type initializer for System.Drawing.GDIPlus ---> System.DllNotFoundException: gdiplus.dll
at (wrapper managed-to-native) System.Drawing.GDIPlus:GdiplusStartup (ulong&,System.Drawing.GdiplusStartupInput&,System.Drawing.GdiplusStartupOutput&)
at System.Drawing.GDIPlus..cctor () [0x00000] --- End of inner exception stack trace ---

at <0x00000> <unknown method>
at System.Drawing.Bitmap..ctor (System.String filename, Boolean useIcm) [0x00000]
at System.Drawing.Bitmap..ctor (System.String filename) [0x00000]
at (wrapper remoting-invoke-with-check) System.Drawing.Bitmap:.ctor (string)
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]
adding asset 845d07f0-2146-4708-964f-56311f0185c7
'''

And

'''Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded (OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]
adding asset e8df7745-d263-49b0-ab46-7055e71a5094'''

And then we begin.

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

'''-bash: svn: command not found'''

Ok this ones a gimme. If you don't know why your getting this message, just go home, there is no hope for you.
This message clearly means you do not have Subversion installed. To rectify this:

'''# apt-get install subversion'''

Now that you have subversion, run the command again to get yourself a copy of the source.
'''

The next step says to cd into your opensim.new/trunk directory wherever you put it, and run the following:

'''# mono bin/Prebuild.exe /target nant'''

If you see:

'''-bash: mono: command not found'''

Again, this one is a gimme. This means you do not have mono installed. Mono does not come installed on the base system and must be retrieved via apt:

'''# apt-get install mono'''

'''Spoiler!!''': If you '''apt-get install mono nant mono-gmcs mono-mjs libmono-microsoft8.0-cil libmono-system-runtime2.0-cil''' Then you won't encounter the errors described below on this page, and can cruise through the mono, and nant build process without incident.

Now that we have mono we can try running that nifty mono command again:
'''# mono bin/Prebuild.exe /target nant'''

If you see:

'''The assembly mscorlib.dll was not found or could not be loaded.'''

'''It should have been installed in the `/usr/lib/mono/['''1.0/2.0''']/mscorlib.dll' directory.'''

This indicates that you are missing one of the mscor libs that comes with nant. This is easily solved by getting '''nant''' which comes with both versions 1.0 and 2.0 of the required lib.

'''# apt-get install nant'''

Fixes this. Rerun the mono command. At this stage we have successfully created a NAnt build file. (Yay!) The next step is '''# nant -buildfile:OpenSim.build'''

Which very likely will fail if you've been following these steps, with the following error:

[nant] /usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Framework/Console/bin/Release
[csc] Compiling 4 files to '/usr/src/opensim.new/trunk/OpenSim/Framework/Console/bin/Release/OpenSim.Framework.Console.dll'.
[csc] Cannot open assembly /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe.

BUILD FAILED - 0 non-fatal error(s), 1 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 2)

Total time: 0.2 seconds.

BUILD FAILED

This is quickly fixed by retrieving '''mono-gmcs'''.

'''# apt-get install mono-gmcs'''

The next error that I come across is this one:

''' [nant] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release
[mkdir] Creating directory '/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release'.
[csc] Compiling 28 files to '/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release/OpenSim.Region.Terrain.BasicTerrain.dll'.
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,17): error CS0234: The type or namespace name `JScript' does not exist in the namespace `Microsoft'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,1): error CS0246: The type or namespace name `Microsoft.JScript' could not be found. Are you missing a using directive or an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,17): error CS0234: The type or namespace name `JScript' does not exist in the namespace `Microsoft'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,1): error CS0246: The type or namespace name `Microsoft.JScript' could not be found. Are you missing a using directive or an assembly reference?
[csc] Compilation failed: 4 error(s), 0 warnings

BUILD FAILED - 0 non-fatal error(s), 4 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 1)

Total time: 0.9 seconds.

BUILD FAILED'''

Note that it says Jscript over and over again. Hint perhaps?

'''# apt-get install mono-mjs libmono-microsoft8.0-cil'''

The next error encountered is:

'''[nant] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release
[mkdir] Creating directory '/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release'.
[csc] Compiling 6 files to '/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release/OpenSim.Region.Communications.OGS1.dll'.
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs(7,40): error CS0234: The type or namespace name `Tcp' does not exist in the namespace `System.Runtime.Remoting.Channels'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs(7,1): error CS0246: The type or namespace name `Channels.Tcp' could not be found. Are you missing a using directive or an assembly reference?
[csc] Compilation failed: 2 error(s), 0 warnings

BUILD FAILED - 0 non-fatal error(s), 2 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 1)

Total time: 0.7 seconds.

BUILD FAILED'''

This one is taken care of with a quick

'''# apt-get install libmono-system-runtime2.0-cil'''

After this final install, re-running the specified nant command should build successfully. <<BUILD SUCCEEDED>>
Build time is only 24~ seconds on a 2Ghz Intel Core 2 Duo Macbook with 2GB Ram, you can approximate for your own systems.

Using the mono "Linux Installer for x86 (All distributions)" stable installer on a base Debian system.
If you start with a base Debian system as we did at the top of the page, but instead of using the apt version of mono you would rather use the up-to-date installer from their website, then these are some of the issues you may encounter.

After getting the .bin file from http://www.mono-project.com/Downloads, and executing it as per it's instructions, upon finishing, you may find that if you try to run `mono --version` you are presented with this friendly message:

'''mono: error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file: No such file or directory'''

This one means you need to install '''libglib2.0-0'''.

'''# apt-get install libglib2.0-0'''

If you retry your `mono --version` you should see the following, perhaps with a more recent version number.

'''
# mono --version
Mono JIT compiler version 1.2.5 (tarball)
Copyright (C) 2002-2007 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm (with typed GC)
SIGSEGV: normal
Architecture: x86
Disabled: none
'''

At this stage, trying to run the mono command will work, but trying to run NAnt will not.

'''
BUILD FAILED

The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file.
Unable to locate 'mono' module using pkg-config. Download the Mono development packages from http://www.mono-project.com/downloads/.

For more information regarding the cause of the build failure, run the build again in debug mode.

Try 'nant -help' for more information
'''

This one seems to be fixed by retrieving the apt version of nant.

'''# apt-get install nant'''

It should now build without incident.

If you run your Opensim.exe (with mono, duh) and you get a funky error message, like the two seen at the very top of this page, then you need to upgrade your system to 'unstable' and repeat the entire process.

Information will be added here as it is encountered.

Troubleshooting

2007-09-11T04:43:50Z

Click170: Added additional info on DllNotFound openjpeg.dll and gdiplus.dll

This is the beginnings of a troubleshooting page. This advice is towards troubleshooting compiling OpenSIM on a Linux Debian system, these commands and error messages are from and in relation to this OS only.

Starting with a base Debian 4.0r0 system, and I will go through each of the steps to install Opensim intentionally incorrectly executing each item. The first thing is to cd into your favorite directory and SVN the latest source.

Before we begin, we need to prep the system. Your sources file ['''/etc/apt/sources.list'''] must include 'unstable' entries, and you should '''apt-get dist-upgrade''' your system after doing so to catch your system up to date with all the new files. In my experience, if you do not use 'unstable' then the packages are not up to date enough, and you run into version issues, which lead to the two error messages seen below;

'''Failed generating terrain map: System.TypeInitializationException: An exception was thrown by the type initializer for System.Drawing.GDIPlus ---> System.DllNotFoundException: gdiplus.dll
at (wrapper managed-to-native) System.Drawing.GDIPlus:GdiplusStartup (ulong&,System.Drawing.GdiplusStartupInput&,System.Drawing.GdiplusStartupOutput&)
at System.Drawing.GDIPlus..cctor () [0x00000] --- End of inner exception stack trace ---

at <0x00000> <unknown method>
at System.Drawing.Bitmap..ctor (System.String filename, Boolean useIcm) [0x00000]
at System.Drawing.Bitmap..ctor (System.String filename) [0x00000]
at (wrapper remoting-invoke-with-check) System.Drawing.Bitmap:.ctor (string)
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]
adding asset 845d07f0-2146-4708-964f-56311f0185c7
'''

And

'''Failed generating terrain map: System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so
at (wrapper managed-to-native) OpenJPEGNet.OpenJPEG:LibslAllocDecoded (OpenJPEGNet.OpenJPEG/LibslImage&)
at OpenJPEGNet.OpenJPEG.Encode (System.Byte[] decoded, Int32 width, Int32 height, Int32 components, Boolean lossless) [0x00000]
at OpenJPEGNet.OpenJPEG.EncodeFromImage (System.Drawing.Bitmap bitmap, Boolean lossless) [0x00000]
at OpenSim.Region.Terrain.TerrainEngine.ExportJpegImage (System.String gradientmap) [0x00000]
adding asset e8df7745-d263-49b0-ab46-7055e71a5094'''

And then we begin.

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

'''-bash: svn: command not found'''

Ok this ones a gimme. If you don't know why your getting this message, just go home, there is no hope for you.
This message clearly means you do not have Subversion installed. To rectify this:

'''# apt-get install subversion'''

Now that you have subversion, run the command again to get yourself a copy of the source.
'''

The next step says to cd into your opensim.new/trunk directory wherever you put it, and run the following:

'''# mono bin/Prebuild.exe /target nant'''

If you see:

'''-bash: mono: command not found'''

Again, this one is a gimme. This means you do not have mono installed. Mono does not come installed on the base system and must be retrieved via apt:

'''# apt-get install mono'''

'''Spoiler!!''': If you '''apt-get install mono nant mono-gmcs mono-mjs libmono-microsoft8.0-cil libmono-system-runtime2.0-cil''' Then you won't encounter the errors described below on this page, and can cruise through the mono, and nant build process without incident.

Now that we have mono we can try running that nifty mono command again:
'''# mono bin/Prebuild.exe /target nant'''

If you see:

'''The assembly mscorlib.dll was not found or could not be loaded.'''

'''It should have been installed in the `/usr/lib/mono/['''1.0/2.0''']/mscorlib.dll' directory.'''

This indicates that you are missing one of the mscor libs that comes with nant. This is easily solved by getting '''nant''' which comes with both versions 1.0 and 2.0 of the required lib.

'''# apt-get install nant'''

Fixes this. Rerun the mono command. At this stage we have successfully created a NAnt build file. (Yay!) The next step is '''# nant -buildfile:OpenSim.build'''

Which very likely will fail if you've been following these steps, with the following error:

[nant] /usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Framework/Console/bin/Release
[csc] Compiling 4 files to '/usr/src/opensim.new/trunk/OpenSim/Framework/Console/bin/Release/OpenSim.Framework.Console.dll'.
[csc] Cannot open assembly /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe.

BUILD FAILED - 0 non-fatal error(s), 1 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 2)

Total time: 0.2 seconds.

BUILD FAILED

This is quickly fixed by retrieving '''mono-gmcs'''.

'''# apt-get install mono-gmcs'''

The next error that I come across is this one:

''' [nant] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release
[mkdir] Creating directory '/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release'.
[csc] Compiling 28 files to '/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release/OpenSim.Region.Terrain.BasicTerrain.dll'.
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,17): error CS0234: The type or namespace name `JScript' does not exist in the namespace `Microsoft'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,1): error CS0246: The type or namespace name `Microsoft.JScript' could not be found. Are you missing a using directive or an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,17): error CS0234: The type or namespace name `JScript' does not exist in the namespace `Microsoft'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,1): error CS0246: The type or namespace name `Microsoft.JScript' could not be found. Are you missing a using directive or an assembly reference?
[csc] Compilation failed: 4 error(s), 0 warnings

BUILD FAILED - 0 non-fatal error(s), 4 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 1)

Total time: 0.9 seconds.

BUILD FAILED'''

Note that it says Jscript over and over again. Hint perhaps?

'''# apt-get install mono-mjs libmono-microsoft8.0-cil'''

The next error encountered is:

'''[nant] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release
[mkdir] Creating directory '/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release'.
[csc] Compiling 6 files to '/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release/OpenSim.Region.Communications.OGS1.dll'.
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs(7,40): error CS0234: The type or namespace name `Tcp' does not exist in the namespace `System.Runtime.Remoting.Channels'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs(7,1): error CS0246: The type or namespace name `Channels.Tcp' could not be found. Are you missing a using directive or an assembly reference?
[csc] Compilation failed: 2 error(s), 0 warnings

BUILD FAILED - 0 non-fatal error(s), 2 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 1)

Total time: 0.7 seconds.

BUILD FAILED'''

This one is taken care of with a quick

'''# apt-get install libmono-system-runtime2.0-cil'''

After this final install, re-running the specified nant command should build successfully. <<BUILD SUCCEEDED>>
Build time is only 24~ seconds on a 2Ghz Intel Core 2 Duo Macbook with 2GB Ram, you can approximate for your own systems.

Using the mono "Linux Installer for x86 (All distributions)" stable installer on a base Debian system.
If you start with a base Debian system as we did at the top of the page, but instead of using the apt version of mono you would rather use the up-to-date installer from their website, then these are some of the issues you may encounter.

After getting the .bin file from http://www.mono-project.com/Downloads, and executing it as per it's instructions, upon finishing, you may find that if you try to run `mono --version` you are presented with this friendly message:

'''mono: error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file: No such file or directory'''

This one means you need to install '''libglib2.0-0'''.

'''# apt-get install libglib2.0-0'''

If you retry your `mono --version` you should see the following, perhaps with a more recent version number.

'''
# mono --version
Mono JIT compiler version 1.2.5 (tarball)
Copyright (C) 2002-2007 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm (with typed GC)
SIGSEGV: normal
Architecture: x86
Disabled: none
'''

At this stage, trying to run the mono command will work, but trying to run NAnt will not.

'''
BUILD FAILED

The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file.
Unable to locate 'mono' module using pkg-config. Download the Mono development packages from http://www.mono-project.com/downloads/.

For more information regarding the cause of the build failure, run the build again in debug mode.

Try 'nant -help' for more information
'''

This one seems to be fixed by retrieving the apt version of nant.

'''# apt-get install nant'''

It should now build without incident.

If you run your Opensim.exe (with mono, duh) and you get a funky error message, like the two seen at the very top of this page, then you need to upgrade your system to 'unstable' and repeat the entire process.

Information will be added here as it is encountered.

Troubleshooting

2007-09-11T04:27:30Z

Click170: updated svn command to match the install page of this wiki

This is the beginnings of a troubleshooting page. This advice is towards troubleshooting compiling OpenSIM on a Linux Debian system, these commands and error messages are from and in relation to this OS only.

Starting with a base Debian 4.0r0 system, and I will go through each of the steps to install Opensim intentionally incorrectly executing each item. The first thing is to cd into your favorite directory and SVN the latest source.

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

'''-bash: svn: command not found'''

Ok this ones a gimme. If you don't know why your getting this message, just go home, there is no hope for you.
This message clearly means you do not have Subversion installed. To rectify this:

'''# apt-get install subversion'''

Now that you have subversion, run the command again to get yourself a copy of the source.
'''

The next step says to cd into your opensim.new/trunk directory wherever you put it, and run the following:

'''# mono bin/Prebuild.exe /target nant'''

If you see:

'''-bash: mono: command not found'''

Again, this one is a gimme. This means you do not have mono installed. Mono does not come installed on the base system and must be retrieved via apt:

'''# apt-get install mono'''

'''Spoiler!!''': If you '''apt-get install mono nant mono-gmcs mono-mjs libmono-microsoft8.0-cil libmono-system-runtime2.0-cil''' Then you won't encounter the errors described below on this page, and can cruise through the mono, and nant build process without incident.

Now that we have mono we can try running that nifty mono command again:
'''# mono bin/Prebuild.exe /target nant'''

If you see:

'''The assembly mscorlib.dll was not found or could not be loaded.'''

'''It should have been installed in the `/usr/lib/mono/['''1.0/2.0''']/mscorlib.dll' directory.'''

This indicates that you are missing one of the mscor libs that comes with nant. This is easily solved by getting '''nant''' which comes with both versions 1.0 and 2.0 of the required lib.

'''# apt-get install nant'''

Fixes this. Rerun the mono command. At this stage we have successfully created a NAnt build file. (Yay!) The next step is '''# nant -buildfile:OpenSim.build'''

Which very likely will fail if you've been following these steps, with the following error:

[nant] /usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Framework/Console/bin/Release
[csc] Compiling 4 files to '/usr/src/opensim.new/trunk/OpenSim/Framework/Console/bin/Release/OpenSim.Framework.Console.dll'.
[csc] Cannot open assembly /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe.

BUILD FAILED - 0 non-fatal error(s), 1 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Framework/Console/OpenSim.Framework.Console.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 2)

Total time: 0.2 seconds.

BUILD FAILED

This is quickly fixed by retrieving '''mono-gmcs'''.

'''# apt-get install mono-gmcs'''

The next error that I come across is this one:

''' [nant] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release
[mkdir] Creating directory '/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release'.
[csc] Compiling 28 files to '/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/bin/Release/OpenSim.Region.Terrain.BasicTerrain.dll'.
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,17): error CS0234: The type or namespace name `JScript' does not exist in the namespace `Microsoft'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,1): error CS0246: The type or namespace name `Microsoft.JScript' could not be found. Are you missing a using directive or an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,17): error CS0234: The type or namespace name `JScript' does not exist in the namespace `Microsoft'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/TerrainFilter.cs(33,1): error CS0246: The type or namespace name `Microsoft.JScript' could not be found. Are you missing a using directive or an assembly reference?
[csc] Compilation failed: 4 error(s), 0 warnings

BUILD FAILED - 0 non-fatal error(s), 4 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Region/Terrain.BasicTerrain/OpenSim.Region.Terrain.BasicTerrain.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 1)

Total time: 0.9 seconds.

BUILD FAILED'''

Note that it says Jscript over and over again. Hint perhaps?

'''# apt-get install mono-mjs libmono-microsoft8.0-cil'''

The next error encountered is:

'''[nant] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build build
Buildfile: file:///usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build
Target framework: Mono 2.0 Profile
Target(s) specified: build

build:

[echo] Build Directory is /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release
[mkdir] Creating directory '/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release'.
[csc] Compiling 6 files to '/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/bin/Release/OpenSim.Region.Communications.OGS1.dll'.
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs(7,40): error CS0234: The type or namespace name `Tcp' does not exist in the namespace `System.Runtime.Remoting.Channels'. Are you missing an assembly reference?
[csc] /usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OGS1GridServices.cs(7,1): error CS0246: The type or namespace name `Channels.Tcp' could not be found. Are you missing a using directive or an assembly reference?
[csc] Compilation failed: 2 error(s), 0 warnings

BUILD FAILED - 0 non-fatal error(s), 2 warning(s)

/usr/src/opensim.new/trunk/OpenSim/Region/Communications/OGS1/OpenSim.Region.Communications.OGS1.dll.build(10,10):
External Program Failed: /usr/lib/pkgconfig/../../lib/mono/2.0/gmcs.exe (return code was 1)

Total time: 0.7 seconds.

BUILD FAILED'''

This one is taken care of with a quick

'''# apt-get install libmono-system-runtime2.0-cil'''

After this final install, re-running the specified nant command should build successfully. <<BUILD SUCCEEDED>>
Build time is only 24~ seconds on a 2Ghz Intel Core 2 Duo Macbook with 2GB Ram, you can approximate for your own systems.

Using the mono "Linux Installer for x86 (All distributions)" stable installer on a base Debian system.
If you start with a base Debian system as we did at the top of the page, but instead of using the apt version of mono you would rather use the up-to-date installer from their website, then these are some of the issues you may encounter.

After getting the .bin file from http://www.mono-project.com/Downloads, and executing it as per it's instructions, upon finishing, you may find that if you try to run `mono --version` you are presented with this friendly message:

'''mono: error while loading shared libraries: libgthread-2.0.so.0: cannot open shared object file: No such file or directory'''

This one means you need to install '''libglib2.0-0'''.

'''# apt-get install libglib2.0-0'''

If you retry your `mono --version` you should see the following, perhaps with a more recent version number.

'''
# mono --version
Mono JIT compiler version 1.2.5 (tarball)
Copyright (C) 2002-2007 Novell, Inc and Contributors. www.mono-project.com
TLS: __thread
GC: Included Boehm (with typed GC)
SIGSEGV: normal
Architecture: x86
Disabled: none
'''

At this stage, trying to run the mono command will work, but trying to run NAnt will not.

'''
BUILD FAILED

The current runtime framework 'mono-2.0' is not correctly configured in the NAnt configuration file.
Unable to locate 'mono' module using pkg-config. Download the Mono development packages from http://www.mono-project.com/downloads/.

For more information regarding the cause of the build failure, run the build again in debug mode.

Try 'nant -help' for more information
'''

This one seems to be fixed by retrieving the apt version of nant.

'''# apt-get install nant'''

It should now build without incident.

Information will be added here as it is encountered.