opensim/BUILDING.md

2.5 KiB

git clone

get or update source from git

git clone git://opensimulator.org/git/opensim

Building on Windows

Requirements

To building under Windows, the following is required:

optionally also

Building

To create the project files, run

runprebuild.bat

run compile.bat

Or load the generated OpenSim.sln into Visual Studio and build the solution.

Configure, see below

Now just run OpenSim.exe from the bin folder, and set up the region.

Building on Linux / Mac

Requirements

if you have mono 6.x complete, you already have libgdiplus, otherwise you need to install it using a package manager for your operating system, like apt, brew, macports, etc for example on debian:

apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

Building

To create the project files, run:

./runprebuild.sh

then run

dotnet build --configuration Release OpenSim.sln

Configure. See below

run ./opensim.sh from the bin folder, and set up the region

Configure

Standalone mode

Copy OpenSim.ini.example to OpenSim.ini in the bin/ directory, and verify the [Const] section, correcting for your case.

On [Architecture] section uncomment only the line with Standalone.ini if you do now want HG, or the line with StandaloneHypergrid.ini if you do

copy the StandaloneCommon.ini.example to StandaloneCommon.ini in the bin/config-include directory.

The StandaloneCommon.ini file describes the database and backend services that OpenSim will use, and is set to use sqlite by default, which requires no setup.

Grid mode

Each grid may have its own requirements, so FOLLOW your Grid instructions! in general: Copy OpenSim.ini.example to OpenSim.ini in the bin/ directory, and verify the [Const] section, correcting for your case

On [Architecture] section uncomment only the line with Grid.ini if you do now want HG, or the line with GridHypergrid.ini if you do

and copy the GridCommon.ini.example file to GridCommon.ini inside the bin/config-include directory and edit as necessary

References