Troubleshooting

From OpenSimulator

Revision as of 13:41, 10 September 2007 by Chi11ken (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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 svn://opensecondlife.org/opensim/trunk opensim.new/trunk

-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.

  1. 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.

Retrieved from "http://opensimulator.org/index.php?title=Troubleshooting&oldid=857"
Personal tools
General
About This Wiki