Overview


To deploy the Universal Campus infrastructure in your system, you need to first configure and install the OpenSim server and then a Client Viewer.

The OpenSim server environment requires the following to be installed:


Install Mono


It is highly recommended that you install the most recent binary version of Mono (2.10 or higher) through your operating system's software manager. If this is not possible then you may try to compile from source by first deciding where you want to install Mono, and set the environment variable for it:

export MONODIR="/directory/for/mono/install"

Then execute the following commands:

cd $MONODIR
mkdir mono; mkdir mono/mono-libgdiplus
wget http://ftp.novell.com/pub/mono/sources-stable/mono-2.10.tar.bz2
tar -jxvf mono-2.10.tar.bz2
cd mono-2.8
./configure --prefix=$MONODIR/mono; make; make install

Install Mono libgdiplus 2.6.7


If you have installed Mono from source proceed with the following, otherwise check with your operating system's software manager to install the libgdiplus package:

wget http://ftp.novell.com/pub/mono/sources/libgdiplus/libgdiplus-2.6.7.tar.bz2
tar -jxvf libgdiplus-2.6.7.tar.bz2
cd libgdiplus-2.6.7 export LDFLAGS="-Wl,-Bsymbolic"
export CFLAGS="-fPIC"
./configure --prefix=$MONODIR/mono/mono-libgdiplus; make; make install
export LD_LIBRARY_PATH=$MONODIR/mono/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=$MONODIR/mono/mono-libgdiplus/lib:$LD_LIBRARY_PATH
export PATH=$MONODIR/mono/bin:$PATH

Install MySQL


Install MySQL through your system's package manager, or by source. After you have a working MySQL instance convert all tables to MyISAM. Lastly make sure to obtain the following:


Install Diva


First decide where you want to install your OpenSim (Diva), and set the environment variable for it:

export OPENSIMDIR="/directory/for/opensim/install"

Then execute the following commands:

mkdir $OPENSIMDIR/opensim
cd $OPENSIMDIR/opensim

Then download the latest Diva Distro, extract it, and run the configuration:

wget http://cloud.github.com/downloads/diva/d2/diva-rxxx.zip
unzip diva-rxxxx.zip
cd diva-rxxxx/bin
mono Configure.exe

Open a file called startup_opensim.sh and paste in the following commands:

export PATH=$MONOPATH/mono/bin:$PATH
export LD_LIBRARY_PATH=$MONOPATH/mono/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=$MONOPATH/mono/mono-libgdiplus/lib:$LD_LIBRARY_PATH
cd $OPENSIMDIR/opensim/diva-r13981/bin
mono OpenSim.exe

Now run the actual service under a screen session:

screen
chmod u+x startup_opensim.sh
./startup_opensim.sh

Install FreeSwitch


FreeSwitch is an optional feature for voice conferencing. First decide where you want to install FreeSwitch, and set the environment variable for it:

export FREESWITCH="/directory/for/freeswitch/install"

Then execute the following commands:

mkdir $FREESWITCH/freeswitch
mkdir $FREESWITCH/freeswitch/src
cd $FREESWITCH/freeswitch/src

Then download the latest version of FreeSwitch, extract it, and run the configure/install:

wget http://files.freeswitch.org/freeswitch-1.0.6.tar.gz
tar -zxvf freeswitch-1.0.6.tar.gz
cd freeswitch-1.0.6
./configure --prefix=$FREESWITCH/freeswitch; make; make all install sounds-install moh-install
cd $FREESWITCH/freeswitch/bin
./freeswitch

Configure FreeSwitch


Follow the Freeswitch Module instructions very carefully.

If you run into some trouble, here are some good troubleshooting tips:


Starting Up OpenSim


Once everything is installed and running smoothly, you need to load the virtual world and avatar files:

The IAR will be loaded automatically. There are 4 OARs which need to be loaded manually. They correspond to the space like this:

2 4
1 3

Number 1 is the oar that has all the objects. The other 3 only have the terrain for 2, 3 and 4.
Number 1 will take the longest to load, about 30-40 minutes.

First issue this command:

# show regions

This will show you the 4 region names and their coordinates.

Load them in this order:

# load oar universal_campus_01_04182011.oar

(this will take some time, you should see many messages relating to data being written to the database)

When that is finished loading, you can load the rest:

# change region "North_East_Region_Name"
# load oar universal_campus_04_04182011.oar

# change region "South_East_Region_Name"
# load oar universal_campus_03_04182011.oar

# change region "North_West_Region_Name"
# load oar universal_campus_02_04182011.oar

OpenSim Permissions/Logo


Once you have OpenSim up and running, follow the Client Setup.
After you have succesfully logged in, you will have to restrict permissions:

Now change the default logo in your virtual world to your own custom logo by reading How to change the logo.