Revision as of 08:39, 6 July 2018

This page covers building OpenSimulator from source code on multiple platforms. Please help us keep this page up to date as the project progresses. If you just want to run OpenSimulator, Download and run the binary build instead. In the most cases, you should be fine with binaries.

Mac OS X 10.5 and later, Intel

and then install them - now no need to install XCode nor MacPort (you can still install mono dev libraries and nant with MacPort though).

When you run nano to build OpenSimulator, it may show an error like "Unable to locate 'mono' module using pkg-config. Download the Mono
development packages". I suspect XCode or MacPort causes something wrong (since it worked fine after I removed both), but I'm not sure. Anyway, insert a line into /usr/bin/nant script file to manage this problem :

Building from the command line (Mono 3.x)

Mac OS X 10.4/10.5 on PowerPC

OpenSimulator can run on PowerPC Macs (such as G4, G5). These instructions were tested on 10.5.8. Note that two libraries must also be built from source. Caveat: the OpenSimulator app was only briefly tested in self-contained mode. There may well be issues with this build. Feel free to note any issues you find below (or in a new wiki page? discussion?).

Unfortunately, the OpenSimulator version used here must be compiled on one version of Mono (2.6.7) and run on another (2.8.2). This means either upgrading Mono after the build, or having both versions installed and accessing the older version when you want to build. These instructions let you have both versions installed.

Install Xcode 3.1.4 Developer Tools from from http://developer.apple.com/. You must have a free Apple developer account to access the downloads. 3.1.4 was the last PowerPC Xcode.

(10.4 only) Install X11 from the Optional Install (or see if it's a Customize option when you install Xcode). 10.5 gets X11 by default (from OS X or dev tools?).

(Recommended:) In Terminal, do the one-time setup of MySQL with this command: mysql_secure_installation

In MySQL, create the opensim user per the comments in OpenSim.ini. Give it all the create privileges.

Since this is a Mac, you could use Sequel Pro (donationware) to do that in a nice GUI. Standard connection, host: 127.0.0.1 (if on the same Mac)

You're ready to run OpenSimulator. In that new Terminal window, cd to your OpenSim-source/bin folder.

mono OpenSim.exe

If all is well, you will be prompted "New region name []: "

Turn to "Running OpenSimulator for the first time" on wiki page Configuration

When fully up and running, the prompt is "Region (<region-name>) #"

Linux

Ubuntu

For Ubuntu users on older distributions (7.10, 8.04, 9.10 etc.) you need to upgrade your version of mono to at least 2.4.3 for OpenSimulator 0.7.6 and 2.10.8 for the next OpenSimulator release. We recommend updating to at least Mono 2.10.8 in any case for performance reasons. For anyone who needs to upgrade their Mono, see Update Mono on Ubuntu.

As of mono 2.6 series, xbuild works well enough to drive a complete build of OpenSimulator. Since xbuild is included within the mono-complete package on Ubuntu, you don't have to install any additional packages if you don't have any particular reason to prefer nant over xbuild. They are just two different build systems that invoke the same C# compiler based on two different build script formats.

If you do want to build using nant, then you will need to install the nant apt-get package and execute

sudo apt-get install nant
nant

instead of

xbuild

after ./runprebuild.sh

OPTIONAL (for developers): To run the regression test suite, you will also need to install nunit-console, like so

Installing NAnt

Run "yum info nant" to check the version of nant package. If you find the package, then just type:

sudo yum install nant

You can now run nant out-of-the-box.

If you can't find nant package in yum repository, or you feel its version is too early for building OpenSimulator, obtain NAnt from NAnt Project Site. See User Manual there for detailed instruction. As of 0.90, you will need to create startup script like that (given you have expanded NAnt to /usr/local/nant) :